Class JarClassLoader


  • public class JarClassLoader
    extends AbstractClassLoader
    Reads the class bytes from jar files and other resources using ClasspathResources
    Author:
    Kamran Zafar
    • Constructor Detail

      • JarClassLoader

        public JarClassLoader()
      • JarClassLoader

        public JarClassLoader​(ClassLoader parent)
      • JarClassLoader

        public JarClassLoader​(Object[] sources)
        Loads classes from different sources.
        Parameters:
        sources - classpath entries to add
      • JarClassLoader

        public JarClassLoader​(List<?> sources)
        Loads classes from different sources.
        Parameters:
        sources - classpath entries to add
    • Method Detail

      • initialize

        public void initialize()
        Some initialisations
      • addAll

        public void addAll​(Object[] sources)
        Adds all jar/class sources.
        Parameters:
        sources - classpath entries to add
      • addAll

        public void addAll​(List<?> sources)
        Adds all jar/class sources.
        Parameters:
        sources - classpath entries to add
      • add

        public void add​(Object source)
        Adds a local or remote classpath source.
        Parameters:
        source - jar path, URL, file, or input stream
      • add

        public void add​(String resourceName)
        Adds a local or remote classpath resource.
        Parameters:
        resourceName - path or URL of the resource to load
      • add

        public void add​(File file)
        Adds a local classpath resource.
        Parameters:
        file - jar file, class file, or directory to load
      • add

        public void add​(InputStream jarStream)
        Adds classes from a JAR input stream.
        Parameters:
        jarStream - JAR content stream
      • add

        public void add​(URL url)
        Adds a local or remote classpath resource.
        Parameters:
        url - resource URL
      • loadClassBytes

        protected byte[] loadClassBytes​(String className)
        Reads the class bytes from different local and remote resources using ClasspathResources.
        Parameters:
        className - binary name of the class to load
        Returns:
        class bytes, or null if not found
      • unloadClass

        public void unloadClass​(String className)
        Attempts to unload a class; only locally loaded JCL classes are removed from the cache.
        Parameters:
        className - binary name of the class to unload
      • formatClassName

        protected String formatClassName​(String className)
        Converts a binary class name to the resource path used by ClasspathResources.
        Parameters:
        className - binary name of the class
        Returns:
        resource path ending in .class
      • ensurePackageDefined

        protected void ensurePackageDefined​(String className)
        Loads package-info.class when present so package-level annotations are visible via Package.getAnnotation(Class).
      • defineLoadedClass

        protected final Class<?> defineLoadedClass​(String className,
                                                   byte[] classBytes,
                                                   int offset,
                                                   int length,
                                                   boolean resolve)
        Defines a class from bytes after applying package-info annotations.
        Parameters:
        className - binary name of the class
        classBytes - class file bytes
        offset - start offset in classBytes
        length - length of class data
        resolve - whether to link the class
        Returns:
        the defined class, or null if definition failed
      • getClassNameReplacementChar

        public char getClassNameReplacementChar()
      • setClassNameReplacementChar

        public void setClassNameReplacementChar​(char classNameReplacementChar)
      • getLoadedResources

        public Map<String,​byte[]> getLoadedResources()
        Returns all loaded classes and resources
        Returns:
        Map
      • getLocalLoader

        public ProxyClassLoader getLocalLoader()
        Returns:
        Local JCL ProxyClassLoader
      • getLoadedClasses

        public Map<String,​Class<?>> getLoadedClasses()
        Returns all JCL-loaded classes as an immutable Map
        Returns:
        Map