org.springframework.instrument.classloading.tomcat

Class TomcatLoadTimeWeaver

java.lang.Object

org.springframework.instrument.classloading.tomcat.TomcatLoadTimeWeaver

All Implemented Interfaces:

LoadTimeWeaver

public class TomcatLoadTimeWeaver
extends java.lang.Object
implements LoadTimeWeaver

LoadTimeWeaver implementation for Tomcat's new InstrumentableClassLoader. Also capable of handling Spring's TomcatInstrumentableClassLoader when encountered.

Since:

4.0

Author:

Juergen Hoeller

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.reflect.Method	addTransformerMethod
private java.lang.ClassLoader	classLoader
private java.lang.reflect.Method	copyMethod
private static java.lang.String	INSTRUMENTABLE_LOADER_CLASS_NAME

Constructor Summary

Constructors

Constructor and Description
TomcatLoadTimeWeaver()
TomcatLoadTimeWeaver(java.lang.ClassLoader classLoader)

Method Summary

Modifier and Type	Method and Description
void	addTransformer(java.lang.instrument.ClassFileTransformer transformer) Add a ClassFileTransformer to be applied by this LoadTimeWeaver.
java.lang.ClassLoader	getInstrumentableClassLoader() Return a ClassLoader that supports instrumentation through AspectJ-style load-time weaving based on user-defined ClassFileTransformers.
java.lang.ClassLoader	getThrowawayClassLoader() Return a throwaway ClassLoader, enabling classes to be loaded and inspected without affecting the parent ClassLoader.

Methods inherited from class java.lang.Object

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

Field Detail

INSTRUMENTABLE_LOADER_CLASS_NAME

private static final java.lang.String INSTRUMENTABLE_LOADER_CLASS_NAME

See Also:

Constant Field Values

classLoader

private final java.lang.ClassLoader classLoader

addTransformerMethod

private final java.lang.reflect.Method addTransformerMethod

copyMethod

private final java.lang.reflect.Method copyMethod

Constructor Detail

TomcatLoadTimeWeaver

public TomcatLoadTimeWeaver()

TomcatLoadTimeWeaver

public TomcatLoadTimeWeaver(java.lang.ClassLoader classLoader)

Method Detail

addTransformer

public void addTransformer(java.lang.instrument.ClassFileTransformer transformer)

Description copied from interface: LoadTimeWeaver

Add a ClassFileTransformer to be applied by this LoadTimeWeaver.

Specified by:

addTransformer in interface LoadTimeWeaver

Parameters:

transformer - the ClassFileTransformer to add

getInstrumentableClassLoader

public java.lang.ClassLoader getInstrumentableClassLoader()

Description copied from interface: 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.

Specified by:

getInstrumentableClassLoader in interface LoadTimeWeaver

Returns:

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

getThrowawayClassLoader

public java.lang.ClassLoader getThrowawayClassLoader()

Description copied from interface: 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().

Specified by:

getThrowawayClassLoader in interface LoadTimeWeaver

Returns:

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