Class ClassUtils


  • public class ClassUtils
    extends java.lang.Object
    Operates on classes without using reflection.

    This class handles invalid null inputs as best it can. Each method documents its behavior in more detail.

    The notion of a canonical name includes the human-readable name for the type, for example int[]. The non-canonical method variants work with the JVM names, such as [I.

    Since:
    2.0
    • Constructor Summary

      Constructors 
      Constructor Description
      ClassUtils()
      Deprecated.
      TODO Make private in 4.0.
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.util.Comparator<java.lang.Class<?>> comparator()
      Gets the class comparator, comparing by class name.
      static java.util.List<java.lang.String> convertClassesToClassNames​(java.util.List<java.lang.Class<?>> classes)
      Given a List of Class objects, this method converts them into class names.
      static java.util.List<java.lang.Class<?>> convertClassNamesToClasses​(java.util.List<java.lang.String> classNames)
      Given a List of class names, this method converts them into classes.
      static java.lang.String getAbbreviatedName​(java.lang.Class<?> cls, int lengthHint)
      Gets the abbreviated name of a Class.
      static java.lang.String getAbbreviatedName​(java.lang.String className, int lengthHint)
      Gets the abbreviated class name from a String.
      static java.util.List<java.lang.Class<?>> getAllInterfaces​(java.lang.Class<?> cls)
      Gets a List of all interfaces implemented by the given class and its superclasses.
      static java.util.List<java.lang.Class<?>> getAllSuperclasses​(java.lang.Class<?> cls)
      Gets a List of superclasses for the given class.
      static java.lang.String getCanonicalName​(java.lang.Class<?> cls)
      Gets the canonical class name for a Class.
      static java.lang.String getCanonicalName​(java.lang.Class<?> cls, java.lang.String valueIfNull)
      Gets the canonical name for a Class.
      static java.lang.String getCanonicalName​(java.lang.Object object)
      Gets the canonical name for an Object.
      static java.lang.String getCanonicalName​(java.lang.Object object, java.lang.String valueIfNull)
      Gets the canonical name for an Object.
      static java.lang.Class<?> getClass​(java.lang.ClassLoader classLoader, java.lang.String className)
      Gets the (initialized) class represented by className using the classLoader.
      static java.lang.Class<?> getClass​(java.lang.ClassLoader classLoader, java.lang.String className, boolean initialize)
      Gets the class represented by className using the classLoader.
      static java.lang.Class<?> getClass​(java.lang.String className)
      Gets the (initialized) class represented by className using the current thread's context class loader.
      static java.lang.Class<?> getClass​(java.lang.String className, boolean initialize)
      Gets the class represented by className using the current thread's context class loader.
      static java.lang.Class<?> getClassStrict​(java.lang.ClassLoader classLoader, java.lang.String className, boolean initialize)
      Gets the class represented by className using the classLoader, without normalizing the class name.
      static java.lang.Class<?> getClassStrict​(java.lang.String className)
      Gets the (initialized) class represented by className using the current thread's context class loader, without normalizing the class name.
      static <T> java.lang.Class<T> getComponentType​(java.lang.Class<T[]> cls)
      Gets the array component type using Class.getComponentType() with generics.
      static java.lang.String getName​(java.lang.Class<?> cls)
      Gets the class name, handling null safely.
      static java.lang.String getName​(java.lang.Class<?> cls, java.lang.String valueIfNull)
      Gets the class name, handling null safely.
      static java.lang.String getName​(java.lang.Object object)
      Gets the object's class name, handling null safely.
      static java.lang.String getName​(java.lang.Object object, java.lang.String valueIfNull)
      Gets the object's class name, handling null safely.
      static java.lang.String getPackageCanonicalName​(java.lang.Class<?> cls)
      Gets the package name from the canonical name of a Class.
      static java.lang.String getPackageCanonicalName​(java.lang.Object object, java.lang.String valueIfNull)
      Gets the package name from the class name of an Object.
      static java.lang.String getPackageCanonicalName​(java.lang.String name)
      Gets the package name from the class name.
      static java.lang.String getPackageName​(java.lang.Class<?> cls)
      Gets the package name of a Class.
      static java.lang.String getPackageName​(java.lang.Object object, java.lang.String valueIfNull)
      Gets the package name of an Object.
      static java.lang.String getPackageName​(java.lang.String className)
      Gets the package name from a String.
      static java.lang.reflect.Method getPublicMethod​(java.lang.Class<?> cls, java.lang.String methodName, java.lang.Class<?>... parameterTypes)
      Gets the desired Method much like Class.getMethod, however it ensures that the returned Method is from a public class or interface and not from an anonymous inner class.
      static java.lang.String getShortCanonicalName​(java.lang.Class<?> cls)
      Gets the canonical name minus the package name from a Class.
      static java.lang.String getShortCanonicalName​(java.lang.Object object, java.lang.String valueIfNull)
      Gets the canonical name minus the package name for an Object.
      static java.lang.String getShortCanonicalName​(java.lang.String canonicalName)
      Gets the canonical name minus the package name from a String.
      static java.lang.String getShortClassName​(java.lang.Class<?> cls)
      Gets the class name minus the package name from a Class.
      static java.lang.String getShortClassName​(java.lang.Object object, java.lang.String valueIfNull)
      Gets the class name of the object without the package name or names.
      static java.lang.String getShortClassName​(java.lang.String className)
      Gets the class name minus the package name from a String.
      static java.lang.String getSimpleName​(java.lang.Class<?> cls)
      Gets the simple class name, handling null safely.
      static java.lang.String getSimpleName​(java.lang.Class<?> cls, java.lang.String valueIfNull)
      Gets the simple class name, handling null safely.
      static java.lang.String getSimpleName​(java.lang.Object object)
      Gets the object's simple class name, handling null safely.
      static java.lang.String getSimpleName​(java.lang.Object object, java.lang.String valueIfNull)
      Gets the object's simple class name, handling null safely.
      static java.lang.Iterable<java.lang.Class<?>> hierarchy​(java.lang.Class<?> type)
      Gets an Iterable that can iterate over a class hierarchy in ascending (subclass to superclass) order, excluding interfaces.
      static java.lang.Iterable<java.lang.Class<?>> hierarchy​(java.lang.Class<?> type, ClassUtils.Interfaces interfacesBehavior)
      Gets an Iterable that can iterate over a class hierarchy in ascending (subclass to superclass) order.
      static boolean isAssignable​(java.lang.Class<?>[] classArray, java.lang.Class<?>... toClassArray)
      Tests whether an array of Classes can be assigned to another array of Classes.
      static boolean isAssignable​(java.lang.Class<?>[] classArray, java.lang.Class<?>[] toClassArray, boolean autoboxing)
      Tests whether an array of Classes can be assigned to another array of Classes.
      static boolean isAssignable​(java.lang.Class<?> cls, java.lang.Class<?> toClass)
      Tests whether one Class can be assigned to a variable of another Class.
      static boolean isAssignable​(java.lang.Class<?> cls, java.lang.Class<?> toClass, boolean autoboxing)
      Tests whether one Class can be assigned to a variable of another Class.
      static boolean isInnerClass​(java.lang.Class<?> cls)
      Tests whether the specified class an inner class or static nested class.
      static boolean isPrimitiveOrWrapper​(java.lang.Class<?> type)
      Tests whether the given type is a primitive or primitive wrapper (Boolean, Byte, Character, Short, Integer, Long, Double, Float).
      static boolean isPrimitiveWrapper​(java.lang.Class<?> type)
      Tests whether the given type is a primitive wrapper (Boolean, Byte, Character, Short, Integer, Long, Double, Float).
      static boolean isPublic​(java.lang.Class<?> cls)
      Tests whether a Class is public.
      static java.lang.Class<?>[] primitivesToWrappers​(java.lang.Class<?>... classes)
      Converts the specified array of primitive Class objects to an array of its corresponding wrapper Class objects.
      static java.lang.Class<?> primitiveToWrapper​(java.lang.Class<?> cls)
      Converts the specified primitive Class object to its corresponding wrapper Class object.
      static java.lang.Class<?>[] toClass​(java.lang.Object... array)
      Converts an array of Object in to an array of Class objects.
      static java.lang.Class<?>[] wrappersToPrimitives​(java.lang.Class<?>... classes)
      Converts the specified array of wrapper Class objects to an array of its corresponding primitive Class objects.
      static java.lang.Class<?> wrapperToPrimitive​(java.lang.Class<?> cls)
      Converts the specified wrapper class to its corresponding primitive class.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • PACKAGE_SEPARATOR_CHAR

        public static final char PACKAGE_SEPARATOR_CHAR
        The package separator character: '&#x2e;' == {@value}.
        See Also:
        Constant Field Values
      • PACKAGE_SEPARATOR

        public static final java.lang.String PACKAGE_SEPARATOR
        The package separator String: "&#x2e;".
      • INNER_CLASS_SEPARATOR_CHAR

        public static final char INNER_CLASS_SEPARATOR_CHAR
        The inner class separator character: '$' == {@value}.
        See Also:
        Constant Field Values
      • INNER_CLASS_SEPARATOR

        public static final java.lang.String INNER_CLASS_SEPARATOR
        The inner class separator String: "$".
    • Constructor Detail

      • ClassUtils

        @Deprecated
        public ClassUtils()
        Deprecated.
        TODO Make private in 4.0.
        ClassUtils instances should NOT be constructed in standard programming. Instead, the class should be used as ClassUtils.getShortClassName(cls).

        This constructor is public to permit tools that require a JavaBean instance to operate.

    • Method Detail

      • comparator

        public static java.util.Comparator<java.lang.Class<?>> comparator()
        Gets the class comparator, comparing by class name.
        Returns:
        The class comparator.
        Since:
        3.13.0
      • convertClassesToClassNames

        public static java.util.List<java.lang.String> convertClassesToClassNames​(java.util.List<java.lang.Class<?>> classes)
        Given a List of Class objects, this method converts them into class names.

        A new List is returned. null objects will be copied into the returned list as null.

        Parameters:
        classes - The classes to change.
        Returns:
        A List of class names corresponding to the Class objects, null if null input.
        Throws:
        java.lang.ClassCastException - Thrown if classes contains a non-Class entry.
      • convertClassNamesToClasses

        public static java.util.List<java.lang.Class<?>> convertClassNamesToClasses​(java.util.List<java.lang.String> classNames)
        Given a List of class names, this method converts them into classes.

        A new List is returned. If the class name cannot be found, null is stored in the List. If the class name in the List is null, null is stored in the output List.

        Parameters:
        classNames - The classNames to change.
        Returns:
        A List of Class objects corresponding to the class names, null if null input.
        Throws:
        java.lang.ClassCastException - Thrown if classNames contains a non String entry.
      • getAbbreviatedName

        public static java.lang.String getAbbreviatedName​(java.lang.Class<?> cls,
                                                          int lengthHint)
        Gets the abbreviated name of a Class.
        Parameters:
        cls - The class to get the abbreviated name for, may be null.
        lengthHint - The desired length of the abbreviated name.
        Returns:
        The abbreviated name or an empty string.
        Throws:
        java.lang.IllegalArgumentException - Thrown if len <= 0.
        Since:
        3.4
        See Also:
        getAbbreviatedName(String, int)
      • getAbbreviatedName

        public static java.lang.String getAbbreviatedName​(java.lang.String className,
                                                          int lengthHint)
        Gets the abbreviated class name from a String.

        The string passed in is assumed to be a class name - it is not checked.

        The abbreviation algorithm will shorten the class name, usually without significant loss of meaning.

        The abbreviated class name will always include the complete package hierarchy. If enough space is available, rightmost sub-packages will be displayed in full length. The abbreviated package names will be shortened to a single character.

        Only package names are shortened, the class simple name remains untouched. (See examples.)

        The result will be longer than the desired length only if all the package names shortened to a single character plus the class simple name with the separating dots together are longer than the desired length. In other words, when the class name cannot be shortened to the desired length.

        If the class name can be shortened then the final length will be at most lengthHint characters.

        If the lengthHint is zero or negative then the method throws exception. If you want to achieve the shortest possible version then use 1 as a lengthHint.

        Examples
        className len return
        null 1 ""
        "java.lang.String" 5 "j.l.String"
        "java.lang.String" 15 "j.lang.String"
        "java.lang.String" 30 "java.lang.String"
        "org.apache.commons.lang3.ClassUtils" 18 "o.a.c.l.ClassUtils"
        Parameters:
        className - The className to get the abbreviated name for, may be null.
        lengthHint - The desired length of the abbreviated name.
        Returns:
        The abbreviated name or an empty string if the specified class name is null or empty string. The abbreviated name may be longer than the desired length if it cannot be abbreviated to the desired length.
        Throws:
        java.lang.IllegalArgumentException - Thrown if len <= 0.
        Since:
        3.4
      • getAllInterfaces

        public static java.util.List<java.lang.Class<?>> getAllInterfaces​(java.lang.Class<?> cls)
        Gets a List of all interfaces implemented by the given class and its superclasses.

        The order is determined by looking through each interface in turn as declared in the source file and following its hierarchy up. Then each superclass is considered in the same way. Later duplicates are ignored, so the order is maintained.

        Parameters:
        cls - The class to look up, may be null.
        Returns:
        The List of interfaces in order, null if null input.
      • getAllSuperclasses

        public static java.util.List<java.lang.Class<?>> getAllSuperclasses​(java.lang.Class<?> cls)
        Gets a List of superclasses for the given class.
        1. The first entry is the superclass of the given class.
        2. The last entry is Object's class.
        Parameters:
        cls - The class to look up, may be null.
        Returns:
        The List of superclasses in order going up from this one null if null input.
      • getCanonicalName

        public static java.lang.String getCanonicalName​(java.lang.Class<?> cls)
        Gets the canonical class name for a Class.
        Parameters:
        cls - The class for which to get the canonical class name; may be null.
        Returns:
        The canonical name of the class, or the empty String.
        Since:
        3.7
        See Also:
        Class.getCanonicalName()
      • getCanonicalName

        public static java.lang.String getCanonicalName​(java.lang.Class<?> cls,
                                                        java.lang.String valueIfNull)
        Gets the canonical name for a Class.
        Parameters:
        cls - The class for which to get the canonical class name; may be null.
        valueIfNull - The return value if null.
        Returns:
        The canonical name of the class, or valueIfNull.
        Since:
        3.7
        See Also:
        Class.getCanonicalName()
      • getCanonicalName

        public static java.lang.String getCanonicalName​(java.lang.Object object)
        Gets the canonical name for an Object.
        Parameters:
        object - The object for which to get the canonical class name; may be null.
        Returns:
        The canonical name of the object, or the empty String.
        Since:
        3.7
        See Also:
        Class.getCanonicalName()
      • getCanonicalName

        public static java.lang.String getCanonicalName​(java.lang.Object object,
                                                        java.lang.String valueIfNull)
        Gets the canonical name for an Object.
        Parameters:
        object - The object for which to get the canonical class name; may be null.
        valueIfNull - The return value if null.
        Returns:
        The canonical name of the object or valueIfNull.
        Since:
        3.7
        See Also:
        Class.getCanonicalName()
      • getClass

        public static java.lang.Class<?> getClass​(java.lang.ClassLoader classLoader,
                                                  java.lang.String className)
                                           throws java.lang.ClassNotFoundException
        Gets the (initialized) class represented by className using the classLoader. This implementation supports the syntaxes "java.util.Map.Entry[]", "java.util.Map$Entry[]", "[Ljava.util.Map.Entry;", and "[Ljava.util.Map$Entry;".

        The provided class name is normalized by removing all whitespace. This is especially helpful when handling XML element values in which whitespace has not been collapsed.

        Security note: because all whitespace is deleted before the class is resolved (and a failing '.' may be retried as '$' for inner classes), many distinct input strings resolve to the same class, while Class.forName(String) performs no such normalization. Validating an untrusted class name by string comparison before calling this method is therefore unsound: for example, " java.lang.Runtime" fails a naive startsWith("java.") denylist check on the raw string, yet loads java.lang.Runtime. Validate the class name after normalization, validate the resolved Class object itself, or use getClassStrict(ClassLoader, String, boolean) which performs no whitespace normalization.

        Parameters:
        classLoader - The class loader to use to load the class.
        className - The class name.
        Returns:
        The class represented by className using the classLoader.
        Throws:
        java.lang.NullPointerException - Thrown if the className is null.
        java.lang.ClassNotFoundException - Thrown if the class is not found.
        java.lang.IllegalArgumentException - Thrown if the class name represents an array with more dimensions than the JVM supports, 255.
        java.lang.IllegalArgumentException - Thrown if the class name length is greater than 65,535.
        See Also:
        Class.forName(String, boolean, ClassLoader), JVM: Array dimension limits in JVM Specification CONSTANT_Class_info, JLS: Fully Qualified Names and Canonical Names, JLS: The Form of a Binary
      • getClass

        public static java.lang.Class<?> getClass​(java.lang.ClassLoader classLoader,
                                                  java.lang.String className,
                                                  boolean initialize)
                                           throws java.lang.ClassNotFoundException
        Gets the class represented by className using the classLoader. This implementation supports the syntaxes "java.util.Map.Entry[]", "java.util.Map$Entry[]", "[Ljava.util.Map.Entry;", and "[Ljava.util.Map$Entry;".

        The provided class name is normalized by removing all whitespace. This is especially helpful when handling XML element values in which whitespace has not been collapsed.

        Security note: because all whitespace is deleted before the class is resolved (and a failing '.' may be retried as '$' for inner classes), many distinct input strings resolve to the same class, while Class.forName(String) performs no such normalization. Validating an untrusted class name by string comparison before calling this method is therefore unsound: for example, " java.lang.Runtime" fails a naive startsWith("java.") denylist check on the raw string, yet loads java.lang.Runtime. Validate the class name after normalization, validate the resolved Class object itself, or use getClassStrict(ClassLoader, String, boolean) which performs no whitespace normalization.

        Parameters:
        classLoader - The class loader to use to load the class.
        className - The class name.
        initialize - whether the class must be initialized.
        Returns:
        The class represented by className using the classLoader.
        Throws:
        java.lang.NullPointerException - Thrown if the className is null.
        java.lang.ClassNotFoundException - Thrown if the class is not found.
        java.lang.IllegalArgumentException - Thrown if the class name represents an array with more dimensions than the JVM supports, 255.
        java.lang.IllegalArgumentException - Thrown if the class name length is greater than 65,535.
        See Also:
        Class.forName(String, boolean, ClassLoader), JVM: Array dimension limits in JVM Specification CONSTANT_Class_info, JLS: Fully Qualified Names and Canonical Names, JLS: The Form of a Binary
      • getClass

        public static java.lang.Class<?> getClass​(java.lang.String className)
                                           throws java.lang.ClassNotFoundException
        Gets the (initialized) class represented by className using the current thread's context class loader. This implementation supports the syntaxes "java.util.Map.Entry[]", "java.util.Map$Entry[]", "[Ljava.util.Map.Entry;", and "[Ljava.util.Map$Entry;".

        The provided class name is normalized by removing all whitespace. This is especially helpful when handling XML element values in which whitespace has not been collapsed.

        Security note: because all whitespace is deleted before the class is resolved (and a failing '.' may be retried as '$' for inner classes), many distinct input strings resolve to the same class, while Class.forName(String) performs no such normalization. Validating an untrusted class name by string comparison before calling this method is therefore unsound: for example, " java.lang.Runtime" fails a naive startsWith("java.") denylist check on the raw string, yet loads java.lang.Runtime. Validate the class name after normalization, validate the resolved Class object itself, or use getClassStrict(ClassLoader, String, boolean) which performs no whitespace normalization.

        Parameters:
        className - The class name
        Returns:
        The class represented by className using the current thread's context class loader
        Throws:
        java.lang.NullPointerException - Thrown if the className is null.
        java.lang.ClassNotFoundException - Thrown if the class is not found.
        java.lang.IllegalArgumentException - Thrown if the class name represents an array with more dimensions than the JVM supports, 255.
        java.lang.IllegalArgumentException - Thrown if the class name length is greater than 65,535.
        See Also:
        Class.forName(String, boolean, ClassLoader), JVM: Array dimension limits in JVM Specification CONSTANT_Class_info, JLS: Fully Qualified Names and Canonical Names, JLS: The Form of a Binary
      • getClass

        public static java.lang.Class<?> getClass​(java.lang.String className,
                                                  boolean initialize)
                                           throws java.lang.ClassNotFoundException
        Gets the class represented by className using the current thread's context class loader. This implementation supports the syntaxes "java.util.Map.Entry[]", "java.util.Map$Entry[]", "[Ljava.util.Map.Entry;", and "[Ljava.util.Map$Entry;".

        The provided class name is normalized by removing all whitespace. This is especially helpful when handling XML element values in which whitespace has not been collapsed.

        Security note: because all whitespace is deleted before the class is resolved (and a failing '.' may be retried as '$' for inner classes), many distinct input strings resolve to the same class, while Class.forName(String) performs no such normalization. Validating an untrusted class name by string comparison before calling this method is therefore unsound: for example, " java.lang.Runtime" fails a naive startsWith("java.") denylist check on the raw string, yet loads java.lang.Runtime. Validate the class name after normalization, validate the resolved Class object itself, or use getClassStrict(ClassLoader, String, boolean) which performs no whitespace normalization.

        Parameters:
        className - The class name.
        initialize - whether the class must be initialized.
        Returns:
        The class represented by className using the current thread's context class loader.
        Throws:
        java.lang.NullPointerException - Thrown if the className is null.
        java.lang.ClassNotFoundException - Thrown if the class is not found.
        java.lang.IllegalArgumentException - Thrown if the class name represents an array with more dimensions than the JVM supports, 255.
        java.lang.IllegalArgumentException - Thrown if the class name length is greater than 65,535.
        See Also:
        Class.forName(String, boolean, ClassLoader), JVM: Array dimension limits in JVM Specification CONSTANT_Class_info, JLS: Fully Qualified Names and Canonical Names, JLS: The Form of a Binary
      • getClassStrict

        public static java.lang.Class<?> getClassStrict​(java.lang.ClassLoader classLoader,
                                                        java.lang.String className,
                                                        boolean initialize)
                                                 throws java.lang.ClassNotFoundException
        Gets the class represented by className using the classLoader, without normalizing the class name.

        Unlike getClass(ClassLoader, String, boolean), this method does not delete whitespace from the class name: a name that differs from the intended binary name only by whitespace throws ClassNotFoundException, matching Class.forName(String, boolean, ClassLoader). Use this variant when the class name may come from an untrusted source, so that host-side string validation of the raw name cannot be bypassed through whitespace the loader would otherwise silently remove.

        The syntaxes "java.util.Map.Entry[]", "java.util.Map$Entry[]", "[Ljava.util.Map.Entry;", and "[Ljava.util.Map$Entry;" are still supported: a failing '.' is retried as '$' to find inner classes, so more than one dotted spelling can still resolve to the same inner class. When validating untrusted names, prefer validating the resolved Class object.

        Parameters:
        classLoader - The class loader to use to load the class.
        className - The class name.
        initialize - whether the class must be initialized.
        Returns:
        The class represented by className using the classLoader.
        Throws:
        java.lang.NullPointerException - Thrown if the className is null.
        java.lang.ClassNotFoundException - Thrown if the class is not found.
        java.lang.IllegalArgumentException - Thrown if the class name represents an array with more dimensions than the JVM supports, 255.
        java.lang.IllegalArgumentException - Thrown if the class name length is greater than 65,535.
        Since:
        3.21.0
        See Also:
        Class.forName(String, boolean, ClassLoader), getClass(ClassLoader, String, boolean)
      • getClassStrict

        public static java.lang.Class<?> getClassStrict​(java.lang.String className)
                                                 throws java.lang.ClassNotFoundException
        Gets the (initialized) class represented by className using the current thread's context class loader, without normalizing the class name.

        Unlike getClass(String), this method does not delete whitespace from the class name: a name that differs from the intended binary name only by whitespace throws ClassNotFoundException, matching Class.forName(String). Use this variant when the class name may come from an untrusted source, so that host-side string validation of the raw name cannot be bypassed through whitespace the loader would otherwise silently remove.

        The syntaxes "java.util.Map.Entry[]", "java.util.Map$Entry[]", "[Ljava.util.Map.Entry;", and "[Ljava.util.Map$Entry;" are still supported: a failing '.' is retried as '$' to find inner classes, so more than one dotted spelling can still resolve to the same inner class. When validating untrusted names, prefer validating the resolved Class object.

        Parameters:
        className - The class name.
        Returns:
        The class represented by className using the current thread's context class loader.
        Throws:
        java.lang.NullPointerException - Thrown if the className is null.
        java.lang.ClassNotFoundException - Thrown if the class is not found.
        java.lang.IllegalArgumentException - Thrown if the class name represents an array with more dimensions than the JVM supports, 255.
        java.lang.IllegalArgumentException - Thrown if the class name length is greater than 65,535.
        Since:
        3.21.0
        See Also:
        Class.forName(String), getClass(String)
      • getComponentType

        public static <T> java.lang.Class<T> getComponentType​(java.lang.Class<T[]> cls)
        Gets the array component type using Class.getComponentType() with generics.
        Type Parameters:
        T - The array class type.
        Parameters:
        cls - A class or null.
        Returns:
        The array component type or null.
        Since:
        3.13.0
        See Also:
        Class.getComponentType()
      • getName

        public static java.lang.String getName​(java.lang.Class<?> cls)
        Gets the class name, handling null safely.
        Parameters:
        cls - The class for which to get the class name; may be null.
        Returns:
        The class name or the empty string in case the argument is null.
        Since:
        3.7
        See Also:
        Class.getSimpleName()
      • getName

        public static java.lang.String getName​(java.lang.Class<?> cls,
                                               java.lang.String valueIfNull)
        Gets the class name, handling null safely.
        Parameters:
        cls - The class for which to get the class name; may be null.
        valueIfNull - The return value if the argument cls is null.
        Returns:
        The class name or valueIfNull
        Since:
        3.7
        See Also:
        Class.getName()
      • getName

        public static java.lang.String getName​(java.lang.Object object)
        Gets the object's class name, handling null safely.
        Parameters:
        object - The object for which to get the class name; may be null.
        Returns:
        The class name or the empty String.
        Since:
        3.7
        See Also:
        Class.getSimpleName()
      • getName

        public static java.lang.String getName​(java.lang.Object object,
                                               java.lang.String valueIfNull)
        Gets the object's class name, handling null safely.
        Parameters:
        object - The object for which to get the class name; may be null.
        valueIfNull - The value to return if object is null.
        Returns:
        The class name or valueIfNull.
        Since:
        3.0
        See Also:
        Class.getName()
      • getPackageCanonicalName

        public static java.lang.String getPackageCanonicalName​(java.lang.Class<?> cls)
        Gets the package name from the canonical name of a Class.
        Parameters:
        cls - The class to get the package name for, may be null.
        Returns:
        The package name or an empty string.
        Since:
        2.4
      • getPackageCanonicalName

        public static java.lang.String getPackageCanonicalName​(java.lang.Object object,
                                                               java.lang.String valueIfNull)
        Gets the package name from the class name of an Object.
        Parameters:
        object - The class to get the package name for, may be null.
        valueIfNull - The value to return if null.
        Returns:
        The package name of the object, or the null value.
        Since:
        2.4
      • getPackageCanonicalName

        public static java.lang.String getPackageCanonicalName​(java.lang.String name)
        Gets the package name from the class name.

        The string passed in is assumed to be a class name - it is not checked.

        If the class is in the default package, return an empty string.

        Parameters:
        name - The name to get the package name for, may be null.
        Returns:
        The package name or an empty string.
        Since:
        2.4
      • getPackageName

        public static java.lang.String getPackageName​(java.lang.Class<?> cls)
        Gets the package name of a Class.
        Parameters:
        cls - The class to get the package name for, may be null.
        Returns:
        The package name or an empty string
      • getPackageName

        public static java.lang.String getPackageName​(java.lang.Object object,
                                                      java.lang.String valueIfNull)
        Gets the package name of an Object.
        Parameters:
        object - The class to get the package name for, may be null.
        valueIfNull - The value to return if null.
        Returns:
        The package name of the object, or the null value.
      • getPackageName

        public static java.lang.String getPackageName​(java.lang.String className)
        Gets the package name from a String.

        The string passed in is assumed to be a class name.

        If the class is unpackaged, return an empty string.

        Parameters:
        className - The className to get the package name for, may be null.
        Returns:
        The package name or an empty string.
      • getPublicMethod

        public static java.lang.reflect.Method getPublicMethod​(java.lang.Class<?> cls,
                                                               java.lang.String methodName,
                                                               java.lang.Class<?>... parameterTypes)
                                                        throws java.lang.NoSuchMethodException
        Gets the desired Method much like Class.getMethod, however it ensures that the returned Method is from a public class or interface and not from an anonymous inner class. This means that the Method is invokable and doesn't fall foul of Java bug (4071957).
          Set set = Collections.unmodifiableSet(...);
          Method method = ClassUtils.getPublicMethod(set.getClass(), "isEmpty",  new Class[0]);
          Object result = method.invoke(set, new Object[]);
         
        Parameters:
        cls - The class to check, not null.
        methodName - The name of the method.
        parameterTypes - The list of parameters.
        Returns:
        The method.
        Throws:
        java.lang.NullPointerException - Thrown if the class is null.
        java.lang.SecurityException - Thrown if a security violation occurred.
        java.lang.NoSuchMethodException - Thrown if the method is not found in the given class or if the method doesn't conform with the requirements.
      • getShortCanonicalName

        public static java.lang.String getShortCanonicalName​(java.lang.Class<?> cls)
        Gets the canonical name minus the package name from a Class.
        Parameters:
        cls - The class for which to get the short canonical class name; may be null.
        Returns:
        The canonical name without the package name or an empty string.
        Since:
        2.4
        See Also:
        Class.getCanonicalName()
      • getShortCanonicalName

        public static java.lang.String getShortCanonicalName​(java.lang.Object object,
                                                             java.lang.String valueIfNull)
        Gets the canonical name minus the package name for an Object.
        Parameters:
        object - The class to get the short name for, may be null.
        valueIfNull - The value to return if null.
        Returns:
        The canonical name of the object without the package name, or the null value.
        Since:
        2.4
        See Also:
        Class.getCanonicalName()
      • getShortCanonicalName

        public static java.lang.String getShortCanonicalName​(java.lang.String canonicalName)
        Gets the canonical name minus the package name from a String.

        The string passed in is assumed to be a class name - it is not checked.

        Note that this method is mainly designed to handle the arrays and primitives properly. If the class is an inner class then the result value will not contain the outer classes. This way the behavior of this method is different from getShortClassName(String). The argument in that case is class name and not canonical name and the return value retains the outer classes.

        Note that there is no way to reliably identify the part of the string representing the package hierarchy and the part that is the outer class or classes in case of an inner class. Trying to find the class would require reflective call and the class itself may not even be on the class path. Relying on the fact that class names start with capital letter and packages with lower case is heuristic.

        It is recommended to use getShortClassName(String) for cases when the class is an inner class and use this method for cases it is designed for.

        Examples
        return value input
        "" (String) null
        "Map.Entry" java.util.Map.Entry.class.getName()
        "Entry" java.util.Map.Entry.class.getCanonicalName()
        "ClassUtils" "org.apache.commons.lang3.ClassUtils"
        "ClassUtils[]" "[Lorg.apache.commons.lang3.ClassUtils;"
        "ClassUtils[][]" "[[Lorg.apache.commons.lang3.ClassUtils;"
        "ClassUtils[]" "org.apache.commons.lang3.ClassUtils[]"
        "ClassUtils[][]" "org.apache.commons.lang3.ClassUtils[][]"
        "int[]" "[I"
        "int[]" int[].class.getCanonicalName()
        "int[]" int[].class.getName()
        "int[][]" "[[I"
        "int[]" "int[]"
        "int[][]" "int[][]"
        Parameters:
        canonicalName - The class name to get the short name for.
        Returns:
        The canonical name of the class without the package name or an empty string.
        Since:
        2.4
      • getShortClassName

        public static java.lang.String getShortClassName​(java.lang.Class<?> cls)
        Gets the class name minus the package name from a Class.
        Parameters:
        cls - The class to get the short name for.
        Returns:
        The class name without the package name or an empty string. If the class is an inner class then the returned value will contain the outer class or classes separated with . (dot) character.
      • getShortClassName

        public static java.lang.String getShortClassName​(java.lang.Object object,
                                                         java.lang.String valueIfNull)
        Gets the class name of the object without the package name or names.
        Parameters:
        object - The class to get the short name for, may be null.
        valueIfNull - The value to return if the object is null.
        Returns:
        The class name of the object without the package name, or valueIfNull if the argument object is null.
      • getShortClassName

        public static java.lang.String getShortClassName​(java.lang.String className)
        Gets the class name minus the package name from a String.

        The string passed in is assumed to be a class name - it is not checked. The string has to be formatted the way as the JDK method Class.getName() returns it, and not the usual way as we write it, for example in import statements, or as it is formatted by Class.getCanonicalName().

        The difference is significant only in case of classes that are inner classes of some other classes. In this case the separator between the outer and inner class (possibly on multiple hierarchy level) has to be $ (dollar sign) and not . (dot), as it is returned by Class.getName()

        Note that this method is called from the getShortClassName(Class) method using the string returned by Class.getName().

        Note that this method differs from getSimpleName(Class) in that this will return, for example "Map.Entry" whilst the Class variant will simply return "Entry". In this example the argument className is the string java.util.Map$Entry (note the $ sign).

        Parameters:
        className - The className to get the short name for. It has to be formatted as returned by Class.getName() and not Class.getCanonicalName().
        Returns:
        The class name of the class without the package name or an empty string. If the class is an inner class then value contains the outer class or classes and the separator is replaced to be . (dot) character.
      • getSimpleName

        public static java.lang.String getSimpleName​(java.lang.Class<?> cls)
        Gets the simple class name, handling null safely.
        Parameters:
        cls - The class for which to get the simple name; may be null.
        Returns:
        The simple class name or the empty string in case the argument is null.
        Since:
        3.0
        See Also:
        Class.getSimpleName()
      • getSimpleName

        public static java.lang.String getSimpleName​(java.lang.Class<?> cls,
                                                     java.lang.String valueIfNull)
        Gets the simple class name, handling null safely.
        Parameters:
        cls - The class for which to get the simple name; may be null.
        valueIfNull - The value to return if null.
        Returns:
        The simple class name or valueIfNull if the argument cls is null.
        Since:
        3.0
        See Also:
        Class.getSimpleName()
      • getSimpleName

        public static java.lang.String getSimpleName​(java.lang.Object object)
        Gets the object's simple class name, handling null safely.

        It is to note that this method is overloaded and in case the argument object is a Class object then the getSimpleName(Class) will be invoked. If this is a significant possibility then the caller should check this case and call getSimpleName(Class.class) or just simply use the string literal "Class", which is the result of the method in that case.

        Parameters:
        object - The object for which to get the simple class name; may be null.
        Returns:
        The simple class name or the empty string in case the argument is null.
        Since:
        3.7
        See Also:
        Class.getSimpleName()
      • getSimpleName

        public static java.lang.String getSimpleName​(java.lang.Object object,
                                                     java.lang.String valueIfNull)
        Gets the object's simple class name, handling null safely.
        Parameters:
        object - The object for which to get the simple class name; may be null.
        valueIfNull - The value to return if object is null.
        Returns:
        The simple class name or valueIfNull if the argument object is null.
        Since:
        3.0
        See Also:
        Class.getSimpleName()
      • hierarchy

        public static java.lang.Iterable<java.lang.Class<?>> hierarchy​(java.lang.Class<?> type)
        Gets an Iterable that can iterate over a class hierarchy in ascending (subclass to superclass) order, excluding interfaces.
        Parameters:
        type - The type to get the class hierarchy from.
        Returns:
        Iterable an Iterable over the class hierarchy of the given class.
        Since:
        3.2
      • hierarchy

        public static java.lang.Iterable<java.lang.Class<?>> hierarchy​(java.lang.Class<?> type,
                                                                       ClassUtils.Interfaces interfacesBehavior)
        Gets an Iterable that can iterate over a class hierarchy in ascending (subclass to superclass) order.
        Parameters:
        type - The type to get the class hierarchy from.
        interfacesBehavior - switch indicating whether to include or exclude interfaces.
        Returns:
        Iterable an Iterable over the class hierarchy of the given class.
        Since:
        3.2
      • isAssignable

        public static boolean isAssignable​(java.lang.Class<?> cls,
                                           java.lang.Class<?> toClass)
        Tests whether one Class can be assigned to a variable of another Class.

        Unlike the Class.isAssignableFrom(java.lang.Class) method, this method takes into account widenings of primitive classes and nulls.

        Primitive widenings allow an int to be assigned to a long, float or double. This method returns the correct result for these cases.

        null may be assigned to any reference type. This method will return true if null is passed in and the toClass is non-primitive.

        Specifically, this method tests whether the type represented by the specified Class parameter can be converted to the type represented by this Class object via an identity conversion widening primitive or widening reference conversion. See The Java Language Specification, sections 5.1.1, 5.1.2 and 5.1.4 for details.

        Since Lang 3.0, this method will default behavior for calculating assignability between primitive and wrapper types corresponding to the running Java version; i.e. autoboxing will be the default behavior in VMs running Java versions > 1.5.

        Parameters:
        cls - The Class to check, may be null.
        toClass - The Class to try to assign into, returns false if null.
        Returns:
        true if assignment possible.
      • isAssignable

        public static boolean isAssignable​(java.lang.Class<?> cls,
                                           java.lang.Class<?> toClass,
                                           boolean autoboxing)
        Tests whether one Class can be assigned to a variable of another Class.

        Unlike the Class.isAssignableFrom(java.lang.Class) method, this method takes into account widenings of primitive classes and nulls.

        Primitive widenings allow an int to be assigned to a long, float or double. This method returns the correct result for these cases.

        null may be assigned to any reference type. This method will return true if null is passed in and the toClass is non-primitive.

        Specifically, this method tests whether the type represented by the specified Class parameter can be converted to the type represented by this Class object via an identity conversion widening primitive or widening reference conversion. See The Java Language Specification, sections 5.1.1, 5.1.2 and 5.1.4 for details.

        Parameters:
        cls - The Class to check, may be null.
        toClass - The Class to try to assign into, returns false if null.
        autoboxing - whether to use implicit autoboxing/unboxing between primitives and wrappers.
        Returns:
        true if assignment possible.
      • isAssignable

        public static boolean isAssignable​(java.lang.Class<?>[] classArray,
                                           java.lang.Class<?>... toClassArray)
        Tests whether an array of Classes can be assigned to another array of Classes.

        This method calls isAssignable for each Class pair in the input arrays. It can be used to check if a set of arguments (the first parameter) are suitably compatible with a set of method parameter types (the second parameter).

        Unlike the Class.isAssignableFrom(java.lang.Class) method, this method takes into account widenings of primitive classes and nulls.

        Primitive widenings allow an int to be assigned to a long, float or double. This method returns the correct result for these cases.

        null may be assigned to any reference type. This method will return true if null is passed in and the toClass is non-primitive.

        Specifically, this method tests whether the type represented by the specified Class parameter can be converted to the type represented by this Class object via an identity conversion widening primitive or widening reference conversion. See The Java Language Specification, sections 5.1.1, 5.1.2 and 5.1.4 for details.

        Since Lang 3.0, this method will default behavior for calculating assignability between primitive and wrapper types corresponding to the running Java version; i.e. autoboxing will be the default behavior in VMs running Java versions > 1.5.

        Parameters:
        classArray - The array of Classes to check, may be null.
        toClassArray - The array of Classes to try to assign into, may be null.
        Returns:
        true if assignment possible.
      • isAssignable

        public static boolean isAssignable​(java.lang.Class<?>[] classArray,
                                           java.lang.Class<?>[] toClassArray,
                                           boolean autoboxing)
        Tests whether an array of Classes can be assigned to another array of Classes.

        This method calls isAssignable for each Class pair in the input arrays. It can be used to check if a set of arguments (the first parameter) are suitably compatible with a set of method parameter types (the second parameter).

        Unlike the Class.isAssignableFrom(java.lang.Class) method, this method takes into account widenings of primitive classes and nulls.

        Primitive widenings allow an int to be assigned to a long, float or double. This method returns the correct result for these cases.

        null may be assigned to any reference type. This method will return true if null is passed in and the toClass is non-primitive.

        Specifically, this method tests whether the type represented by the specified Class parameter can be converted to the type represented by this Class object via an identity conversion widening primitive or widening reference conversion. See The Java Language Specification, sections 5.1.1, 5.1.2 and 5.1.4 for details.

        Parameters:
        classArray - The array of Classes to check, may be null
        toClassArray - The array of Classes to try to assign into, may be null
        autoboxing - whether to use implicit autoboxing/unboxing between primitives and wrappers
        Returns:
        true if assignment possible
      • isInnerClass

        public static boolean isInnerClass​(java.lang.Class<?> cls)
        Tests whether the specified class an inner class or static nested class.
        Parameters:
        cls - The class to check, may be null.
        Returns:
        true if the class is an inner or static nested class, false if not or null.
      • isPrimitiveOrWrapper

        public static boolean isPrimitiveOrWrapper​(java.lang.Class<?> type)
        Tests whether the given type is a primitive or primitive wrapper (Boolean, Byte, Character, Short, Integer, Long, Double, Float).
        Parameters:
        type - The class to query or null.
        Returns:
        true if the given type is a primitive or primitive wrapper (Boolean, Byte, Character, Short, Integer, Long, Double, Float).
        Since:
        3.1
      • isPrimitiveWrapper

        public static boolean isPrimitiveWrapper​(java.lang.Class<?> type)
        Tests whether the given type is a primitive wrapper (Boolean, Byte, Character, Short, Integer, Long, Double, Float).
        Parameters:
        type - The class to query or null.
        Returns:
        true if the given type is a primitive wrapper (Boolean, Byte, Character, Short, Integer, Long, Double, Float).
        Since:
        3.1
      • isPublic

        public static boolean isPublic​(java.lang.Class<?> cls)
        Tests whether a Class is public.
        Parameters:
        cls - Class to test.
        Returns:
        true if cls is public.
        Since:
        3.13.0
      • primitivesToWrappers

        public static java.lang.Class<?>[] primitivesToWrappers​(java.lang.Class<?>... classes)
        Converts the specified array of primitive Class objects to an array of its corresponding wrapper Class objects.
        Parameters:
        classes - The class array to convert, may be null or empty.
        Returns:
        An array which contains for each given class, the wrapper class or the original class if class is not a primitive. null if null input. Empty array if an empty array passed in.
        Since:
        2.1
      • primitiveToWrapper

        public static java.lang.Class<?> primitiveToWrapper​(java.lang.Class<?> cls)
        Converts the specified primitive Class object to its corresponding wrapper Class object.

        NOTE: From v2.2, this method handles Void.TYPE, returning Void.TYPE.

        Parameters:
        cls - The class to convert, may be null.
        Returns:
        The wrapper class for cls or cls if cls is not a primitive. null if null input.
        Since:
        2.1
      • toClass

        public static java.lang.Class<?>[] toClass​(java.lang.Object... array)
        Converts an array of Object in to an array of Class objects. If any of these objects is null, a null element will be inserted into the array.

        This method returns null for a null input array.

        Parameters:
        array - An Object array.
        Returns:
        A Class array, null if null array input.
        Since:
        2.4
      • wrappersToPrimitives

        public static java.lang.Class<?>[] wrappersToPrimitives​(java.lang.Class<?>... classes)
        Converts the specified array of wrapper Class objects to an array of its corresponding primitive Class objects.

        This method invokes wrapperToPrimitive() for each element of the passed in array.

        Parameters:
        classes - The class array to convert, may be null or empty.
        Returns:
        An array which contains for each given class, the primitive class or null if the original class is not a wrapper class. null if null input. Empty array if an empty array passed in.
        Since:
        2.4
        See Also:
        wrapperToPrimitive(Class)
      • wrapperToPrimitive

        public static java.lang.Class<?> wrapperToPrimitive​(java.lang.Class<?> cls)
        Converts the specified wrapper class to its corresponding primitive class.

        This method is the counter part of primitiveToWrapper(). If the passed in class is a wrapper class for a primitive type, this primitive type will be returned (e.g. Integer.TYPE for Integer.class). For other classes, or if the parameter is null, the return value is null.

        Parameters:
        cls - The class to convert, may be null.
        Returns:
        The corresponding primitive type if cls is a wrapper class, null otherwise.
        Since:
        2.4
        See Also:
        primitiveToWrapper(Class)