The Spring Framework recommends you to use Spring AspectJ AOP implementation over the Spring 1.2 old style dtd based AOP implementation because it provides you more control and it is easy to use.
There are two ways to use Spring AOP AspectJ implementation:
- By annotation: We are going to learn it here.
- By xml configuration (schema based): We will learn it in next page.
To understand the aop concepts, its advantage etc. visit here AOP Concepts Tutorial
Spring AspectJ AOP implementation provides many annotations:
- @Aspect declares the class as aspect.
- @Pointcut declares the pointcut expression.
The annotations used to create advices are given below:
- @Before declares the before advice. It is applied before calling the actual method.
- @After declares the after advice. It is applied after calling the actual method and before returning result.
- @AfterReturning declares the after returning advice. It is applied after calling the actual method and before returning result. But you can get the result value in the advice.
- @Around declares the around advice. It is applied before and after calling the actual method.
- @AfterThrowing declares the throws advice. It is applied if actual method throws exception.
Understanding Pointcut
Pointcut is an expression language of Spring AOP.
The @Pointcut annotation is used to define the pointcut. We can refer the pointcut expression by name also. Let's see the simple example of pointcut expression.
@Pointcut("execution(* Operation.*(..))")
private void doSomething() {}
The name of the pointcut expression is doSomething(). It will be applied on all the methods of Operation class regardless of return type.
Understanding Pointcut Expressions
Let's try the understand the pointcut expressions by the examples given below:
@Pointcut("execution(public * *(..))")
It will be applied on all the public methods.
@Pointcut("execution(public Operation.*(..))")
It will be applied on all the public methods of Operation class.
@Pointcut("execution(* Operation.*(..))")
It will be applied on all the methods of Operation class.
@Pointcut("execution(public Employee.set*(..))")
It will be applied on all the public setter methods of Employee class.
@Pointcut("execution(int Operation.*(..))")
It will be applied on all the methods of Operation class that returns int value.
1) @Before Example
The AspectJ Before Advice is applied before the actual business logic method. You can perform any operation here such as conversion, authentication etc.
Create a class that contains actual business logic.
File: Operation.java
package com.javahubpoint;
public class Operation{
public void msg(){System.out.println("msg method invoked");}
public int m(){System.out.println("m method invoked");return 2;}
public int k(){System.out.println("k method invoked");return 3;}
}
Now, create the aspect class that contains before advice.
File: TrackOperation.java
package com.javahubpoint;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.annotation.Pointcut;
@Aspect
public class TrackOperation{
@Pointcut("execution(* Operation.*(..))")
public void k(){}//pointcut name
@Before("k()")//applying pointcut on before advice
public void myadvice(JoinPoint jp)//it is advice (before advice)
{
System.out.println("additional concern");
//System.out.println("Method Signature: " + jp.getSignature());
}
}
Now create the applicationContext.xml file that defines beans.
File: applicationContext.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:aop="http://www.springframework.org/schema/aop"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd">
<bean id="opBean" class="com.javahubpoint.Operation"> </bean>
<bean id="trackMyBean" class="com.javahubpoint.TrackOperation"></bean>
<bean class="org.springframework.aop.aspectj.annotation.AnnotationAwareAspectJAutoProxyCreator"></bean>
</beans>
Now, let's call the actual method.
File: Test.java
package com.javahubpoint;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
public class Test{
public static void main(String[] args){
ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
Operation e = (Operation) context.getBean("opBean");
System.out.println("calling msg...");
e.msg();
System.out.println("calling m...");
e.m();
System.out.println("calling k...");
e.k();
}
}
Output
calling msg...
additional concern
msg() method invoked
calling m...
additional concern
m() method invoked
calling k...
additional concern
k() method invoked
As you can see, additional concern is printed before msg(), m() and k() method is invoked.
Now if you change the pointcut expression as given below:
@Pointcut("execution(* Operation.m*(..))")
Now additional concern will be applied for the methods starting with m in Operation class. Output will be as this:
calling msg...
additional concern
msg() method invoked
calling m...
additional concern
m() method invoked
calling k...
k() method invoked
Now you can see additional concern is not printed before k() method invoked.
2) @After Example
The AspectJ after advice is applied after calling the actual business logic methods. It can be used to maintain log, security, notification etc.
Here, We are assuming that Operation.java, applicationContext.xml and Test.java files are same as given in @Before example.
Create the aspect class that contains after advice.
File: TrackOperation.java
package com.javahubpoint;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.After;
import org.aspectj.lang.annotation.Pointcut;
@Aspect
public class TrackOperation{
@Pointcut("execution(* Operation.*(..))")
public void k(){}//pointcut name
@After("k()")//applying pointcut on after advice
public void myadvice(JoinPoint jp)//it is advice (after advice)
{
System.out.println("additional concern");
//System.out.println("Method Signature: " + jp.getSignature());
}
}
Output
calling msg...
msg() method invoked
additional concern
calling m...
m() method invoked
additional concern
calling k...
k() method invoked
additional concern
You can see that additional concern is printed after calling msg(), m() and k() methods.
3) @AfterReturning Example
By using after returning advice, we can get the result in the advice.
Create the class that contains business logic.
File: Operation.java
package com.javahubpoint;
public class Operation{
public int m(){System.out.println("m() method invoked");return 2;}
public int k(){System.out.println("k() method invoked");return 3;}
}
Create the aspect class that contains after returning advice.
File: TrackOperation.java
package com.javahubpoint;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.AfterReturning;
import org.aspectj.lang.annotation.Aspect;
@Aspect
public class TrackOperation{
@AfterReturning(
pointcut = "execution(* Operation.*(..))",
returning= "result")
public void myadvice(JoinPoint jp,Object result)//it is advice (after returning advice)
{
System.out.println("additional concern");
System.out.println("Method Signature: " + jp.getSignature());
System.out.println("Result in advice: "+result);
System.out.println("end of after returning advice...");
}
}
File: applicationContext.xml
It is same as given in @Before advice example
File: Test.java
Now create the Test class that calls the actual methods.
package com.javahubpoint;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
public class Test{
public static void main(String[] args){
ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
Operation e = (Operation) context.getBean("opBean");
System.out.println("calling m...");
System.out.println(e.m());
System.out.println("calling k...");
System.out.println(e.k());
}
}
Output
calling m...
m() method invoked
additional concern
Method Signature: int com.javahubpoint.Operation.m()
Result in advice: 2
end of after returning advice...
2
calling k...
k() method invoked
additional concern
Method Signature: int com.javahubpoint.Operation.k()
Result in advice: 3
end of after returning advice...
3
You can see that return value is printed two times, one is printed by TrackOperation class and second by Test class.
4) @Around Example
The AspectJ around advice is applied before and after calling the actual business logic methods.
Here, we are assuming that applicationContext.xml file is same as given in @Before example.
Create a class that contains actual business logic.
File: Operation.java
package com.javahubpoint;
public class Operation{
public void msg(){System.out.println("msg() is invoked");}
public void display(){System.out.println("display() is invoked");}
}
Create the aspect class that contains around advice.
You need to pass the PreceedingJoinPoint reference in the advice method, so that we can proceed the request by calling the proceed() method.
File: TrackOperation.java
package com.javahubpoint;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;
@Aspect
public class TrackOperation
{
@Pointcut("execution(* Operation.*(..))")
public void abcPointcut(){}
@Around("abcPointcut()")
public Object myadvice(ProceedingJoinPoint pjp) throws Throwable
{
System.out.println("Additional Concern Before calling actual method");
Object obj=pjp.proceed();
System.out.println("Additional Concern After calling actual method");
return obj;
}
}
File: Test.java
Now create the Test class that calls the actual methods.
package com.javahubpoint;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
public class Test{
public static void main(String[] args){
ApplicationContext context = new classPathXmlApplicationContext("applicationContext.xml");
Operation op = (Operation) context.getBean("opBean");
op.msg();
op.display();
}
}
Output
Additional Concern Before calling actual method
msg() is invoked
Additional Concern After calling actual method
Additional Concern Before calling actual method
display() is invoked
Additional Concern After calling actual method
You can see that additional concern is printed before and after calling msg() and display methods.
5) @AfterThrowing Example
By using after throwing advice, we can print the exception in the TrackOperation class. Let's see the example of AspectJ AfterThrowing advice.
Create the class that contains business logic.
File: Operation.java
package com.javahubpoint;
public class Operation{
public void validate(int age)throws Exception{
if(age<18){
throw new ArithmeticException("Not valid age");
}
else{
System.out.println("Thanks for vote");
}
}
}
Create the aspect class that contains after throwing advice.
Here, we need to pass the Throwable reference also, so that we can intercept the exception here.
File: TrackOperation.java
package com.javahubpoint;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.AfterThrowing;
import org.aspectj.lang.annotation.Aspect;
@Aspect
public class TrackOperation{
@AfterThrowing(
pointcut = "execution(* Operation.*(..))",
throwing= "error")
public void myadvice(JoinPoint jp,Throwable error)//it is advice
{
System.out.println("additional concern");
System.out.println("Method Signature: " + jp.getSignature());
System.out.println("Exception is: "+error);
System.out.println("end of after throwing advice...");
}
}
File: applicationContext.xml
It is same as given in @Before advice example
File: Test.java
Now create the Test class that calls the actual methods.
package com.javahubpoint;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
public class Test{
public static void main(String[] args){
ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
Operation op = (Operation) context.getBean("opBean");
System.out.println("calling validate...");
try{
op.validate(19);
}catch(Exception e){System.out.println(e);}
System.out.println("calling validate again...");
try{
op.validate(11);
}catch(Exception e){System.out.println(e);}
}
}
Output
calling validate...
Thanks for vote
calling validate again...
additional concern
Method Signature: void com.javahubpoint.Operation.validate(int)
Exception is: java.lang.ArithmeticException: Not valid age
end of after throwing advice...
java.lang.ArithmeticException: Not valid age