net.bytebuddy.dynamic.loading

public Interface ClassInjector

Known Direct Implementers: net.bytebuddy.dynamic.loading.ClassInjector.AbstractBase
Imports: com.sun.jna.*, edu.umd.cs.findbugs.annotations.SuppressFBWarnings, net.bytebuddy.ByteBuddy, .ClassFileVersion, net.bytebuddy.asm.MemberRemoval, net.bytebuddy.build.AccessControllerPlugin, .HashCodeAndEqualsPlugin, net.bytebuddy.description.modifier.Visibility, net.bytebuddy.description.type.PackageDescription, .TypeDescription, net.bytebuddy.dynamic.DynamicType, net.bytebuddy.dynamic.scaffold.TypeValidation, net.bytebuddy.dynamic.scaffold.subclass.ConstructorStrategy, net.bytebuddy.implementation.FixedValue, .MethodCall, net.bytebuddy.utility.GraalImageCode, .JavaModule, .JavaType, .RandomString, net.bytebuddy.utility.dispatcher.JavaDispatcher, net.bytebuddy.utility.nullability.AlwaysNull, .MaybeNull, .UnknownNull, net.bytebuddy.utility.privilege.GetMethodAction, java.io.File, .FileOutputStream, .IOException, java.lang.instrument.Instrumentation, java.lang.reflect.*, java.net.URL, java.security.Permission, .PrivilegedAction, .ProtectionDomain, java.util.*, java.util.jar.JarEntry, .JarFile, .JarOutputStream

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

Important Note

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 and Inner Type Summary

Modifier and Type	Class and Description
public abstract static class	ClassInjector.AbstractBase An abstract base implementation of a class injector.
public static class	ClassInjector.UsingInstrumentation A class injector using a `java.lang.instrument.Instrumentation` to append to either the boot classpath or the system class path.
public static class	ClassInjector.UsingJna A class injector using JNA to invoke JNI's define class utility for defining a class.
public static class	ClassInjector.UsingLookup A class injector that uses a `java.lang.invoke.MethodHandles$Lookup` object for defining a class.
public static class	ClassInjector.UsingReflection A class injector that uses reflective method calls.
public static class	ClassInjector.UsingUnsafe A class injector that uses `sun.misc.Unsafe` or `jdk.internal.misc.Unsafe` to inject classes.

Field Summary

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

Method Summary

Modifier and Type	Method and Description
public Map<TypeDescription, Class<?>>	Returns: The loaded types that were passed as arguments. inject(Map<? extends TypeDescription, byte[]> The types to load via injection. types) Injects the given types into the represented class loader.
public Map<String, Class<?>>	Returns: The loaded types that were passed as arguments. injectRaw(Map<? extends String, byte[]> The types to load via injection. types) Injects the given types into the represented class loader using a mapping from name to binary representation.
public boolean	Returns: `true` if this injector is available on the current VM. isAlive() Indicates if this class injector is available on the current VM.