Class ClassLoadingStrategy.Default.InjectionDispatcher

java.lang.Object

net.bytebuddy.dynamic.loading.ClassLoadingStrategy.Default.InjectionDispatcher

All Implemented Interfaces:

ClassLoadingStrategy<ClassLoader>, ClassLoadingStrategy.Configurable<ClassLoader>

Enclosing class:

ClassLoadingStrategy.Default

@Enhance
protected static class ClassLoadingStrategy.Default.InjectionDispatcher
extends Object
implements ClassLoadingStrategy.Configurable<ClassLoader>

A class loading strategy which applies a class loader injection while applying a given ProtectionDomain on class injection.

Important: Class injection requires access to JVM internal methods that are sealed by security managers and the Java Platform module system. Since Java 11, access to these methods is no longer feasible unless those packages are explicitly opened.

Nested Class Summary

Nested classes/interfaces inherited from interface ClassLoadingStrategy

ClassLoadingStrategy.Configurable<S>, ClassLoadingStrategy.Default, ClassLoadingStrategy.ForBootstrapInjection, ClassLoadingStrategy.ForJnaInjection, ClassLoadingStrategy.ForUnsafeInjection, ClassLoadingStrategy.UsingLookup

Field Summary

Fields inherited from interface ClassLoadingStrategy

BOOTSTRAP_LOADER, NO_PROTECTION_DOMAIN

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	InjectionDispatcher()	Creates a new injection dispatcher.

Method Summary

Modifier and Type	Method	Description
ClassLoadingStrategy.Configurable<ClassLoader>	allowExistingTypes()	Determines if this class loading strategy should not throw an exception when attempting to load a class that was already loaded.
Map<TypeDescription, Class<?>>	load(ClassLoader classLoader, Map<TypeDescription, byte[]> types)	Loads a given collection of classes given their binary representation.
ClassLoadingStrategy.Configurable<ClassLoader>	opened()	With an opened class loading strategy, it is assured that types can be added to the class loader, either by indirect injection using this strategy or by creating a class loader that explicitly supports injection.
ClassLoadingStrategy.Configurable<ClassLoader>	with(ProtectionDomain protectionDomain)	Overrides the implicitly set default ProtectionDomain with an explicit one.
ClassLoadingStrategy.Configurable<ClassLoader>	with(ClassLoaderDecorator.Factory classLoaderDecoratorFactory)	Defines a factory that decorates a given class loader prior to class loading.
ClassLoadingStrategy.Configurable<ClassLoader>	with(PackageDefinitionStrategy packageDefinitionStrategy)	Defines the supplied package definition strategy to be used for defining packages.

Methods inherited from class Object

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

Constructor Details

InjectionDispatcher

protected InjectionDispatcher()

Creates a new injection dispatcher.

Method Details

load

public Map<TypeDescription, Class<?>> load(@MaybeNull
 ClassLoader classLoader,
 Map<TypeDescription, byte[]> types)

Loads a given collection of classes given their binary representation.

Specified by:

load in interface ClassLoadingStrategy<ClassLoader>

Parameters:

classLoader - The class loader to used for loading the classes.

types - Byte array representations of the types to be loaded mapped by their descriptions, where an iteration order defines an order in which they are supposed to be loaded, if relevant.

Returns:

A collection of the loaded classes which will be initialized in the iteration order of the returned collection.

with

public ClassLoadingStrategy.Configurable<ClassLoader> with(ProtectionDomain protectionDomain)

Overrides the implicitly set default ProtectionDomain with an explicit one.

Specified by:

with in interface ClassLoadingStrategy.Configurable<ClassLoader>

Parameters:

protectionDomain - The protection domain to apply or null if no protection domain is set.

Returns:

This class loading strategy with an explicitly set ProtectionDomain.

with

public ClassLoadingStrategy.Configurable<ClassLoader> with(PackageDefinitionStrategy packageDefinitionStrategy)

Defines the supplied package definition strategy to be used for defining packages.

Specified by:

with in interface ClassLoadingStrategy.Configurable<ClassLoader>

Parameters:

packageDefinitionStrategy - The package definer to be used.

Returns:

A version of this class loading strategy that applies the supplied package definition strategy.

with

public ClassLoadingStrategy.Configurable<ClassLoader> with(ClassLoaderDecorator.Factory classLoaderDecoratorFactory)

Defines a factory that decorates a given class loader prior to class loading. Note that this cannot be used with injection.

Specified by:

with in interface ClassLoadingStrategy.Configurable<ClassLoader>

Parameters:

classLoaderDecoratorFactory - The class loader decorator factory to use.

Returns:

A version of this class loading strategy that applies the supplied class loader decorator factory.

allowExistingTypes

public ClassLoadingStrategy.Configurable<ClassLoader> allowExistingTypes()

Determines if this class loading strategy should not throw an exception when attempting to load a class that was already loaded. In this case, the already loaded class is used instead of the generated class.

Specified by:

allowExistingTypes in interface ClassLoadingStrategy.Configurable<ClassLoader>

Returns:

A version of this class loading strategy that does not throw an exception when a class is already loaded.

opened

public ClassLoadingStrategy.Configurable<ClassLoader> opened()

With an opened class loading strategy, it is assured that types can be added to the class loader, either by indirect injection using this strategy or by creating a class loader that explicitly supports injection.

Specified by:

opened in interface ClassLoadingStrategy.Configurable<ClassLoader>

Returns:

A version of this class loading strategy that opens for future injections into a class loader.