SpringBoot —— AOP註解式攔截與方法規則攔截

　　AspectJ是一個面向切面的框架，它擴展了Java語言。AspectJ定義了AOP語法，因此它有一個專門的編譯器用來生成遵照Java字節編碼規範的Class文件。

　　SpringBoot中AOP的使用方式主要有兩種：註解式攔截與方法規則攔截，具體使用以下文所示。

1、建立一個簡單springboot 2.03項目，添加aop依賴

<dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

　此依賴已包含AspectJ相關依賴包。

2、編寫攔截規則的註解

package com.cenobitor.aop.annotation;

import java.lang.annotation.*;

@Target(ElementType.METHOD) 
@Retention(RetentionPolicy.RUNTIME) 
@Documented
public @interface Action {
    String name();
}

註解說明：元註解是指註解的註解，包括@Retention @Target @Document @Inherited四種。

1.@Retention: 定義註解的保留策略

•   @Retention(RetentionPolicy.SOURCE)   //註解僅存在於源碼中，在class字節碼文件中不包含
•   @Retention(RetentionPolicy.CLASS)     // 默認的保留策略，註解會在class字節碼文件中存在，但運行時沒法得到，
•   @Retention(RetentionPolicy.RUNTIME)  // 註解會在class字節碼文件中存在，在運行時能夠經過反射獲取到

　　首先要明確生命週期長度 SOURCE < CLASS < RUNTIME ，因此前者能做用的地方後者必定也能做用。通常若是須要在運行時去動態獲取註解信息，那隻能用 RUNTIME 註解；若是要在編譯時進行一些預處理操做，好比生成一些輔助代碼（如 ButterKnife），就用 CLASS註解；若是隻是作一些檢查性的操做，好比 @Override 和 @SuppressWarnings，則可選用 SOURCE 註解。

2.@Target：定義註解的做用目標
　源碼爲：

@Documented  
@Retention(RetentionPolicy.RUNTIME)  
@Target(ElementType.ANNOTATION_TYPE)  
public @interface Target {  
    ElementType[] value();  
}  

• @Target(ElementType.TYPE)   //接口、類、枚舉、註解
• @Target(ElementType.FIELD) //字段、枚舉的常量
• @Target(ElementType.METHOD) //方法
• @Target(ElementType.PARAMETER) //方法參數
• @Target(ElementType.CONSTRUCTOR)  //構造函數
• @Target(ElementType.LOCAL_VARIABLE)//局部變量
• @Target(ElementType.ANNOTATION_TYPE)//註解
• @Target(ElementType.PACKAGE) ///包  

3.@Document：說明該註解將被包含在javadoc中
4.@Inherited：說明子類能夠繼承父類中的該註解

3、編寫使用註解的被攔截類

package com.cenobitor.aop.service;

import com.cenobitor.aop.annotation.Action;
import org.springframework.stereotype.Service;

@Service
public class DemoAnnotationService {
    @Action(name = "註解式攔截的add操做")
    public void add(){}
}

4、編寫使用方法規則被攔截類

package com.cenobitor.aop.service;

import org.springframework.stereotype.Service;

@Service
public class DemoMethodService {
    public void add(){}
}

5、編寫切面

package com.cenobitor.aop.aspect;

import com.cenobitor.aop.annotation.Action;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.After;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.annotation.Pointcut;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;
import java.lang.reflect.Method;

@Aspect
@Component
public class LogAspect {

    @Pointcut("@annotation(com.cenobitor.aop.annotation.Action)")
    public void annotationPoinCut(){}

    @After("annotationPoinCut()")
    public void after(JoinPoint joinPoint){
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Method method = signature.getMethod();
        Action action = method.getAnnotation(Action.class);
        System.out.println("註解式攔截 "+action.name());
    }

    @Before("execution(* com.cenobitor.aop.service.DemoMethodService.*(..))")
    public void before(JoinPoint joinPoint){
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Method method = signature.getMethod();
        System.out.println("方法規則式攔截,"+method.getName());
    }
}

AOP註解說明：

• @Aspect 定義切面：切面由切點和加強（引介）組成(能夠包含多個切點和多個加強)，它既包括了橫切邏輯的定義，也包括了鏈接點的定義，SpringAOP就是負責實施切面的框架，它將切面所定義的橫切邏輯織入到切面所指定的連接點中。
• @Pointcut 定義切點：切點是一組鏈接點的集合。AOP經過「切點」定位特定的鏈接點。經過數據庫查詢的概念來理解切點和鏈接點的關係再適合不過了：鏈接點至關於數據庫中的記錄，而切點至關於查詢條件。
• @Before ：在目標方法被調用以前作加強處理,@Before只須要指定切入點表達式便可。
• @AfterReturning ： 在目標方法正常完成後作加強,@AfterReturning除了指定切入點表達式後，還能夠指定一個返回值形參名returning,表明目標方法的返回值。
• @Afterthrowing： 主要用來處理程序中未處理的異常,@AfterThrowing除了指定切入點表達式後，還能夠指定一個throwing的返回值形參名,能夠經過該形參名來訪問目標方法中所拋出的異常對象。
• @After： 在目標方法完成以後作加強，不管目標方法時候成功完成。@After能夠指定一個切入點表達式。
• @Around： 環繞通知,在目標方法完成先後作加強處理,環繞通知是最重要的通知類型,像事務,日誌等都是環繞通知,注意編程中核心是一個ProceedingJoinPoint。

6、運行

public class main {
    public static void main(String[] args) {

        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(AopApplication.class);
        DemoAnnotationService demoAnnotationService = context.getBean(DemoAnnotationService.class);
        DemoMethodService demoMethodService = context.getBean(DemoMethodService.class);
        demoAnnotationService.add();
        demoMethodService.add();
    }

}

 AopApplication.class爲本項目的啓動類。

運行結果以下：

註解式攔截 註解式攔截的add操做
方法規則式攔截,add

 注：摘抄自《JavaEE開發的顛覆者SpringBoot 實戰》，根據springboot 2.0.3作些許修改，省略一些配置項。