spring-boot使用AOP統一處理日誌
轉載地址:https://blog.csdn.net/w05980598/article/details/79053209
AOP我想大家都很清楚,有時候我們需要處理一些請求日誌,或者對某些方法進行一些監控,如果出現例外情況應該進行怎麼樣的處理,現在,我們從spring boot中引入AOP
[開發環境:jdk版本號為1.8,spring boot的版本號為1.4.1]
POM檔案新增如下內容:
-
<!--引用AOP-->
-
<dependency>
-
<groupId>org.springframework.boot</groupId>
-
<artifactId>spring-boot-starter-aop</artifactId>
-
</dependency>
-
<!--引用GSON,用於列印-->
-
<dependency>
-
<groupId>com.google.code.gson</groupId>
-
<artifactId>gson</artifactId>
-
<version>2.7</version>
-
</dependency>
引入jar包後,我們在boot的啟動方法,增加兩個簡單的請求處理方法:
-
@SpringBootApplication(scanBasePackages = {"com"})
-
@RestController
-
public class DemoApplication{
-
public static void main(String[] args) {
-
SpringApplication.run(DemoApplication.class, args);
-
}
-
//測試無參的get請求
-
@RequestMapping(value = "/testAspect",method = RequestMethod.GET)
-
public UserVo test(){
-
UserVo userVo = new UserVo();
-
userVo.setAge("23");
-
userVo.setName("賀小五");
-
userVo.setSex("男");
-
return userVo;
-
}
-
//測試有參的get請求,讓aop列印引數內容
-
@RequestMapping(value = "/testAspectArgs",method = RequestMethod.GET)
-
public UserVo test(String name,String age,String sex){
-
UserVo userVo = new UserVo();
-
userVo.setName(name);
-
userVo.setAge(age);
-
userVo.setSex(sex);
-
return userVo;
-
}
增加了兩個簡單的處理請求方法後,我們來增加我們的aop
-
/**
-
* 專案名:SpringBootDemo
-
* 建立人:賀小五
-
* 建立時間:16/12/4 下午7:05
-
* 類名:AspectDemo
-
* 類描述:
-
*/
-
//申明是個切面
-
@Aspect
-
//申明是個spring管理的bean
-
@Component
-
@Order(1)
-
public class AspectDemo {
-
private Logger log = Logger.getLogger(getClass());
-
private Gson gson = new Gson();
-
//申明一個切點 裡面是 execution表示式
-
@Pointcut("execution(public * com.example.DemoApplication.*(..))")
-
private void controllerAspect(){}
-
//請求method前列印內容
-
@Before(value = "controllerAspect()")
-
public void methodBefore(JoinPoint joinPoint){
-
ServletRequestAttributes requestAttributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
-
HttpServletRequest request = requestAttributes.getRequest();
-
//列印請求內容
-
log.info("===============請求內容===============");
-
log.info("請求地址:"+request.getRequestURL().toString());
-
log.info("請求方式:"+request.getMethod());
-
log.info("請求類方法:"+joinPoint.getSignature());
-
log.info("請求類方法引數:"+ Arrays.toString(joinPoint.getArgs()));
-
log.info("===============請求內容===============");
-
}
-
//在方法執行完結後列印返回內容
-
@AfterReturning(returning = "o",pointcut = "controllerAspect()")
-
public void methodAfterReturing(Object o ){
-
log.info("--------------返回內容----------------");
-
log.info("Response內容:"+gson.toJson(o));
-
log.info("--------------返回內容----------------");
-
}
兩者配置好之後,接下來,我們請求,然後檢視列印日誌,首先,啟動我們的容器,然後我們先請求有參的處理請求方法的,列印日誌如下:
{width=“1232” height=“132”}
可以發現,請求的url,method,以及args引數的值,還有型別,以及返回的內容都打印出來了,說明,這是AOP攔截成功了.
接下來,我們測試下請求無參的處理請求方法,列印日誌如下:
{width=“1100” height=“130”}
我們可以發現,這個方法,列印的方法引數是個空陣列,是因為方法不需要引數傳遞.
以上就是spring boot引用aop進行處理web的日誌處理,下面將新增AOP切面的主要幾個註解,下面只是對註解的描述跟使用,具體測試,作者就不進行測試了,各位看官有興趣的話,可以自己測試一下:
類註解:
- @Aspect 將一個類定義為一個切面類
- @order(i) 標記切面類的處理優先順序,i值越小,優先級別越高.PS:可以註解類,也能註解到方法上
方法註解:
- @Pointcut 定義一個方法為切點裡面的內容為一個表示式,下面詳細介紹
- @Before 在切點前執行方法,內容為指定的切點
- @After 在切點後,return前執行,
- @AfterReturning 在切入點,return後執行,如果想對某些方法的返回引數進行處理,可以在這操作
- @Around 環繞切點,在進入切點前,跟切點後執行
- @AfterThrowing 在切點後丟擲異常進行處理
- @order(i) 標記切點的優先順序,i越小,優先順序越高
@Pointcut註解組合使用:
上面程式碼中,我們定義了一個切點,該切點只進行處理指定路徑的:
@Pointcut("execution(public * com.example.DemoApplication.*(..))")
private void controllerAspect(){}
現在,我們在定義一個處理其他路徑下的切點:
@Pointcut("execution(public * com.demo.*.*(..))")
private void controllerDemo(){}
以上切點,都是分別處理不同的內容,如果我們需要一個切點來處理他們兩者,我們可以這麼配置:
@Pointcut(value = "controllerAspect()||controllerDemo()")
private void all(){}
在@Pointcut註解內,直接引用其它被@Pointcut註解過的方法名稱,這樣,該切點就可以處理兩個路徑下的方法
@Pointcut註解中的execution表示式: public * com.demo.*.*(..)
- 第一個 public 表示方法的修飾符,可以用*代替
- 第一個 * 表示 返回值,*代表所有
- com.demo.* 包路徑,.*表示路徑下的所有包
- 第三個.* 表示路徑下,所有包下的所有類的方法
- (..) 表示不限方法引數
關於@order(i)註解的一些注意事項:
註解類,i值是,值越小,優先順序越高
註解方法,分兩種情況
註解的是 @Before 是i值越小,優先順序越高
註解的是 @After或者@AfterReturning 中,i值越大,優先順序越高
總結兩者的概括就是:
- 在切入點前的操作,按order的值由小到大執行
- 在切入點後的操作,按order的值由大到小執行
延伸:
有看官可能會問,如果我要列印請求從進來,到結束,所需要的時間,定義一個成員變數,用來統計時間,同時給@Before跟@AfterReturning訪問,可能會有同步的問題,所以我們引用一個ThreadLocal<Long>指定泛型的物件,在@Before記錄請求的時間,在@AfterReturning扣除記錄的時間,就是消耗的時間,程式碼如下:
-
/**
-
* 專案名:SpringBootDemo
-
* 建立人:賀小五
-
* 建立時間:16/12/4 下午7:05
-
* 類名:AspectDemo
-
* 類描述:
-
*/
-
//申明是個切面
-
@Aspect
-
//申明是個spring管理的bean
-
@Component
-
@Order(1)
-
public class AspectDemo {
-
private Logger log = Logger.getLogger(getClass());
-
private Gson gson = new Gson();
-
ThreadLocal<Long> startTime = new ThreadLocal<Long>();
-
//申明一個切點 裡面是 execution表示式
-
@Pointcut("execution(public * com.example.DemoApplication.*(..))")
-
private void controllerAspect() {
-
}
-
//請求method前列印內容
-
@Before(value = "controllerAspect()")
-
public void methodBefore(JoinPoint joinPoint) {
-
startTime.set(System.currentTimeMillis());
-
ServletRequestAttributes requestAttributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
-
HttpServletRequest request = requestAttributes.getRequest();
-
//列印請求內容
-
log.info("===============請求內容===============");
-
log.info("請求地址:" + request.getRequestURL().toString());
-
log.info("請求方式:" + request.getMethod());
-
log.info("請求類方法:" + joinPoint.getSignature());
-
log.info("請求類方法引數:" + Arrays.toString(joinPoint.getArgs()));
-
log.info("===============請求內容===============");
-
}
-
//在方法執行完結後列印返回內容
-
@AfterReturning(returning = "o", pointcut = "controllerAspect()")
-
public void methodAfterReturing(Object o) {
-
log.info("--------------返回內容----------------");
-
log.info("Response內容:" + gson.toJson(o));
-
log.info("--------------返回內容----------------");
-
log.info("請求處理時間為:"+(System.currentTimeMillis() - startTime.get()));
-
}
-
}