net.bytebuddy.dynamic.loading

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

@HashCodeAndEqualsPlugin.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 and Description
protected static interface	ClassInjector.UsingInstrumentation.Dispatcher A dispatcher to interact with the instrumentation API.
static class	ClassInjector.UsingInstrumentation.Target A representation of the target to which Java classes should be appended to.

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

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

Field Summary

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

ALLOW_EXISTING_TYPES, SUPPRESS_ACCESS_CHECKS

Constructor Summary

Constructors

Modifier	Constructor and 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 and 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 net.bytebuddy.dynamic.loading.ClassInjector.AbstractBase

inject, inject, injectRaw

Methods inherited from class java.lang.Object

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

Constructor Detail

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 Detail

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.