Validate that the argument is an instance of the specified class; otherwise + * throwing an exception. This method is useful when validating according to an arbitrary + * class
+ * + *Validate.isInstanceOf(OkClass.class, object);+ * + *
The message of the exception is "The validated object is not an instance of" + * followed by the name of the class
+ * + * @param type the class the object must be validated against + * @param o the object to check + * @throws IllegalArgumentException if argument is not of specified class + * @see #isInstanceOf(Class, Object, String, Object...) + */ + public static void isInstanceOf(Class type, Object o) + { + if (type.isInstance(o) == false) + { + throw new IllegalArgumentException(String.format(DEFAULT_IS_INSTANCE_OF_EX_MESSAGE, type.getName())); + } + } + + /** + *Validate that the argument is an instance of the specified class; otherwise + * throwing an exception with the specified message. This method is useful when + * validating according to an arbitrary class
+ * + *Validate.isInstanceOf(OkClass.classs, object, "Wrong class, object is of class %s", object.getClass().getName());+ * + * @param type the class the object must be validated against + * @param o the object to check + * @param message exception message + * @param values optional value for the exception message + * @throws IllegalArgumentException if argument is not of specified class + * @see #isInstanceOf(Class, Object) + */ + public static void isInstanceOf(Class type, Object o, String message, Object... values) + { + if (type.isInstance(o) == false) + { + throw new IllegalArgumentException(String.format(message, values)); + } + } + + /** + *
Validate that the argument can be converted to the specified class; otherwise + * throwing an exception with the specified message. This method is useful when + * validating if there will be no casting errors.
+ * + *Validate.isAssignableFrom(SuperClass.class, object.getClass());+ * + *
The message of the exception is "The validated object can not be converted to the" + * followed by the name of the class and "class"
+ * + * @param superType the class the class must be validated against + * @param type the class to check + * @throws IllegalArgumentException if argument can not be converted to the specified class + * @see #isAssignableFrom(Class, Class, String, Object...) + */ + public static void isAssignableFrom(Class superType, Class type) + { + if (superType.isAssignableFrom(type) == false) + { + throw new IllegalArgumentException(String.format(DEFAULT_IS_ASSIGNABLE_EX_MESSAGE, superType.getName())); + } + } + + /** + *Validate that the argument can be converted to the specified class; otherwise + * throwing an exception. This method is useful when validating if there will be no + * casting errors.
+ * + *Validate.isAssignableFrom(SuperClass.class, object.getClass());+ * + *
The message of the exception is "The validated object can not be converted to the" + * followed by the name of the class and "class"
+ * + * @param superType the class the class must be validated against + * @param type the class to check + * @param message the exception message if invalid + * @param values the optional values for the formatted exception message + * @throws IllegalArgumentException if argument can not be converted to the specified class + * @see #isAssignableFrom(Class, Class) + */ + public static void isAssignableFrom(Class superType, Class type, String message, Object... values) + { + if (superType.isAssignableFrom(type) == false) + { + throw new IllegalArgumentException(String.format(message, values)); + } + } } diff --git a/src/test/java/org/apache/commons/lang3/ValidateTest.java b/src/test/java/org/apache/commons/lang3/ValidateTest.java index 647bc4630..ba7c68c07 100644 --- a/src/test/java/org/apache/commons/lang3/ValidateTest.java +++ b/src/test/java/org/apache/commons/lang3/ValidateTest.java @@ -20,6 +20,7 @@ package org.apache.commons.lang3; import java.lang.reflect.Constructor; import java.lang.reflect.Modifier; +import java.util.AbstractList; import java.util.ArrayList; import java.util.Arrays; import java.util.Collection; @@ -846,4 +847,49 @@ public class ValidateTest extends TestCase { assertEquals("Error", e.getMessage()); } } + + public void testIsInstanceOf() { + Validate.isInstanceOf(String.class, "hi"); + Validate.isInstanceOf(Integer.class, 1); + try { + Validate.isInstanceOf(List.class, "hi"); + fail("Expecting IllegalArgumentException"); + } catch(IllegalArgumentException e) { + assertEquals("The validated object is not an instance of java.util.List", e.getMessage()); + } + } + + public void testIsInstanceOf_withMessage() { + Validate.isInstanceOf(String.class, "hi", "Error"); + Validate.isInstanceOf(Integer.class, 1, "Error"); + try { + Validate.isInstanceOf(List.class, "hi", "Error"); + fail("Expecting IllegalArgumentException"); + } catch(IllegalArgumentException e) { + assertEquals("Error", e.getMessage()); + } + } + + public void testIsAssignable() { + Validate.isAssignableFrom(CharSequence.class, String.class); + Validate.isAssignableFrom(AbstractList.class, ArrayList.class); + try { + Validate.isAssignableFrom(List.class, String.class); + fail("Expecting IllegalArgumentException"); + } catch(IllegalArgumentException e) { + assertEquals("The validated class can not be converted to the java.util.List class", e.getMessage()); + } + } + + public void testIsAssignable_withMessage() { + Validate.isAssignableFrom(CharSequence.class, String.class, "Error"); + Validate.isAssignableFrom(AbstractList.class, ArrayList.class, "Error"); + try { + Validate.isAssignableFrom(List.class, String.class, "Error"); + fail("Expecting IllegalArgumentException"); + } catch(IllegalArgumentException e) { + assertEquals("Error", e.getMessage()); + } + } + }