Package spark.utils

Class ClassUtils

java.lang.Object
spark.utils.ClassUtils

public abstract class ClassUtils extends Object
Miscellaneous class utility methods. Mainly for internal use within the framework.
Since:
1.1 Code copied from Spring source. Modifications made (mostly removal of methods) by Per Wendel.
  • Field Details

    • ARRAY_SUFFIX

      public static final String ARRAY_SUFFIX
      Suffix for array class names: "[]"
      See Also:
    • INTERNAL_ARRAY_PREFIX

      private static final String INTERNAL_ARRAY_PREFIX
      Prefix for internal array class names: "["
      See Also:
    • NON_PRIMITIVE_ARRAY_PREFIX

      private static final String NON_PRIMITIVE_ARRAY_PREFIX
      Prefix for internal non-primitive array class names: "[L"
      See Also:
    • primitiveWrapperTypeMap

      private static final Map<Class<?>,Class<?>> primitiveWrapperTypeMap
      Map with primitive wrapper type as key and corresponding primitive type as value, for example: Integer.class -> int.class.
    • primitiveTypeToWrapperMap

      private static final Map<Class<?>,Class<?>> primitiveTypeToWrapperMap
      Map with primitive type as key and corresponding wrapper type as value, for example: int.class -> Integer.class.
    • primitiveTypeNameMap

      private static final Map<String,Class<?>> primitiveTypeNameMap
      Map with primitive type name as key and corresponding primitive type as value, for example: "int" -> "int.class".
    • commonClassCache

      private static final Map<String,Class<?>> commonClassCache
      Map with common "java.lang" class name as key and corresponding Class as value. Primarily for efficient deserialization of remote invocations.
  • Constructor Details

    • ClassUtils

      public ClassUtils()
  • Method Details

    • registerCommonClasses

      private static void registerCommonClasses(Class<?>... commonClasses)
      Register the given common classes with the ClassUtils cache.
    • getDefaultClassLoader

      public static ClassLoader getDefaultClassLoader()
      Return the default ClassLoader to use: typically the thread context ClassLoader, if available; the ClassLoader that loaded the ClassUtils class will be used as fallback.

      Call this method if you intend to use the thread context ClassLoader in a scenario where you absolutely need a non-null ClassLoader reference: for example, for class path resource loading (but not necessarily for Class.forName, which accepts a null ClassLoader reference as well).

      Returns:
      the default ClassLoader (never null)
      See Also:
    • forName

      public static Class<?> forName(String name, ClassLoader classLoader) throws ClassNotFoundException, LinkageError
      Replacement for Class.forName() that also returns Class instances for primitives (e.g."int") and array class names (e.g. "String[]"). Furthermore, it is also capable of resolving inner class names in Java source style (e.g. "java.lang.Thread.State" instead of "java.lang.Thread$State").
      Parameters:
      name - the name of the Class
      classLoader - the class loader to use (may be null, which indicates the default class loader)
      Returns:
      Class instance for the supplied name
      Throws:
      ClassNotFoundException - if the class was not found
      LinkageError - if the class file could not be loaded
      See Also:
    • resolvePrimitiveClassName

      public static Class<?> resolvePrimitiveClassName(String name)
      Resolve the given class name as primitive class, if appropriate, according to the JVM's naming rules for primitive classes.

      Also supports the JVM's internal class names for primitive arrays. Does not support the "[]" suffix notation for primitive arrays; this is only supported by forName(String, ClassLoader).

      Parameters:
      name - the name of the potentially primitive class
      Returns:
      the primitive class, or null if the name does not denote a primitive class or primitive array class
    • classPackageAsResourcePath

      public static String classPackageAsResourcePath(Class<?> clazz)
      Given an input class object, return a string which consists of the class's package name as a pathname, i.e., all dots ('.') are replaced by slashes ('/'). Neither a leading nor trailing slash is added. The result could be concatenated with a slash and the name of a resource and fed directly to ClassLoader.getResource(). For it to be fed to Class.getResource instead, a leading slash would also have to be prepended to the returned value.
      Parameters:
      clazz - the input class. A null value or the default (empty) package will result in an empty string ("") being returned.
      Returns:
      a path which represents the package name
      See Also: