net.bytebuddy.dynamic.loading

Class ClassInjector.UsingUnsafe

java.lang.Object

net.bytebuddy.dynamic.loading.ClassInjector.AbstractBase

net.bytebuddy.dynamic.loading.ClassInjector.UsingUnsafe

All Implemented Interfaces:

ClassInjector

Enclosing interface:

ClassInjector

@HashCodeAndEqualsPlugin.Enhance
public static class ClassInjector.UsingUnsafe
extends ClassInjector.AbstractBase

A class injector that uses sun.misc.Unsafe to inject classes.

Important: This strategy is no longer available after Java 11.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	ClassInjector.UsingUnsafe.Dispatcher A dispatcher for using sun.misc.Unsafe.

Nested classes/interfaces inherited from interface net.bytebuddy.dynamic.loading.ClassInjector

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

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.Object	BOOTSTRAP_LOADER_LOCK A lock for the bootstrap loader when injecting code.
private java.lang.ClassLoader	classLoader The class loader to inject classes into or null for the bootstrap loader.
private static ClassInjector.UsingUnsafe.Dispatcher.Initializable	DISPATCHER The dispatcher to use.
private java.security.ProtectionDomain	protectionDomain The protection domain to use or null for no protection domain.
static java.lang.String	SAFE_PROPERTY If this property is set, Byte Buddy does not make use of any Unsafe class.

Fields inherited from interface net.bytebuddy.dynamic.loading.ClassInjector

ALLOW_EXISTING_TYPES, SUPPRESS_ACCESS_CHECKS

Constructor Summary

Constructors

Constructor and Description
UsingUnsafe(java.lang.ClassLoader classLoader) Creates a new unsafe injector for the given class loader with a default protection domain.
UsingUnsafe(java.lang.ClassLoader classLoader, java.security.ProtectionDomain protectionDomain) Creates a new unsafe injector for the given class loader with a default protection domain.

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.String,java.lang.Class<?>>	injectRaw(java.util.Map<? extends java.lang.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.
static boolean	isAvailable() Checks if unsafe class injection is available on the current VM.
static ClassInjector	ofBootLoader() Returns an unsafe class injector for the boot class loader.
static ClassInjector	ofPlatformLoader() Returns an unsafe class injector for the platform class loader.
static ClassInjector	ofSystemLoader() Returns an unsafe class injector for the system class loader.

Methods inherited from class net.bytebuddy.dynamic.loading.ClassInjector.AbstractBase

inject

Methods inherited from class java.lang.Object

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

Field Detail

SAFE_PROPERTY

public static final java.lang.String SAFE_PROPERTY

If this property is set, Byte Buddy does not make use of any Unsafe class.

See Also:

Constant Field Values

DISPATCHER

private static final ClassInjector.UsingUnsafe.Dispatcher.Initializable DISPATCHER

The dispatcher to use.

BOOTSTRAP_LOADER_LOCK

private static final java.lang.Object BOOTSTRAP_LOADER_LOCK

A lock for the bootstrap loader when injecting code.

classLoader

@HashCodeAndEqualsPlugin.ValueHandling(value=REVERSE_NULLABILITY)
private final java.lang.ClassLoader classLoader

The class loader to inject classes into or null for the bootstrap loader.

protectionDomain

@HashCodeAndEqualsPlugin.ValueHandling(value=REVERSE_NULLABILITY)
private final java.security.ProtectionDomain protectionDomain

The protection domain to use or null for no protection domain.

Constructor Detail

UsingUnsafe

public UsingUnsafe(java.lang.ClassLoader classLoader)

Creates a new unsafe injector for the given class loader with a default protection domain.

Parameters:

classLoader - The class loader to inject classes into or null for the bootstrap loader.

UsingUnsafe

public UsingUnsafe(java.lang.ClassLoader classLoader,
                   java.security.ProtectionDomain protectionDomain)

Creates a new unsafe injector for the given class loader with a default protection domain.

Parameters:

classLoader - The class loader to inject classes into or null for the bootstrap loader.

protectionDomain - The protection domain to use or null for no protection domain.

Method Detail

isAlive

public boolean isAlive()

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

Returns:

true if this injector is available on the current VM.

injectRaw

public java.util.Map<java.lang.String,java.lang.Class<?>> injectRaw(java.util.Map<? extends java.lang.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.

isAvailable

public static boolean isAvailable()

Checks if unsafe class injection is available on the current VM.

Returns:

true if unsafe class injection is available on the current VM.

ofSystemLoader

public static ClassInjector ofSystemLoader()

Returns an unsafe class injector for the system class loader.

Returns:

A class injector for the system class loader.

ofPlatformLoader

public static ClassInjector ofPlatformLoader()

Returns an unsafe class injector for the platform class loader. For VMs of version 8 or older, the extension class loader is represented instead.

Returns:

A class injector for the platform class loader.

ofBootLoader

public static ClassInjector ofBootLoader()

Returns an unsafe class injector for the boot class loader.

Returns:

A class injector for the boot loader.