From 4af0d359b4fb4b8b6ce95e2a0d4bbc07f2fa7aea Mon Sep 17 00:00:00 2001 From: Henri Yandell Date: Mon, 20 Jul 2009 23:41:01 +0000 Subject: [PATCH] Moving IllegalClassException to backcompat git-svn-id: https://svn.apache.org/repos/asf/commons/proper/lang/trunk@796067 13f79535-47bb-0310-9956-ffa450edef68 --- .../commons/lang/IllegalClassException.java | 103 ------------------ 1 file changed, 103 deletions(-) delete mode 100644 src/java/org/apache/commons/lang/IllegalClassException.java diff --git a/src/java/org/apache/commons/lang/IllegalClassException.java b/src/java/org/apache/commons/lang/IllegalClassException.java deleted file mode 100644 index f947f6472..000000000 --- a/src/java/org/apache/commons/lang/IllegalClassException.java +++ /dev/null @@ -1,103 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ -package org.apache.commons.lang; - -/** - *

Thrown when an object is an instance of an unexpected type (a class or interface). - * This exception supplements the standard IllegalArgumentException - * by providing a more semantically rich description of the problem.

- * - *

IllegalClassException represents the case where a method takes - * in a genericly typed parameter like Object (typically because it has to due to some - * other interface it implements), but this implementation only actually accepts a specific - * type, for example String. This exception would be used in place of - * IllegalArgumentException, yet it still extends it.

- * - *
- * public void foo(Object obj) {
- *   if (obj instanceof String == false) {
- *     throw new IllegalClassException(String.class, obj);
- *   }
- *   // do something with the string
- * }
- * 
- * - * @author Matthew Hawthorne - * @author Gary Gregory - * @author Stephen Colebourne - * @since 2.0 - * @version $Id$ - */ -public class IllegalClassException extends IllegalArgumentException { - - /** - * Required for serialization support. - * - * @see java.io.Serializable - */ - private static final long serialVersionUID = 8063272569377254819L; - - /** - *

Instantiates with the expected type, and actual object.

- * - * @param expected the expected type - * @param actual the actual object - * @since 2.1 - */ - public IllegalClassException(Class expected, Object actual) { - super( - "Expected: " - + safeGetClassName(expected) - + ", actual: " - + (actual == null ? "null" : actual.getClass().getName())); - } - - /** - *

Instantiates with the expected and actual types.

- * - * @param expected the expected type - * @param actual the actual type - */ - public IllegalClassException(Class expected, Class actual) { - super( - "Expected: " - + safeGetClassName(expected) - + ", actual: " - + safeGetClassName(actual)); - } - - /** - *

Instantiates with the specified message.

- * - * @param message the exception message - */ - public IllegalClassException(String message) { - super(message); - } - - /** - *

Returns the class name or null if the class is - * null.

- * - * @param cls a Class - * @return the name of cls, or null if if cls is null. - */ - private static final String safeGetClassName(Class cls) { - return cls == null ? null : cls.getName(); - } - -}