net.bytebuddy.dynamic.loading

Interface ClassInjector

All Known Implementing Classes:

ClassInjector.AbstractBase, ClassInjector.UsingInstrumentation, ClassInjector.UsingLookup, ClassInjector.UsingReflection, ClassInjector.UsingUnsafe

public interface ClassInjector

A class injector is capable of injecting classes into a ClassLoader without requiring the class loader to being able to explicitly look up these classes.

Important: Byte Buddy does not supply privileges when injecting code. When using a SecurityManager, the user of this injector is responsible for providing access to non-public properties.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ClassInjector.AbstractBase An abstract base implementation of a class injector.
static class	ClassInjector.UsingInstrumentation A class injector using a Instrumentation to append to either the boot classpath or the system class path.
static class	ClassInjector.UsingLookup A class injector that uses a java.lang.invoke.MethodHandles$Lookup object for defining a class.
static class	ClassInjector.UsingReflection A class injector that uses reflective method calls.
static class	ClassInjector.UsingUnsafe A class injector that uses sun.misc.Unsafe to inject classes.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	ALLOW_EXISTING_TYPES Determines the default behavior for type injections when a type is already loaded.
static Permission	SUPPRESS_ACCESS_CHECKS A permission for the suppressAccessChecks permission.

Method Summary

Modifier and Type	Method and Description
Map<TypeDescription,Class<?>>	inject(Map<? extends TypeDescription,byte[]> types) Injects the given types into the represented class loader.
Map<String,Class<?>>	injectRaw(Map<? extends String,byte[]> types) Injects the given types into the represented class loader using a mapping from name to binary representation.
boolean	isAlive() Indicates if this class injector is available on the current VM.

Field Detail

SUPPRESS_ACCESS_CHECKS

static final Permission SUPPRESS_ACCESS_CHECKS

A permission for the suppressAccessChecks permission.

ALLOW_EXISTING_TYPES

static final boolean ALLOW_EXISTING_TYPES

Determines the default behavior for type injections when a type is already loaded.

See Also:

Constant Field Values

Method Detail

isAlive

boolean isAlive()

Indicates if this class injector is available on the current VM.

Returns:

true if this injector is available on the current VM.

inject

Map<TypeDescription,Class<?>> inject(Map<? extends TypeDescription,byte[]> types)

Injects the given types into the represented class loader.

Parameters:

types - The types to load via injection.

Returns:

The loaded types that were passed as arguments.

injectRaw

Map<String,Class<?>> injectRaw(Map<? extends String,byte[]> types)

Injects the given types into the represented class loader using a mapping from name to binary representation.

Parameters:

types - The types to load via injection.

Returns:

The loaded types that were passed as arguments.