Package org.aspectj.weaver.loadtime

Class Aj

java.lang.Object

org.aspectj.weaver.loadtime.Aj

All Implemented Interfaces:

ClassPreProcessor

public class Aj
extends Object
implements ClassPreProcessor

Adapter between the generic class pre processor interface and the AspectJ weaver Load time weaving consistency relies on Bcel.setRepository

Author:

Alexandre Vasseur (alex AT gnilux DOT com)

Field Summary

Fields

Modifier and Type	Field	Description
static SimpleCache	laCache
static List<String>	loadersToSkip

Constructor Summary

Constructors

Constructor	Description
Aj()
Aj(IWeavingContext context)

Method Summary

Modifier and Type	Method	Description
static void	checkQ()	Process the reference queue that contains stale AdaptorKeys - the keys are put on the queue when their classloader referent is garbage collected and so the associated adaptor (weaver) should be removed from the map
void	flushGeneratedClasses(ClassLoader loader)
boolean	generatedClassesExist(ClassLoader loader)	Check to see if any classes have been generated for a particular classes loader.
static int	getActiveAdaptorCount()
String	getNamespace(ClassLoader loader)	Returns a namespace based on the contest of the aspects available
void	initialize()	Initialization
void	prepareForRedefinition(ClassLoader loader, String className)
byte[]	preProcess(String className, byte[] bytes, ClassLoader classLoader, ProtectionDomain protectionDomain)
static int	removeStaleAdaptors(boolean displayProgress)	The reference queue is only processed when a request is made for a weaver adaptor.

Methods inherited from class java.lang.Object

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

Field Details

laCache

public static SimpleCache laCache

loadersToSkip

public static List<String> loadersToSkip

Constructor Details

Aj

public Aj()

Aj

public Aj(IWeavingContext context)

Method Details

initialize

public void initialize()

Initialization

Specified by:

initialize in interface ClassPreProcessor

preProcess

public byte[] preProcess(String className,
 byte[] bytes,
 ClassLoader classLoader,
 ProtectionDomain protectionDomain)

Specified by:

preProcess in interface ClassPreProcessor

Parameters:

className - the name of the class in the internal form of fully qualified class and interface names as defined in The Java Virtual Machine Specification. For example, "java/util/List".

bytes - the input byte buffer in class file format - must not be modified

classLoader - the defining loader of the class to be transformed, may be null if the bootstrap loader

protectionDomain - the protection domain of the class being defined or redefined

Returns:

a well-formed class file buffer (weaving result), or null if no weaving was performed

See Also:

• ClassFileTransformer.transform(ClassLoader, String, Class, ProtectionDomain, byte[])

removeStaleAdaptors

public static int removeStaleAdaptors(boolean displayProgress)

The reference queue is only processed when a request is made for a weaver adaptor. This means there can be one or two stale weavers left around. If the user knows they have finished all their weaving, they might wish to call removeStaleAdaptors which will process anything left on the reference queue containing adaptorKeys for garbage collected classloaders.

Parameters:

displayProgress - produce System.err info on the tidying up process

Returns:

number of stale weavers removed

getActiveAdaptorCount

public static int getActiveAdaptorCount()

Returns:

the number of entries still in the weavingAdaptors map

checkQ

public static void checkQ()

Process the reference queue that contains stale AdaptorKeys - the keys are put on the queue when their classloader referent is garbage collected and so the associated adaptor (weaver) should be removed from the map

getNamespace

public String getNamespace(ClassLoader loader)

Returns a namespace based on the contest of the aspects available

generatedClassesExist

public boolean generatedClassesExist(ClassLoader loader)

Check to see if any classes have been generated for a particular classes loader. Calls ClassLoaderWeavingAdaptor.generatedClassesExist()

Parameters:

loader - the class cloder

Returns:

true if classes have been generated.

flushGeneratedClasses

public void flushGeneratedClasses(ClassLoader loader)

prepareForRedefinition

public void prepareForRedefinition(ClassLoader loader,
 String className)

Specified by:

prepareForRedefinition in interface ClassPreProcessor