Package net.bytebuddy.dynamic.loading
Class ClassLoadingStrategy.Default.WrappingDispatcher
java.lang.Object
net.bytebuddy.dynamic.loading.ClassLoadingStrategy.Default.WrappingDispatcher
- All Implemented Interfaces:
ClassLoadingStrategy<ClassLoader>
,ClassLoadingStrategy.Configurable<ClassLoader>
- Enclosing class:
- ClassLoadingStrategy.Default
@Enhance
protected static class ClassLoadingStrategy.Default.WrappingDispatcher
extends Object
implements ClassLoadingStrategy.Configurable<ClassLoader>
A class loading strategy which creates a wrapping class loader while applying a given
ProtectionDomain
on class loading.-
Nested Class Summary
Nested classes/interfaces inherited from interface net.bytebuddy.dynamic.loading.ClassLoadingStrategy
ClassLoadingStrategy.Configurable<S extends ClassLoader>, ClassLoadingStrategy.Default, ClassLoadingStrategy.ForBootstrapInjection, ClassLoadingStrategy.ForJnaInjection, ClassLoadingStrategy.ForUnsafeInjection, ClassLoadingStrategy.UsingLookup
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final boolean
Indicates that a child first loading strategy should be attempted.private final boolean
true
if the created class loader should apply child-first semantics.private final boolean
Determines if an exception should be thrown when attempting to load a type that already exists.private final PackageDefinitionStrategy
The package definer to be used for querying information on package information.private static final boolean
Indicates that a parent first loading strategy should be attempted.private final ByteArrayClassLoader.PersistenceHandler
The persistence handler to apply.private final ProtectionDomain
The protection domain to apply ornull
if no protection domain is set.private final boolean
true
if the class loader should be sealed.Fields inherited from interface net.bytebuddy.dynamic.loading.ClassLoadingStrategy
BOOTSTRAP_LOADER, NO_PROTECTION_DOMAIN
-
Constructor Summary
ConstructorsModifierConstructorDescriptionprivate
WrappingDispatcher
(ProtectionDomain protectionDomain, PackageDefinitionStrategy packageDefinitionStrategy, ByteArrayClassLoader.PersistenceHandler persistenceHandler, boolean childFirst, boolean forbidExisting, boolean sealed) Creates a new protection domain specific class loading wrapper.protected
WrappingDispatcher
(ByteArrayClassLoader.PersistenceHandler persistenceHandler, boolean childFirst) Creates a new wrapping dispatcher with a default protection domain and a default access control context. -
Method Summary
Modifier and TypeMethodDescriptionDetermines 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.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.with
(ProtectionDomain protectionDomain) Overrides the implicitly set defaultProtectionDomain
with an explicit one.with
(PackageDefinitionStrategy packageDefinitionStrategy) Defines the supplied package definition strategy to be used for defining packages.
-
Field Details
-
CHILD_FIRST
private static final boolean CHILD_FIRSTIndicates that a child first loading strategy should be attempted.- See Also:
-
PARENT_FIRST
private static final boolean PARENT_FIRSTIndicates that a parent first loading strategy should be attempted.- See Also:
-
protectionDomain
The protection domain to apply ornull
if no protection domain is set. -
persistenceHandler
The persistence handler to apply. -
packageDefinitionStrategy
The package definer to be used for querying information on package information. -
childFirst
private final boolean childFirsttrue
if the created class loader should apply child-first semantics. -
forbidExisting
private final boolean forbidExistingDetermines if an exception should be thrown when attempting to load a type that already exists. -
sealed
private final boolean sealedtrue
if the class loader should be sealed.
-
-
Constructor Details
-
WrappingDispatcher
protected WrappingDispatcher(ByteArrayClassLoader.PersistenceHandler persistenceHandler, boolean childFirst) Creates a new wrapping dispatcher with a default protection domain and a default access control context.- Parameters:
persistenceHandler
- The persistence handler to apply.childFirst
-true
if the created class loader should apply child-first semantics.
-
WrappingDispatcher
private WrappingDispatcher(@MaybeNull ProtectionDomain protectionDomain, PackageDefinitionStrategy packageDefinitionStrategy, ByteArrayClassLoader.PersistenceHandler persistenceHandler, boolean childFirst, boolean forbidExisting, boolean sealed) Creates a new protection domain specific class loading wrapper.- Parameters:
protectionDomain
- The protection domain to apply ornull
if no protection domain is set.packageDefinitionStrategy
- The package definer to be used for querying information on package information.persistenceHandler
- The persistence handler to apply.childFirst
-true
if the created class loader should apply child-first semantics.forbidExisting
- Determines if an exception should be thrown when attempting to load a type that already exists.sealed
-true
if the class loader should be sealed.
-
-
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 interfaceClassLoadingStrategy<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
Overrides the implicitly set defaultProtectionDomain
with an explicit one.- Specified by:
with
in interfaceClassLoadingStrategy.Configurable<ClassLoader>
- Parameters:
protectionDomain
- The protection domain to apply ornull
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 interfaceClassLoadingStrategy.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.
-
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 interfaceClassLoadingStrategy.Configurable<ClassLoader>
- Returns:
- A version of this class loading strategy that does not throw an exception when a class is already loaded.
-
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 interfaceClassLoadingStrategy.Configurable<ClassLoader>
- Returns:
- A version of this class loading strategy that opens for future injections into a class loader.
-