net.lenni0451.commons.asm.provider.instrumentation

Class InstrumentationLoaderClassProvider

java.lang.Object

net.lenni0451.commons.asm.provider.instrumentation.InstrumentationLoaderClassProvider

All Implemented Interfaces:

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

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

A class provider that uses an Instrumentation instance to collect all class loaders to provide classes.
This provider delegates to LoaderClassProvider instances for each found class loader.
If a class loader has not been used before yet, this provider will not be able to provide classes from it until the class loader is used at least once.

See Also:

LoaderClassProvider

Nested Class Summary

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

ClassProvider.ClassSupplier

Constructor Summary

Constructors

Constructor and Description
InstrumentationLoaderClassProvider(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.
byte[]	getClass(java.lang.String name) Get the bytecode of a class by its name.
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

InstrumentationLoaderClassProvider

public InstrumentationLoaderClassProvider(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()
           throws java.lang.Exception

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

Throws:

java.lang.Exception - If an error occurred while closing the class provider

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