Spring Boot – AOP Around Advice
Last Updated :
15 Mar, 2022
Aspect-oriented programming(AOP) as the name suggests uses aspects in programming. It can be defined as the breaking of code into different modules, also known as modularisation, where the aspect is the key unit of modularity. Aspects enable the implementation of crosscutting concerns such as transaction, logging not central to business logic without cluttering the code core to its functionality. It does so by adding additional behavior that is the advice to the existing code. For example- Security is a crosscutting concern, in many methods in an application security rules can be applied, therefore repeating the code at every method, defining the functionality in a common class, and controlling were to apply that functionality in the whole application. In this article, we will be covering a working example of Around Advice.
Tip: Aspect-Oriented Programming and AOP in Spring Framework is required as a pre-requisite before proceeding further.
Around Advice is the strongest advice among all the advice since it runs “around” a matched method execution i.e. before and after the advised method. It can choose whether to proceed to the join point or to bypass join point by returning its own return value or throwing an exception. This type of advice is used where we need frequent access to a method or database like- caching or to share state before and after a method execution in a thread-safe manner (for example, starting and stopping a timer).
It is denoted by @Around annotation. The advice method requires special parameters. The first parameter must be of type ProceedingJoinPoint. We call proceed() method on this to execute the joint point method. We can pass an array of Object to proceed methods to be used as the arguments to the method execution when it proceeds.
Steps to Implement AOP Around Advice in Spring Boot Application
Step 1: Open Spring Initializr
Step 2: Provide the Group name: com.around
Step 3: Provide the Artifact Id: aop-around-example
Step 4: Add the Spring Web dependency.
Step 5: Click on the Generate button. A zip file will be downloaded into the system. Extract it.
Step 6: Import the folder in the IDE by using the following steps:
File ->
Import ->
Existing Maven Projects ->
Next ->
Browse ->
Look for the folder aop-around-advice-example
-> Finish
When the project is imported, it will install the dependencies. Once it is done, follow the next steps.
Step 7: Add the dependency for spring AOP in pom.xml
A. pom.xml
XML
< modelVersion >4.0.0</ modelVersion >
< groupId >com.around_advice</ groupId >
< artifactId >aop-around-advice-example</ artifactId >
< version >0.0.1-SNAPSHOT</ version >
< packaging >jar</ packaging >
< name >aop-around-advice-example</ name >
< description >Demo project for Spring Boot AOP Around Advice</ description >
< parent >
< groupId >org.springframework.boot</ groupId >
< artifactId >spring-boot-starter-parent</ artifactId >
< version >2.2.2.RELEASE</ version >
< relativePath />
</ parent >
< properties >
< project.build.sourceEncoding >UTF-8</ project.build.sourceEncoding >
< project.reporting.outputEncoding >UTF-8</ project.reporting.outputEncoding >
< java.version >1.8</ java.version >
</ properties >
< dependencies >
< dependency >
< groupId >org.springframework.boot</ groupId >
< artifactId >spring-boot-starter-web</ artifactId >
</ dependency >
< dependency >
< groupId >org.springframework.boot</ groupId >
< artifactId >spring-boot-starter-aop</ artifactId >
</ dependency >
</ dependencies >
< build >
< plugins >
< plugin >
< groupId >org.springframework.boot</ groupId >
< artifactId >spring-boot-maven-plugin</ artifactId >
</ plugin >
</ plugins >
</ build >
</ project >
|
Save the changes and it will download the jars. Once it is done, move ahead with the next steps.
Note: If the jars are not added properly, you may get some errors.
Step 8: Create a package with the name com.around_advice.model. and add a Student model class to it.
B. Student class
Java
package com.around_advice.model;
public class Student {
private String firstName;
private String secondName;
public Student() {}
public String getFirstName() { return firstName; }
public void setFirstName(String firstName)
{
this .firstName = firstName;
}
public String getSecondName() { return secondName; }
public void setSecondName(String secondName)
{
this .secondName = secondName;
}
}
|
Step 9: Create a package with the name com.around_advice.service and add a Student Service class to it. Add a method to add students with given name arguments.
C. StudentService class
Java
package com.around_advice.service;
import com.around_advice.model.Student;
import org.springframework.stereotype.Service;
@Service
public class StudentService {
public Student addStudent(String fname, String sname)
{
System.out.println(
"Add student service method called, firstname: "
+ fname + " secondname: " + sname);
Student stud = new Student();
stud.setFirstName(fname);
stud.setSecondName(sname);
if (fname.length() <= 3 )
throw new RuntimeException(
"Length of firstname must be 4 or more" );
return stud;
}
}
|
Step 10: Create a package with the name com.around_advice.controller. and add a Student Controller class to it. Add a method to handle Get requests and call Student Service from it.
D. StudentController Class
Java
package com.around_advice.controller;
import com.around_advice.model.Student;
import com.around_advice.service.StudentService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class StudentController {
@Autowired private StudentService studentService;
@GetMapping (value = "/add" )
public Student addStudent(
@RequestParam ( "firstName" ) String firstName,
@RequestParam ( "secondName" ) String secondName)
{
return studentService.addStudent(firstName,
secondName);
}
}
|
Step 11: Create a package with the name com.around_advice.aspect and add a Student Service Aspect class to it. Here we will add our Advice method and PointCut expression.
E. StudentServiceAspect Class
Java
package com.around_advice.aspect;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;
import org.springframework.stereotype.Component;
@Aspect
@Component
public class StudentServiceAspect {
@Pointcut (
"execution(* com.around_advice.service.StudentService.*(..)) " )
private void
anyStudentService()
{
}
@Around ( "anyStudentService() && args(fname, sname)" )
public Object
beforeAdvice(ProceedingJoinPoint proceedingJoinPoint,
String fname, String sname)
throws Throwable
{
System.out.println(
"Around method:"
+ proceedingJoinPoint.getSignature());
System.out.println(
"Before calling joint point service method" );
Object stud = proceedingJoinPoint.proceed();
System.out.println(
"After calling joint point service method " );
return stud;
}
}
|
Step 12: We are done with the code structure. Now to run the application, start the application as “run as boot application”. Open the browser and hit the following URL to make a get request call: http://localhost:{portNumber}/add?firstName={fname}&secondName={sname}
For the demo, we are hitting URL with fname as Harry and sname as Potter. In this case, the method will be executed normally.
When we hit URL with fname as Tom, the service method will throw an exception. The around advice will not be executed.
As seen in the output, the Around advice calls the join point through proceed() and we can add logic to be executed before and after that.
Share your thoughts in the comments
Please Login to comment...