org.springframework.instrument.classloading

类 ReflectiveLoadTimeWeaver

java.lang.Object

org.springframework.instrument.classloading.ReflectiveLoadTimeWeaver

所有已实现的接口:

LoadTimeWeaver

public class ReflectiveLoadTimeWeaver
extends Object
implements LoadTimeWeaver

LoadTimeWeaver which uses reflection to delegate to an underlying ClassLoader with well-known transformation hooks. The underlying ClassLoader is expected to support the following weaving methods (as defined in the LoadTimeWeaver interface):

• public void addTransformer(java.lang.instrument.ClassFileTransformer): for registering the given ClassFileTransformer on this ClassLoader
• public ClassLoader getThrowawayClassLoader(): for obtaining a throwaway class loader for this ClassLoader (optional; ReflectiveLoadTimeWeaver will fall back to a SimpleThrowawayClassLoader if that method isn't available)

Please note that the above methods must reside in a class that is publicly accessible, although the class itself does not have to be visible to the application's class loader.

The reflective nature of this LoadTimeWeaver is particularly useful when the underlying ClassLoader implementation is loaded in a different class loader itself (such as the application server's class loader which is not visible to the web application). There is no direct API dependency between this LoadTimeWeaver adapter and the underlying ClassLoader, just a 'loose' method contract.

This is the LoadTimeWeaver to use e.g. with the Resin application server version 3.1+.

从以下版本开始:

2.0

作者:

Costin Leau, Juergen Hoeller

另请参阅:

addTransformer(java.lang.instrument.ClassFileTransformer), getThrowawayClassLoader(), SimpleThrowawayClassLoader

构造器概要

构造器

构造器和说明
ReflectiveLoadTimeWeaver() Create a new ReflectiveLoadTimeWeaver for the current context class loader, which needs to support the required weaving methods.
ReflectiveLoadTimeWeaver(ClassLoader classLoader) Create a new SimpleLoadTimeWeaver for the given class loader.

方法概要

限定符和类型	方法和说明
void	addTransformer(ClassFileTransformer transformer) Add a ClassFileTransformer to be applied by this LoadTimeWeaver.
ClassLoader	getInstrumentableClassLoader() Return a ClassLoader that supports instrumentation through AspectJ-style load-time weaving based on user-defined ClassFileTransformers.
ClassLoader	getThrowawayClassLoader() Return a throwaway ClassLoader, enabling classes to be loaded and inspected without affecting the parent ClassLoader.

从类继承的方法 java.lang.Object

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

构造器详细资料

ReflectiveLoadTimeWeaver

public ReflectiveLoadTimeWeaver()

Create a new ReflectiveLoadTimeWeaver for the current context class loader, which needs to support the required weaving methods.

ReflectiveLoadTimeWeaver

public ReflectiveLoadTimeWeaver(@Nullable
                                ClassLoader classLoader)

Create a new SimpleLoadTimeWeaver for the given class loader.

参数:

classLoader - the ClassLoader to delegate to for weaving (must support the required weaving methods).

抛出:

IllegalStateException - if the supplied ClassLoader does not support the required weaving methods

方法详细资料

addTransformer

public void addTransformer(ClassFileTransformer transformer)

从接口复制的说明: LoadTimeWeaver

Add a ClassFileTransformer to be applied by this LoadTimeWeaver.

指定者:

addTransformer 在接口中 LoadTimeWeaver

参数:

transformer - the ClassFileTransformer to add

getInstrumentableClassLoader

public ClassLoader getInstrumentableClassLoader()

从接口复制的说明: LoadTimeWeaver

Return a ClassLoader that supports instrumentation through AspectJ-style load-time weaving based on user-defined ClassFileTransformers.

May be the current ClassLoader, or a ClassLoader created by this LoadTimeWeaver instance.

指定者:

getInstrumentableClassLoader 在接口中 LoadTimeWeaver

返回:

the ClassLoader which will expose instrumented classes according to the registered transformers

getThrowawayClassLoader

public ClassLoader getThrowawayClassLoader()

从接口复制的说明: LoadTimeWeaver

Return a throwaway ClassLoader, enabling classes to be loaded and inspected without affecting the parent ClassLoader.

Should not return the same instance of the ClassLoader returned from an invocation of LoadTimeWeaver.getInstrumentableClassLoader().

指定者:

getThrowawayClassLoader 在接口中 LoadTimeWeaver

返回:

a temporary throwaway ClassLoader; should return a new instance for each call, with no existing state