<aop> <interceptor class="ConfigInterceptor" scope="PER_CLASS"> <attribute name="Attr1">aa</attribute> <attribute name="Attr2">1</attribute> </interceptor> <aspect class="ConfigAspectPerVm" scope="PER_VM"> <attribute name="Attr">aspect,per,vm</attribute> </aspect> <aspect class="ConfigAspectPerClass" scope="PER_CLASS"> <attribute name="Attr">aspect,per,class</attribute> </aspect> <aspect class="ConfigAspectPerInstance" scope="PER_INSTANCE"> <attribute name="Attr">aspect,per,instance</attribute> </aspect> <aspect class="ConfigAspectPerJoinpoint" scope="PER_JOINPOINT"> <attribute name="Attr">aspect,per,joinpoint</attribute> </aspect> ... <aop>
The name attribute is used to indicate which property you want to set, and the contents of the attribute is the value. Valid types are all the primitives (String, float, int etc.), or an array of Strings. The aspect/interceptor must contain a setter matching the signature implied by the configuration in jboss-aop.xml. In this example we have:
public class ConfigInterceptor implements Interceptor
{
String attr1;
int attr2;
...
public void setAttr1(String s)
{
attr1 = s;
System.out.println("setAttr1: " + s);
}
public void setAttr2(int i)
{
attr2 = i;
System.out.println("setAttr2: " + i);
}
...
}
public class ConfigAspectPerVm
{
String[] attr1;
...
public void setAttr(String[] attr1)
{
this.attr1 = attr1;
}
}
So, in the bindings above, JBoss AOP will call ConfigInterceptor.setAttr1("aa"), ConfigInterceptor.setAttr2(1), ConfigAspectPerVm.setAttr({"aspect", "per", "vm"}). ConfigAspectPerClass, ConfigAspectPerInstance and ConfigAspectPerJoinpoint are more or less the same as ConfigAspectPerVm.
<aop>
<interceptor class="ConfigInterceptor" scope="PER_CLASS">
...
<advisor-attribute name="MyAdvisor"/>
<instance-advisor-attribute name="MyInstanceAdvisor"/>
<joinpoint-attribute name="MyJoinpoint"/>
</interceptor>
<aop>
For injecting the Advisor, the setMyAdvisor() method will be called. For injecting the InstanceAdvisor, the setMyInstanceAdvisor() method will be called. For injecting the Joinpoint, the setMyJoinpoint() method will be called.
The setters used by ConfigInterceptor are shown here:
public class ConfigInterceptor implements Interceptor
{
...
Advisor advisor;
InstanceAdvisor instanceAdvisor;
Joinpoint jp;
...
public void setMyAdvisor(Advisor advisor)
{
this.advisor = advisor;
}
public void setMyInstanceAdvisor(InstanceAdvisor instanceAdvisor)
{
this.instanceAdvisor = instanceAdvisor;
}
public void setMyJoinpoint(Joinpoint jp)
{
this.jp = jp;
}
}
Scope\AOP construct Advisor InstanceAdvisor Joinpoint PER_VM no no no PER_CLASS yes no no PER_INSTANCE yes*) yes*) no PER_JOINPOINT yes yes*) yes
(The ones marked with *) are not available when invoking a static method or reading/writing a static field.)
To compile and run (for further detail, refer to our Compiling and Running Examples Guide):
$ ant run.aopc
It will javac the files and then run the AOPC precompiler to manipulate the bytecode, then finally run the example. The output should be similar to this:
_run.aopc:
[java] --- new POJO(); ---
[java] setAttr1: aa
[java] setAttr2: 1
[java] WARN: Ignoring attempt to set instance advisor attribute on aspect/i
nterceptor: ConfigInterceptor which is not scoped PER_INSTANCE or PER_JOINPOINT
[java] WARN: Ignoring attempt to set joinpoint attribute on aspect/intercep
tor: ConfigInterceptor which is not scoped PER_JOINPOINT
[java] setAttr1: aa
[java] setAttr2: 1
[java] WARN: Ignoring attempt to set instance advisor attribute on aspect/i
nterceptor: ConfigInterceptor which is not scoped PER_INSTANCE or PER_JOINPOINT
[java] WARN: Ignoring attempt to set joinpoint attribute on aspect/intercep
tor: ConfigInterceptor which is not scoped PER_JOINPOINT
[java] WARN: Ignoring attempt to set advisor attribute on PER_VM scoped asp
ect/interceptor: ConfigAspectPerVm
[java] WARN: Ignoring attempt to set instance advisor attribute on aspect/i
nterceptor: ConfigAspectPerVm which is not scoped PER_INSTANCE or PER_JOINPOINT
[java] WARN: Ignoring attempt to set joinpoint attribute on aspect/intercep
tor: ConfigAspectPerVm which is not scoped PER_JOINPOINT
[java] WARN: Ignoring attempt to set instance advisor attribute on aspect/i
nterceptor: ConfigAspectPerClass which is not scoped PER_INSTANCE or PER_JOINPOI
NT
[java] WARN: Ignoring attempt to set joinpoint attribute on aspect/intercep
tor: ConfigAspectPerClass which is not scoped PER_JOINPOINT
[java] POJO empty constructor
[java] --- pojo.interceptorMethod(); ---
[java] <<< Entering ConfigInterceptor type: ConfigInterceptor@17ee8b8
[java] attr1:aa; attr2:1
[java] has advisor: true
[java] has instanceAdvisor: false
[java] has joinpoint: false
[java] POJO interceptorMethod
[java] >>> Leaving ConfigInterceptor
[java] --- pojo.aspectPerVmMethod(); ---
[java] >>> Enter ConfigAspectPerVm
[java] attr1: index 0=aspect, index 1=per, index 2=vm
[java] has advisor: false
[java] has instanceAdvisor: false
[java] has joinpoint: false
[java] POJO aspectPerVmMethod
[java] >>> Leave ConfigAspectPerVm
[java] --- pojo.aspectPerClassMethod(); ---
[java] <<< Enter ConfigAspectPerClass
[java] attr1: index 0=aspect, index 1=per, index 2=class
[java] has advisor: true
[java] has instanceAdvisor: false
[java] has joinpoint: false
[java] POJO aspectPerClassMethod
[java] >>> Leave ConfigAspectPerClass
[java] --- pojo.aspectPerInstanceMethod(); ---
[java] WARN: Ignoring attempt to set joinpoint attribute on aspect/intercep
tor: ConfigAspectPerInstance which is not scoped PER_JOINPOINT
[java] <<< Enter ConfigAspectPerInstance
[java] attr1: index 0=aspect, index 1=per, index 2=instance
[java] has advisor: true
[java] has instanceAdvisor: true
[java] has joinpoint: false
[java] POJO aspectPerInstanceMethod
[java] >>> Leave ConfigAspectPerInstance
[java] --- pojo.aspectPerJoinpointMethod(); ---
[java] <<< Enter ConfigAspectPerJoinpoint
[java] attr1: index 0=aspect, index 1=per, index 2=joinpoint
[java] has advisor: true
[java] has instanceAdvisor: true
[java] has joinpoint: true
[java] POJO interceptorMethod
[java] >>> Leave ConfigAspectPerJoinpoint