org.springframework.instrument.classloading.jboss
Class JBossLoadTimeWeaver

java.lang.Object
  extended by org.springframework.instrument.classloading.jboss.JBossLoadTimeWeaver
All Implemented Interfaces:
LoadTimeWeaver

public class JBossLoadTimeWeaver
extends Object
implements LoadTimeWeaver

LoadTimeWeaver implementation for JBoss's instrumentable ClassLoader. Autodetects the specific JBoss version at runtime: currently supports JBoss AS 5, 6 and 7 (as of Spring 3.1).

NOTE: On JBoss 6.0, to avoid the container loading the classes before the application actually starts, one needs to add a WEB-INF/jboss-scanning.xml file to the application archive - with the following content:

<scanning xmlns="urn:jboss:scanning:1.0"/>

Thanks to Ales Justin and Marius Bogoevici for the initial prototype.

Since:
3.0
Author:
Costin Leau

Constructor Summary
JBossLoadTimeWeaver()
          Create a new instance of the JBossLoadTimeWeaver class using the default class loader.
JBossLoadTimeWeaver(ClassLoader classLoader)
          Create a new instance of the JBossLoadTimeWeaver class using the supplied ClassLoader.
 
Method Summary
 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.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

JBossLoadTimeWeaver

public JBossLoadTimeWeaver()
Create a new instance of the JBossLoadTimeWeaver class using the default class loader.

See Also:
ClassUtils.getDefaultClassLoader()

JBossLoadTimeWeaver

public JBossLoadTimeWeaver(ClassLoader classLoader)
Create a new instance of the JBossLoadTimeWeaver class using the supplied ClassLoader.

Parameters:
classLoader - the ClassLoader to delegate to for weaving (must not be null)
Method Detail

addTransformer

public void addTransformer(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 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 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