net.bytebuddy.dynamic.loading

Interface ClassInjector.UsingReflection.Dispatcher

All Known Implementing Classes:

ClassInjector.UsingReflection.Dispatcher.Direct, ClassInjector.UsingReflection.Dispatcher.Direct.ForJava7CapableVm, ClassInjector.UsingReflection.Dispatcher.Direct.ForLegacyVm, ClassInjector.UsingReflection.Dispatcher.Initializable.Unavailable, ClassInjector.UsingReflection.Dispatcher.Unavailable, ClassInjector.UsingReflection.Dispatcher.UsingUnsafeInjection, ClassInjector.UsingReflection.Dispatcher.UsingUnsafeOverride, ClassInjector.UsingReflection.Dispatcher.UsingUnsafeOverride.ForJava7CapableVm, ClassInjector.UsingReflection.Dispatcher.UsingUnsafeOverride.ForLegacyVm

Enclosing class:

ClassInjector.UsingReflection

protected static interface ClassInjector.UsingReflection.Dispatcher

A dispatcher for accessing a ClassLoader reflectively.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ClassInjector.UsingReflection.Dispatcher.CreationAction A creation action for a dispatcher.
static class	ClassInjector.UsingReflection.Dispatcher.Direct A class injection dispatcher that is using reflection on the ClassLoader methods.
static interface	ClassInjector.UsingReflection.Dispatcher.Initializable Initializes a dispatcher to make non-accessible APIs accessible.
static class	ClassInjector.UsingReflection.Dispatcher.Unavailable Represents an unsuccessfully loaded method lookup.
static class	ClassInjector.UsingReflection.Dispatcher.UsingUnsafeInjection An indirect dispatcher that uses a redirection accessor class that was injected into the bootstrap class loader.
static class	ClassInjector.UsingReflection.Dispatcher.UsingUnsafeOverride A dispatcher implementation that uses sun.misc.Unsafe#putBoolean to set the AccessibleObject field for making methods accessible.

Field Summary

Fields

Modifier and Type	Field and Description
static Class<?>	UNDEFINED Indicates a class that is currently not defined.

Method Summary

Modifier and Type	Method and Description
Class<?>	defineClass(ClassLoader classLoader, String name, byte[] binaryRepresentation, ProtectionDomain protectionDomain) Defines a class for the given class loader.
Package	definePackage(ClassLoader classLoader, String name, String specificationTitle, String specificationVersion, String specificationVendor, String implementationTitle, String implementationVersion, String implementationVendor, URL sealBase) Defines a package for the given class loader.
Class<?>	findClass(ClassLoader classLoader, String name) Looks up a class from the given class loader.
Object	getClassLoadingLock(ClassLoader classLoader, String name) Returns the lock for loading the specified class.
Package	getDefinedPackage(ClassLoader classLoader, String name) Looks up a package from a class loader.
Package	getPackage(ClassLoader classLoader, String name) Looks up a package from a class loader or its ancestor.

Field Detail

UNDEFINED

static final Class<?> UNDEFINED

Indicates a class that is currently not defined.

Method Detail

getClassLoadingLock

Object getClassLoadingLock(ClassLoader classLoader,
                           String name)

Returns the lock for loading the specified class.

Parameters:

classLoader - the class loader to inject the class into.

name - The name of the class.

Returns:

The lock for loading this class.

findClass

Class<?> findClass(ClassLoader classLoader,
                   String name)

Looks up a class from the given class loader.

Parameters:

classLoader - The class loader for which a class should be located.

name - The binary name of the class that should be located.

Returns:

The class for the binary name or null if no such class is defined for the provided class loader.

defineClass

Class<?> defineClass(ClassLoader classLoader,
                     String name,
                     byte[] binaryRepresentation,
                     ProtectionDomain protectionDomain)

Defines a class for the given class loader.

Parameters:

classLoader - The class loader for which a new class should be defined.

name - The binary name of the class that should be defined.

binaryRepresentation - The binary representation of the class.

protectionDomain - The protection domain for the defined class.

Returns:

The defined, loaded class.

getDefinedPackage

Package getDefinedPackage(ClassLoader classLoader,
                          String name)

Looks up a package from a class loader. If the operation is not supported, falls back to getPackage(ClassLoader, String)

Parameters:

classLoader - The class loader to query.

name - The binary name of the package.

Returns:

The package for the given name as defined by the provided class loader or null if no such package exists.

getPackage

Package getPackage(ClassLoader classLoader,
                   String name)

Looks up a package from a class loader or its ancestor.

Parameters:

classLoader - The class loader to query.

name - The binary name of the package.

Returns:

The package for the given name as defined by the provided class loader or its ancestor, or null if no such package exists.

definePackage

Package definePackage(ClassLoader classLoader,
                      String name,
                      String specificationTitle,
                      String specificationVersion,
                      String specificationVendor,
                      String implementationTitle,
                      String implementationVersion,
                      String implementationVendor,
                      URL sealBase)

Defines a package for the given class loader.

Parameters:

classLoader - The class loader for which a package is to be defined.

name - The binary name of the package.

specificationTitle - The specification title of the package or null if no specification title exists.

specificationVersion - The specification version of the package or null if no specification version exists.

specificationVendor - The specification vendor of the package or null if no specification vendor exists.

implementationTitle - The implementation title of the package or null if no implementation title exists.

implementationVersion - The implementation version of the package or null if no implementation version exists.

implementationVendor - The implementation vendor of the package or null if no implementation vendor exists.

sealBase - The seal base URL or null if the package should not be sealed.

Returns:

The defined package.