首頁 > 軟體

SpringBoot使用AOP記錄介面操作紀錄檔詳解

2022-08-28 18:00:22

SpringBoot 使用 AOP 記錄介面操作紀錄檔,供大家參考,具體內容如下

一、AOP簡介

1.什麼是AOP

AOP:Aspect Oriented Programming 面向切面程式設計

AOP關注不是某一個類或某些方法;控制大量資源,關注的是大量的類和方法。

2.AOP應用場景以及常用術語

  • 許可權控制、快取控制、事務控制、分散式追蹤、例外處理等
  • Target:目標類,即需要被代理的類。例如:UserService
  • Joinpoint(連線點):所謂連線點是指那些可能被攔截到的方法。例如:所有的方法
  • PointCut 切入點:已經被增強的連線點。例如:addUser()
  • Advice 通知/增強,增強程式碼。例如:after、before
  • Weaving(織入):是指把增強advice應用到目標物件target來建立新的代理物件proxy的過程.
  • Aspect(切面): 是切入點pointcut和通知advice的結合

3.AOP的特點

1)降低模組與模組之間的耦合度,提高業務程式碼的聚合度。(高內聚低耦合)

2)提高了程式碼的複用性

3)提高系統的擴充套件性。(高版本相容低版本)

4)可以在不影響原有的功能基礎上新增新的功能

二、springBoot 使用 AOP 實現流程

1.引入依賴

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

2.封裝記錄紀錄檔實體類

@Getter
@Setter
@ApiModel(value = "Systemlog物件", description = "")
public class Systemlog implements Serializable {

    private static final long serialVersionUID = 1L;

      @ApiModelProperty("ID")
      @TableId(value = "id", type = IdType.AUTO)
      private Integer id;

      @ApiModelProperty("使用者名稱")
      private String userName;

      @ApiModelProperty("使用者ID")
      private Integer userId;

      @ApiModelProperty("操作描述")
      private String operate;

      @ApiModelProperty("模組")
      private String module;

      @ApiModelProperty("建立紀錄檔時間")
      @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
      private Date createTime;

      @ApiModelProperty("操作結果")
      private String result;

}

3.編寫註解類(自定義紀錄檔註解類)

/**
 * controller層切面紀錄檔註解
 * @author hsq
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface SystemControllerLog {
    // 操作描述
    String operate();
    // 模組
    String module();
}

4.編寫操作紀錄檔的切面類

**
 * @author hsq
 */
@Aspect
@Component
public class SystemLogAspect {

    private static final Logger logger = LoggerFactory.getLogger(SystemLogAspect.class);

    @Autowired
    private ISystemlogService iSystemlogService;

    @Autowired
    private UserService userService;

    /**
     * Controller層切點
     */
    @Pointcut("@annotation(com.hsq.demo.config.SystemControllerLog)")
    public void SystemControllerLog(){

    }
    
   
    /**
     * 前置通知 用於攔截Controller層記錄使用者的操作的開始時間
     * @param joinPoint 切點
     * @throws InterruptedException
     */
    @Before("SystemControllerLog()")
    public void doBefore(JoinPoint joinPoint) throws InterruptedException{
        logger.info("進入紀錄檔切面前置通知!");

    }

    @After("SystemControllerLog()")
    public void doAfter(JoinPoint joinPoint) {
        logger.info("進入紀錄檔切面後置通知!");

    }

    /**value切入點位置
     * returning 自定義的變數,標識目標方法的返回值,自定義變數名必須和通知方法的形參一樣
     * 特點:在目標方法之後執行的,能夠獲取到目標方法的返回值,可以根據這個返回值做不同的處理
     */
    @AfterReturning(value = "SystemControllerLog()", returning = "ret")
    public void doAfterReturning(Object ret) throws Throwable {
    }

    /***
     * 異常通知 記錄操作報錯紀錄檔
     * * @param joinPoint
     * * @param e
     * */
    @AfterThrowing(pointcut = "SystemControllerLog()", throwing = "e")
    public void doAfterThrowing(JoinPoint joinPoint, Throwable e) {
        logger.info("進入紀錄檔切面異常通知!!");
        logger.info("異常資訊:" + e.getMessage());
    }
        
        
    //使用這個方法先註釋前面三個方法,留before方法就行
    /**
     * 通知包裹了目標方法,在目標方法呼叫之前和之後執行自定義的行為
     * ProceedingJoinPoint切入點可以獲取切入點方法上的名字、引數、註解和物件
     * @param joinPoint
     */
    @Around("SystemControllerLog() && @annotation(systemControllerLog)")
  public Result doAfterReturning(ProceedingJoinPoint joinPoint, SystemControllerLog systemControllerLog) throws Throwable {
        logger.info("設定紀錄檔資訊儲存到表中!");
        //joinPoint.proceed() 結果集
        //引數陣列
        Object[] args = joinPoint.getArgs();
        //請求引數資料
        String requestJson = JSONUtil.toJsonStr(args);
        //方法名
        String methodName = joinPoint.getSignature().getName();
        //得到request
        HttpServletRequest request = ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getRequest();
        //得到token
        String token = request.getHeader("token");
        String userId = JWT.decode(token).getAudience().get(0);
        User user = userService.getById(userId);
        logger.info("得到使用者資訊:"+user.toString());
        //寫入資料庫操作紀錄檔
        Systemlog systemlog = new Systemlog();
        systemlog.setUserId(user.getUid());
        systemlog.setUserName(user.getUname());
        systemlog.setOperate(systemControllerLog.operate());
        systemlog.setModule(systemControllerLog.module());
        systemlog.setCreateTime(new Date());
        //存入返回的結果集 joinPoint.proceed()
        Result proceed = (Result) joinPoint.proceed();
        systemlog.setResult(JSONUtil.toJsonStr(joinPoint.proceed()));
        //儲存
       saveSystemLog(systemlog);

       return proceed;

    }

}

5.controller使用

 @GetMapping("/userListPage")
 @SystemControllerLog(operate = "使用者查詢",module = "使用者管理")
 public Result findUserList( @RequestParam Integer pageNum,
                                @RequestParam Integer pageSize,
                                @RequestParam String username,
                                @RequestParam String loveValue,
                                @RequestParam String address) {}
  @PostMapping("/addOrUpdate")
  @SystemControllerLog(operate = "使用者修改或者新增",module = "使用者管理")
  public Result addOrUpdateUser(@RequestBody User user){}

6.資料庫記錄

以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支援it145.com。


IT145.com E-mail:sddin#qq.com