org.jboss.aop.instrument
Interface DynamicTransformationObserver


public interface DynamicTransformationObserver

Observer of the transformation process of a class (the transformation target class). When a field read, field write, or constructor execution becomes wrapped due to only dynamicaly added bindings, it may be necessary to hot swap the code of classes previously loaded. Any class that executes the dynamicaly wrapped joinpoint must be changed to invoke the joinpoint wrapped instead. The implementation of this observer that must be used is dependent of the dynamic aop strategy.

Author:
Flavia Rainone
See Also:
DynamicAOPStrategy

Method Summary
 void constructorDynamicalyWrapped()
          Notifies that during the transformation of target class, its constructor execution joinpoints were wrapped due only to bindings added dynamicaly.
 void fieldReadDynamicalyWrapped(javassist.CtField field)
          Notifies that during the transformation of the target class, the field read joinpoint was wrapped due only to bindings added dynamicaly.
 void fieldWriteDynamicalyWrapped(javassist.CtField field)
          Notifies that during the transformation of target class, the field write joinpoint was wrapped due only to bindings added dynamicaly.
 void transformationFinished(javassist.CtClass clazz, javassist.CodeConverter converter)
          Notifies the observer that the transformation of the target class is finished.
 

Method Detail

fieldReadDynamicalyWrapped

void fieldReadDynamicalyWrapped(javassist.CtField field)
Notifies that during the transformation of the target class, the field read joinpoint was wrapped due only to bindings added dynamicaly. This means that callers of field read joinpoint may need to be hotswapped to invoke the field read wrapper.

Parameters:
field - the field whose read joinpoint was dynamicaly wrapped.

fieldWriteDynamicalyWrapped

void fieldWriteDynamicalyWrapped(javassist.CtField field)
Notifies that during the transformation of target class, the field write joinpoint was wrapped due only to bindings added dynamicaly. This means that callers of field write joinpoint may need to be hotswapped to invoke the field write wrapper.

Parameters:
field - the field whose write joinpoint was dynamicaly wrapped.

constructorDynamicalyWrapped

void constructorDynamicalyWrapped()
Notifies that during the transformation of target class, its constructor execution joinpoints were wrapped due only to bindings added dynamicaly. This means that callers of the constructor execution joinpoints may need to be hotswapped to invoke the constructor execution wrappers.


transformationFinished

void transformationFinished(javassist.CtClass clazz,
                            javassist.CodeConverter converter)
Notifies the observer that the transformation of the target class is finished.



Copyright © 2008 JBoss, a division of Red Hat, Inc.. All Rights Reserved.