Spring Boot之AOP配自定義注解的最佳實(shí)踐過(guò)程

更新時(shí)間：2018年11月12日 11:26:15 作者：JackieZheng

這篇文章主要給大家介紹了關(guān)于Spring Boot之AOP配自定義注解的最佳實(shí)踐過(guò)程，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

前言

AOP(Aspect Oriented Programming)，即面向切面編程，是Spring框架的大殺器之一。

首先，我聲明下，我不是來(lái)系統(tǒng)介紹什么是AOP，更不是照本宣科講解什么是連接點(diǎn)、切面、通知和切入點(diǎn)這些讓人頭皮發(fā)麻的概念。

今天就來(lái)說(shuō)說(shuō)AOP的一些應(yīng)用場(chǎng)景以及如何通過(guò)和其他特性的結(jié)合提升自己的靈活性。下面話不多說(shuō)了，來(lái)一起看看詳細(xì)的介紹吧

AOP應(yīng)用舉例

AOP的一大好處就是解耦。通過(guò)切面，我們可以將那些反復(fù)出現(xiàn)的代碼抽取出來(lái)，放在一個(gè)地方統(tǒng)一處理。

同時(shí)，抽出來(lái)的代碼很多是與業(yè)務(wù)無(wú)關(guān)的，這樣可以方便開(kāi)發(fā)者更加專注自己的業(yè)務(wù)邏輯的開(kāi)發(fā)。

一個(gè)AOP的典型應(yīng)用場(chǎng)景就是日志打印。

下面是一個(gè)極端情況的Controller

@RestController
@RequestMapping("/")
public class HelloController {
 private static final Logger LOG = LoggerFactory.getLogger(HelloController.class);

 @GetMapping(value = "/index")
 public String index(HttpServletRequest request) {
  LOG.info("============打印日志開(kāi)始============");
  LOG.info("URL: " + request.getRequestURL().toString());
  LOG.info("============打印日志結(jié)束============");
  return "hello jackie";
 }

 @GetMapping(value = "/test1")
 public String test1(HttpServletRequest request, String var1) {
  LOG.info("============打印日志開(kāi)始============");
  LOG.info("URL: " + request.getRequestURL().toString());
  LOG.info("============打印日志結(jié)束============");
  return "test1";
 }

 @DemoAnnotation
 @GetMapping(value = "/test2")
 public String test2(HttpServletRequest request, String var1, String var2) {
  LOG.info("============打印日志開(kāi)始============");
  LOG.info("URL: " + request.getRequestURL().toString());
  LOG.info("============打印日志結(jié)束============");
//  int i = 1/0;
  if (1<2)
   throw new IllegalArgumentException("exception");
  return "test2";
 }
}

HelloController中提供了三個(gè)Http接口，由于業(yè)務(wù)需要，所以每次進(jìn)入某個(gè)方法的時(shí)候都需要打印請(qǐng)求的相關(guān)信息。

當(dāng)然，如果只是上面的例子，我們完全可以通過(guò)其他手段讓代碼看著并不這么糟糕。我們可以抽象一個(gè)打印方法，將相同的代碼封裝在這個(gè)方法中，之后在各個(gè)方法中每次調(diào)用即可。

但是，這種處理方法似乎抽象的還不夠，因?yàn)槲覀冊(cè)诿總€(gè)Http接口中還是要調(diào)用這個(gè)抽象的函數(shù)。而且，比較要命的是，這打印日志的代碼與其他業(yè)務(wù)代碼顯得有些格格不入。

所以，這時(shí)候，我們想到了AOP。

如何使用AOP

在Spring Boot項(xiàng)目中，只需要如下幾步，就可以輕松上手AOP。

添加maven依賴

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

編寫(xiě)切面類

@Aspect
@Component
public class DemoAspect {
 private static final Logger LOG = LoggerFactory.getLogger(DemoAspect.class);

 @Pointcut("execution(public * com.jackie.springbootdemo.controller.HelloController.test*(..))")
 public void addAdvice(){}

 @Before("addAdvice()")
 public void before(JoinPoint joinPoint){
  Object[] args = joinPoint.getArgs();
  HttpServletRequest requests = (HttpServletRequest) args[0];
  LOG.info("============打印日志開(kāi)始============");
  LOG.info("URL: " + requests.getRequestURL().toString());
  LOG.info("============打印日志結(jié)束============");
//  LOG.info("before....");
 }
}

結(jié)果驗(yàn)證對(duì)比

啟動(dòng)SpringBootDemoApplication，訪問(wèn)url：http://localhost:8080/test2?var1=1&var2=2

未使用切面功能打印日志

使用切面功能打印日志

從上面的結(jié)果展示發(fā)現(xiàn)，最終的效果是一樣的，但是使用切面更加簡(jiǎn)潔，而且可復(fù)用。

如上訪問(wèn)的是test2接口，如果訪問(wèn)test1接口也可以走切面類實(shí)現(xiàn)打印日志的需求，但是如果走index請(qǐng)求就不會(huì)打印日志了。

這是為什么呢？

AOP的局限

在切面類DemoAspect中，我們看到了切入點(diǎn)的設(shè)置

@Pointcut("execution(public * com.jackie.springbootdemo.controller.HelloController.test*(..))")
public void addAdvice(){}

其中Pointcut后面的表達(dá)式是用于控制切面的有效影響范圍。

**表達(dá)式中，第一個(gè)表示返回任意類型，第二個(gè)表示任意方法名，后面的小括號(hào)表示任意參數(shù)值，這里是以test為前綴的，所以可以匹配上test1和test2方法。

注意，在第二個(gè)之前也可以再有個(gè)，即HelloController所在位置，表示任意類名，假如這里是有兩個(gè)*.則表示包括包里面的子包。**

好了，明白了表達(dá)式的含義，我們自然就看到了AOP的局限性。

當(dāng)我們要使用切面前，就要寫(xiě)好表達(dá)式，但是項(xiàng)目一直在做，代碼一直在加，那誰(shuí)能保證后面接收代碼的兄弟也正好知道這個(gè)test前綴的意義這么重大呢？

如果他非要用hello作為前綴，那么本應(yīng)該匹配到的接口就匹配不上了，日志也就不能正常打印了。

這時(shí)候，自定義注解，就能夠很好的解決這個(gè)問(wèn)題。

自定義注解配合AOP

新建一個(gè)自定義注解

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface DemoAnnotation {

}

自定義注解的花樣也很多，比如可以在注解中聲明變量等，但這些不是我們這次討論的重點(diǎn)。

將該注解添加到Http接口test2方法上

 @DemoAnnotation
 @GetMapping(value = "/test2")
 public String test2(HttpServletRequest request, String var1, String var2) {
//  LOG.info("============打印日志開(kāi)始============");
//  LOG.info("URL: " + request.getRequestURL().toString());
//  LOG.info("============打印日志結(jié)束============");
//  int i = 1/0;
  if (1<2)
   throw new IllegalArgumentException("exception");
  return "test2";
 }

在切面類中將切入點(diǎn)的表達(dá)式改為

@Pointcut("execution(public * com.jackie.springbootdemo.controller.*.*(..)) && @annotation(com.jackie.springbootdemo.annotation.DemoAnnotation)")
public void addAdvice(){}

這樣，我們不需要限制在controller類中是以test作為前綴了，只要是在上面定義的類路徑下，并且掃描到注解DemoAnnotation就可以讓切面生效。