Package io.camunda.zeebe.util.jar

Class ExternalJarClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

io.camunda.zeebe.util.jar.ExternalJarClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public final class ExternalJarClassLoader
extends URLClassLoader

Provides a class loader which isolates external exporters from other exporters, while exposing our own code to ensure versions match at runtime.

NOTE: if you forget to close this class loader, the underlying file is cleaned up by the garbage collector (via Cleaner once this class loader has been garbage collected.

If possible, it's still a good idea to close explicitly to free resources sooner and to avoid depending on undocumented behavior of a standard library class.

Method Summary

Modifier and Type	Method	Description
void	close()	Close class loader with verbose log statement.
void	close(boolean verbose)	Allows to close the class loader without warning statement
Class<?>	loadClass(String name)
static ExternalJarClassLoader	ofPath(Path jarPath)

Methods inherited from class java.net.URLClassLoader

addURL, definePackage, findClass, findResource, findResources, getPermissions, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

close

public void close()
           throws IOException

Close class loader with verbose log statement.

Be aware that premature closing may lead to ClassNotFoundException.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class URLClassLoader

Throws:

IOException

close

public void close(boolean verbose)
           throws IOException

Allows to close the class loader without warning statement

Be aware that premature closing may lead to ClassNotFoundException.

Throws:

IOException

ofPath

public static ExternalJarClassLoader ofPath(Path jarPath)
                                     throws ExternalJarLoadException

Throws:

ExternalJarLoadException

loadClass

public Class<?> loadClass(String name)
                   throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException