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

@AlwaysNull
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

@MaybeNull
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,
                     @MaybeNull
                     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

@MaybeNull
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

@MaybeNull
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,
                      @MaybeNull
                      String specificationTitle,
                      @MaybeNull
                      String specificationVersion,
                      @MaybeNull
                      String specificationVendor,
                      @MaybeNull
                      String implementationTitle,
                      @MaybeNull
                      String implementationVersion,
                      @MaybeNull
                      String implementationVendor,
                      @MaybeNull
                      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.