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

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

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static interface	ClassInjector.UsingUnsafe.Dispatcher	A dispatcher for using sun.misc.Unsafe or jdk.internal.misc.Unsafe.
static class	ClassInjector.UsingUnsafe.Factory	A factory for creating a ClassInjector that uses sun.misc.Unsafe if available but attempts a fallback to using jdk.internal.misc.Unsafe if the jdk.internal module is not resolved or unavailable.
protected static interface	ClassInjector.UsingUnsafe.System	A proxy of java.lang.System.

Nested classes/interfaces inherited from interface ClassInjector

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

Field Summary

Fields

Modifier and Type	Field	Description
private static final Object	BOOTSTRAP_LOADER_LOCK	A lock for the bootstrap loader when injecting.
private static final Method	CHECK_PERMISSION	The java.lang.SecurityManager#checkPermission method or null if not available.
private final ClassLoader	classLoader	The class loader to inject classes into or null for the bootstrap loader.
private final ClassInjector.UsingUnsafe.Dispatcher.Initializable	dispatcher	The dispatcher to use.
private static final ClassInjector.UsingUnsafe.Dispatcher.Initializable	DISPATCHER	The dispatcher to use.
private final ProtectionDomain	protectionDomain	The protection domain to use or null for no protection domain.
static final String	SAFE_PROPERTY	If this property is set, Byte Buddy does not make use of any Unsafe class.
private static final ClassInjector.UsingUnsafe.System	SYSTEM	A proxy for java.lang.System to access the security manager if available.

Fields inherited from class ClassInjector.AbstractBase

SUPPRESS_ACCESS_CHECKS

Fields inherited from interface ClassInjector

ALLOW_EXISTING_TYPES

Constructor Summary

Constructors

Modifier	Constructor	Description
	UsingUnsafe(ClassLoader classLoader)	Creates a new unsafe injector for the given class loader with a default protection domain.
	UsingUnsafe(ClassLoader classLoader, ProtectionDomain protectionDomain)	Creates a new unsafe injector for the given class loader with a default protection domain.
protected	UsingUnsafe(ClassLoader classLoader, ProtectionDomain protectionDomain, ClassInjector.UsingUnsafe.Dispatcher.Initializable dispatcher)	Creates a new unsafe injector for the given class loader with a default protection domain.

Method Summary

Modifier and Type	Method	Description
private static <T> T	doPrivileged(PrivilegedAction<T> action)	A proxy for java.security.AccessController#doPrivileged that is activated if available.
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.
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 ClassInjector.AbstractBase

inject, inject, injectRaw

Methods inherited from class Object

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

Field Details

SAFE_PROPERTY

public static final 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.

SYSTEM

private static final ClassInjector.UsingUnsafe.System SYSTEM

A proxy for java.lang.System to access the security manager if available.

CHECK_PERMISSION

private static final Method CHECK_PERMISSION

The java.lang.SecurityManager#checkPermission method or null if not available.

BOOTSTRAP_LOADER_LOCK

private static final Object BOOTSTRAP_LOADER_LOCK

A lock for the bootstrap loader when injecting.

classLoader

@MaybeNull
@ValueHandling(REVERSE_NULLABILITY)
private final ClassLoader classLoader

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

protectionDomain

@MaybeNull
@ValueHandling(REVERSE_NULLABILITY)
private final ProtectionDomain protectionDomain

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

dispatcher

private final ClassInjector.UsingUnsafe.Dispatcher.Initializable dispatcher

The dispatcher to use.

Constructor Details

UsingUnsafe

public UsingUnsafe(@MaybeNull
 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(@MaybeNull
 ClassLoader classLoader,
 @MaybeNull
 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.

UsingUnsafe

protected UsingUnsafe(@MaybeNull
 ClassLoader classLoader,
 @MaybeNull
 ProtectionDomain protectionDomain,
 ClassInjector.UsingUnsafe.Dispatcher.Initializable dispatcher)

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.

dispatcher - The dispatcher to use.

Method Details

doPrivileged

@Enhance
private static <T> T doPrivileged(PrivilegedAction<T> action)

A proxy for java.security.AccessController#doPrivileged that is activated if available.

Type Parameters:

T - The type of the action's resolved value.

Parameters:

action - The action to execute from a privileged context.

Returns:

The action's resolved value.

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 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.

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.