net.lenni0451.commons.asm.provider.instrumentation

Class InstrumentationCacheClassProvider

java.lang.Object

net.lenni0451.commons.asm.provider.instrumentation.InstrumentationCacheClassProvider

All Implemented Interfaces:

java.lang.AutoCloseable, java.lang.instrument.ClassFileTransformer, ClassProvider

public class InstrumentationCacheClassProvider
extends java.lang.Object
implements ClassProvider, java.lang.instrument.ClassFileTransformer

A class provider that uses an Instrumentation instance to cache all loaded classes.
The caching operation is slow and memory consuming, since the bytecode of all loaded classes is stored in memory.
This provider can't provide classes that have not been loaded yet. It is recommended to chain another class provider after this one.

Nested Class Summary

Nested classes/interfaces inherited from interface net.lenni0451.commons.asm.provider.ClassProvider

ClassProvider.ClassSupplier

Constructor Summary

Constructors

Constructor and Description
InstrumentationCacheClassProvider(java.lang.instrument.Instrumentation instrumentation)

Method Summary

Modifier and Type	Method and Description
void	close() Close the class provider and free all resources.
java.util.Map<java.lang.String,ClassProvider.ClassSupplier>	getAllClasses() Get a map of all classes that are available in this provider. Not every implementation has to support this and can throw an UnsupportedOperationException if it is not supported. The key format is "package/Name".
byte[]	getClass(java.lang.String name) Get the bytecode of a class by its name. The name should be in the format of "package/Name". If the class could not be found, a ClassNotFoundException is thrown.
byte[]	transform(java.lang.ClassLoader loader, java.lang.String className, java.lang.Class<?> classBeingRedefined, java.security.ProtectionDomain protectionDomain, byte[] classfileBuffer)

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.lenni0451.commons.asm.provider.ClassProvider

getClassNode, then

Constructor Detail

InstrumentationCacheClassProvider

public InstrumentationCacheClassProvider(java.lang.instrument.Instrumentation instrumentation)

Method Detail

getClass

@Nonnull
public byte[] getClass(java.lang.String name)
                         throws java.lang.ClassNotFoundException

Description copied from interface: ClassProvider

Get the bytecode of a class by its name.
The name should be in the format of "package/Name".
If the class could not be found, a ClassNotFoundException is thrown.

Specified by:

getClass in interface ClassProvider

Parameters:

name - The name of the class

Returns:

The bytecode of the class

Throws:

java.lang.ClassNotFoundException - If the class could not be found

getAllClasses

@Nonnull
public java.util.Map<java.lang.String,ClassProvider.ClassSupplier> getAllClasses()
                                                                                   throws java.lang.UnsupportedOperationException

Description copied from interface: ClassProvider

Get a map of all classes that are available in this provider.
Not every implementation has to support this and can throw an UnsupportedOperationException if it is not supported.
The key format is "package/Name".

Specified by:

getAllClasses in interface ClassProvider

Returns:

A map of all classes

Throws:

java.lang.UnsupportedOperationException - If this operation is not supported

close

public void close()

Description copied from interface: ClassProvider

Close the class provider and free all resources.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface ClassProvider

transform

public byte[] transform(java.lang.ClassLoader loader,
                        java.lang.String className,
                        java.lang.Class<?> classBeingRedefined,
                        java.security.ProtectionDomain protectionDomain,
                        byte[] classfileBuffer)

Specified by:

transform in interface java.lang.instrument.ClassFileTransformer