Class ClassInjector.UsingInstrumentation

java.lang.Object

net.bytebuddy.dynamic.loading.ClassInjector.AbstractBase

net.bytebuddy.dynamic.loading.ClassInjector.UsingInstrumentation

All Implemented Interfaces:

ClassInjector

Enclosing interface:

ClassInjector

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

A class injector using a Instrumentation to append to either the boot classpath or the system class path.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static interface	ClassInjector.UsingInstrumentation.Dispatcher	A dispatcher to interact with the instrumentation API.
static enum	ClassInjector.UsingInstrumentation.Target	A representation of the target to which Java classes should be appended to.

Nested classes/interfaces inherited from interface ClassInjector

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

Field Summary

Fields inherited from class ClassInjector.AbstractBase

SUPPRESS_ACCESS_CHECKS

Fields inherited from interface ClassInjector

ALLOW_EXISTING_TYPES

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	UsingInstrumentation(File folder, ClassInjector.UsingInstrumentation.Target target, Instrumentation instrumentation, RandomString randomString)	Creates an instrumentation-based class injector.

Method Summary

Modifier and Type	Method	Description
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()	Returns true if this class injector is available on this VM.
static ClassInjector	of(File folder, ClassInjector.UsingInstrumentation.Target target, Instrumentation instrumentation)	Creates an instrumentation-based class injector.
static void	redefineModule(Instrumentation instrumentation, JavaModule target, Set<JavaModule> reads, Map<String, Set<JavaModule>> exports, Map<String, Set<JavaModule>> opens, Set<Class<?>> uses, Map<Class<?>, List<Class<?>>> provides)	Modifies a module's properties using Instrumentation.

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

Constructor Details

UsingInstrumentation

protected UsingInstrumentation(File folder,
 ClassInjector.UsingInstrumentation.Target target,
 Instrumentation instrumentation,
 RandomString randomString)

Creates an instrumentation-based class injector.

Parameters:

folder - The folder to be used for storing jar files.

target - A representation of the target path to which classes are to be appended.

instrumentation - The instrumentation to use for appending to the class path or the boot path.

randomString - The random string generator to use.

Method Details

redefineModule

public static void redefineModule(Instrumentation instrumentation,
 JavaModule target,
 Set<JavaModule> reads,
 Map<String, Set<JavaModule>> exports,
 Map<String, Set<JavaModule>> opens,
 Set<Class<?>> uses,
 Map<Class<?>, List<Class<?>>> provides)

Modifies a module's properties using Instrumentation.

Parameters:

instrumentation - The Instrumentation instance to use for applying the modification.

target - The target module that should be modified.

reads - A set of additional modules this module should read.

exports - A map of packages to export to a set of modules.

opens - A map of packages to open to a set of modules.

uses - A set of provider interfaces to use by this module.

provides - A map of provider interfaces to provide by this module mapped to the provider implementations.

of

public static ClassInjector of(File folder,
 ClassInjector.UsingInstrumentation.Target target,
 Instrumentation instrumentation)

Creates an instrumentation-based class injector.

Parameters:

folder - The folder to be used for storing jar files.

target - A representation of the target path to which classes are to be appended.

instrumentation - The instrumentation to use for appending to the class path or the boot path.

Returns:

An appropriate class injector that applies instrumentation.

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()

Returns true if this class injector is available on this VM.

Returns:

true if this class injector is available on this VM.