This is a annotation-based advice-like mechanism. It allows the programmers to annotate methods as being advised. Then, when such advised method is called, the associated advice is executed, instead of the method. It is up to the advice to decide whether to actually call the method. For this to work as intended the programmer needs to select the annotation to use as an advice and:
-
run the
pt.ist.esw.advice.GenerateAnnotationInstanceto generate the AnnotationInstance class that represents the selected annotation instance. This class will be used internally. -
Define the
pt.ist.esw.advice.impl.ClientAdviceFactorywhich takes the selected annotation instance and should return thept.ist.esw.advice.Advicethat will be called when an advised method is called. -
Run
pt.ist.esw.advice.ProcessAnnotationsto post-process the compiled classes. This will search the presence of the advised annotation and replace the original method with another method that runs the advice. It also creates a callable to the original advised method that is given to the execution of the Advice (in theperformmethod).
For more information please see the project's web page
Advice is distributed under the terms of the GNU LGPLv3; see the COPYING and COPYING.LESSER files for more details.