net.bytebuddy.dynamic.loading

Class ClassInjector.UsingReflection.Dispatcher.Direct

java.lang.Object

net.bytebuddy.dynamic.loading.ClassInjector.UsingReflection.Dispatcher.Direct

All Implemented Interfaces:

ClassInjector.UsingReflection.Dispatcher, ClassInjector.UsingReflection.Dispatcher.Initializable

Direct Known Subclasses:

ClassInjector.UsingReflection.Dispatcher.Direct.ForJava7CapableVm, ClassInjector.UsingReflection.Dispatcher.Direct.ForLegacyVm

Enclosing interface:

ClassInjector.UsingReflection.Dispatcher

@HashCodeAndEqualsPlugin.Enhance
public abstract static class ClassInjector.UsingReflection.Dispatcher.Direct
extends Object
implements ClassInjector.UsingReflection.Dispatcher, ClassInjector.UsingReflection.Dispatcher.Initializable

A class injection dispatcher that is using reflection on the ClassLoader methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ClassInjector.UsingReflection.Dispatcher.Direct.ForJava7CapableVm A resolved class dispatcher for a class injector on a VM running at least Java 7.
protected static class	ClassInjector.UsingReflection.Dispatcher.Direct.ForLegacyVm A resolved class dispatcher for a class injector prior to Java 7.

Nested classes/interfaces inherited from interface net.bytebuddy.dynamic.loading.ClassInjector.UsingReflection.Dispatcher

ClassInjector.UsingReflection.Dispatcher.CreationAction, ClassInjector.UsingReflection.Dispatcher.Direct, ClassInjector.UsingReflection.Dispatcher.Initializable, ClassInjector.UsingReflection.Dispatcher.Unavailable, ClassInjector.UsingReflection.Dispatcher.UsingUnsafeInjection, ClassInjector.UsingReflection.Dispatcher.UsingUnsafeOverride

Nested classes/interfaces inherited from interface net.bytebuddy.dynamic.loading.ClassInjector.UsingReflection.Dispatcher.Initializable

ClassInjector.UsingReflection.Dispatcher.Initializable.Unavailable

Field Summary

Fields

Modifier and Type	Field and Description
protected Method	defineClass An instance of ClassLoader.defineClass(String, byte[], int, int, ProtectionDomain).
protected Method	definePackage An instance of ClassLoader.definePackage(String, String, String, String, String, String, String, URL).
protected Method	findLoadedClass An instance of ClassLoader.findLoadedClass(String).
protected Method	getDefinedPackage An instance of java.lang.ClassLoader#getDefinedPackage(String).
protected Method	getPackage An instance of ClassLoader.getPackage(String).

Fields inherited from interface net.bytebuddy.dynamic.loading.ClassInjector.UsingReflection.Dispatcher

UNDEFINED

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Direct(Method findLoadedClass, Method defineClass, Method getDefinedPackage, Method getPackage, Method definePackage) Creates a new direct injection dispatcher.

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.
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.
ClassInjector.UsingReflection.Dispatcher	initialize() Initializes this dispatcher.
boolean	isAvailable() Indicates if this dispatcher is available.
protected static ClassInjector.UsingReflection.Dispatcher.Initializable	make() Creates a direct dispatcher.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.bytebuddy.dynamic.loading.ClassInjector.UsingReflection.Dispatcher

getClassLoadingLock

Field Detail

findLoadedClass

protected final Method findLoadedClass

An instance of ClassLoader.findLoadedClass(String).

defineClass

protected final Method defineClass

An instance of ClassLoader.defineClass(String, byte[], int, int, ProtectionDomain).

getDefinedPackage

@UnknownNull
protected final Method getDefinedPackage

An instance of java.lang.ClassLoader#getDefinedPackage(String). May be null.

getPackage

protected final Method getPackage

An instance of ClassLoader.getPackage(String).

definePackage

protected final Method definePackage

An instance of ClassLoader.definePackage(String, String, String, String, String, String, String, URL).

Constructor Detail

Direct

protected Direct(Method findLoadedClass,
                 Method defineClass,
                 @MaybeNull
                 Method getDefinedPackage,
                 Method getPackage,
                 Method definePackage)

Creates a new direct injection dispatcher.

Parameters:

findLoadedClass - An instance of ClassLoader.findLoadedClass(String).

defineClass - An instance of ClassLoader.defineClass(String, byte[], int, int, ProtectionDomain).

getDefinedPackage - An instance of java.lang.ClassLoader#getDefinedPackage(String). May be null.

getPackage - An instance of ClassLoader.getPackage(String).

definePackage - An instance of ClassLoader.definePackage(String, String, String, String, String, String, String, URL).

Method Detail

make

protected static ClassInjector.UsingReflection.Dispatcher.Initializable make()
                                                                      throws Exception

Creates a direct dispatcher.

Returns:

A direct dispatcher for class injection.

Throws:

Exception - If the creation is impossible.

isAvailable

public boolean isAvailable()

Indicates if this dispatcher is available.

Specified by:

isAvailable in interface ClassInjector.UsingReflection.Dispatcher.Initializable

Returns:

true if this dispatcher is available.

initialize

public ClassInjector.UsingReflection.Dispatcher initialize()

Initializes this dispatcher.

Specified by:

initialize in interface ClassInjector.UsingReflection.Dispatcher.Initializable

Returns:

The initialized dispatcher.

findClass

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

Looks up a class from the given class loader.

Specified by:

findClass in interface ClassInjector.UsingReflection.Dispatcher

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

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

Defines a class for the given class loader.

Specified by:

defineClass in interface ClassInjector.UsingReflection.Dispatcher

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
public Package getDefinedPackage(ClassLoader classLoader,
                                            String name)

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

Specified by:

getDefinedPackage in interface ClassInjector.UsingReflection.Dispatcher

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

public Package getPackage(ClassLoader classLoader,
                          String name)

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

Specified by:

getPackage in interface ClassInjector.UsingReflection.Dispatcher

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

public 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.

Specified by:

definePackage in interface ClassInjector.UsingReflection.Dispatcher

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.