Interface ClassInjector

All Known Implementing Classes:

ClassInjector.AbstractBase, ClassInjector.UsingInstrumentation, ClassInjector.UsingJna, 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 java.lang.SecurityManager, the user of this injector is responsible for providing access to non-public properties.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	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.UsingJna	A class injector using JNA to invoke JNI's define class utility for defining a class.
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 or jdk.internal.misc.Unsafe to inject classes.

Field Summary

Fields

Modifier and Type	Field	Description
static final boolean	ALLOW_EXISTING_TYPES	Determines the default behavior for type injections when a type is already loaded.

Method Summary

Modifier and Type	Method	Description
Map<TypeDescription, Class<?>>	inject(Map<? extends TypeDescription, byte[]> types)	Injects the given types into the represented class loader.
Map<TypeDescription, Class<?>>	inject(Set<? extends TypeDescription> types, ClassFileLocator classFileLocator)	Injects the given types into the represented class loader.
Map<String,Class<?>>	injectRaw(Map<String,byte[]> types)	Injects the given types into the represented class loader.
Map<String,Class<?>>	injectRaw(Set<String> names, ClassFileLocator classFileLocator)	Injects the given types into the represented class loader.
boolean	isAlive()	Indicates if this class injector is available on the current VM.

Field Details

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 Details

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(Set<? extends TypeDescription> types,
 ClassFileLocator classFileLocator)

Injects the given types into the represented class loader.

Parameters:

types - The types to load via injection.

classFileLocator - The class file locator to use for resolving binary representations.

Returns:

The loaded types that were passed as arguments.

injectRaw

Map<String,Class<?>> injectRaw(Set<String> names,
 ClassFileLocator classFileLocator)

Injects the given types into the represented class loader.

Parameters:

names - The names of the types to load via injection.

classFileLocator - The class file locator to use for resolving binary representations.

Returns:

The loaded types that were passed as arguments.

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<String,byte[]> types)

Injects the given types into the represented class loader.

Parameters:

types - The names of the type to load via injection.

Returns:

The loaded types that were passed as arguments.