SpingBoot日志切面（使用自定義注解打印日志）

 

使用Sping AOP切面打印日志時，為了不影響之前的代碼，可以不攔截全部的controller層接口，而使用時注解的形式，在相應的接口方法加上日志注解，就可以打印請求參數和請求結果信息。

 

代碼如下：

1.定義切面類

@Aspect
@Component
@Slf4j
public class LogAspect {

    private LogModel logModel;

    /**
     * 這里我們使用注解的形式
     * 當然，我們也可以通過切點表達式直接指定需要攔截的package,需要攔截的class 以及 method
     * 切點表達式:   execution(...)
     */
    @Pointcut("@annotation(com.zto.poseidon.datacenter.common.annotation.OperationLog)")
    public void restControllerLog() {
    }

    /**
     * 需要忽略的返回日志
     */
    @Pointcut("!@annotation(com.zto.poseidon.datacenter.common.annotation.IgnoreResponseLog)")
    public void ignoreResponseLog() {
    }

    @Before("restControllerLog()")
    public void exBefore(JoinPoint joinPoint) {
        ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        HttpServletRequest request = attributes.getRequest();
        logModel = new LogModel();
        logModel.setUrl(request.getRequestURL().toString());
        logModel.setReqIp(request.getRemoteAddr());
        logModel.setStartTime(DateTime.now().toDate());
        logModel.setMethod(joinPoint.getSignature().getDeclaringTypeName() + "." + joinPoint.getSignature().getName());
        try {
            logModel.setParams(getRequestParamsByJoinPoint(joinPoint));
            log.info("--------------請求參數日志------------");
            log.info(" ---> 請求參數 :{}", JSON.toJSONString(logModel));
        } catch (Exception e) {
            log.info("異常信息：{}", ExceptionUtils.getStackTrace(e));
        }
    }

    @After("restControllerLog()")
    public void exAfter(JoinPoint joinPoint) {
        log.info(" ---> request method:" + joinPoint.getSignature().getDeclaringTypeName() + "." + joinPoint.getSignature().getName() + " 執行完畢!");
    }

    @AfterReturning(returning = "result", pointcut = "restControllerLog()  && ignoreResponseLog()")
    public void exAfterReturning(Object result) {
        log.info("--------------請求結果日志------------");
        log.info(" ---> 請求結果 :{}", JSON.toJSONString(result));
    }

    private Map<String, Object> getRequestParamsByJoinPoint(JoinPoint joinPoint) {
        //參數名
        String[] paramNames = ((MethodSignature) joinPoint.getSignature()).getParameterNames();
        //參數值
        Object[] paramValues = joinPoint.getArgs();
        return buildRequestParam(paramNames, paramValues);
    }

    private Map<String, Object> buildRequestParam(String[] paramNames, Object[] paramValues) {
        Map<String, Object> requestParams = new HashMap<>();
        for (int i = 0; i < paramNames.length; i++) {
            Object value = paramValues[i];
            //如果是文件對象
            if (value instanceof MultipartFile) {
                MultipartFile file = (MultipartFile) value;
                //獲取文件名
                value = file.getOriginalFilename();
            }
            requestParams.put(paramNames[i], value);
        }
        return requestParams;
    }

    @Data
    public static class LogModel {

        private String url;

        private Date startTime;

        private Date endTime;

        private Long tookTime;

        private Object result;

        private String reqIp;

        private Boolean success = Boolean.FALSE;

        private String errMsg;

        private Object queryString;

        private String method;

        private Map<String, Object> params;

        private RuntimeException exception;

    }

}

 

2.添加自定義日志打印注解，打印入參和出參日志

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface OperationLog {
}

 

3.忽視請求結果日志打印注解

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface IgnoreResponseLog {
    boolean required() default true;
}

 

4.然后在需要打印的接口方法上添加 @OperationLog 注解就ok了

 

 自定義注解@OperationLog 注解定義了可以使用在類和方法上，但使用在類上不生效。

看官方文檔解釋：

 

 

 

//@Around("@annotation(自定義注解)")//自定義注解標注在方法上的方法執行aop方法
如：@Around("@annotation(org.springframework.transaction.annotation.Transactional)")

//@Around("@within(自定義注解)")//自定義注解標注在的類上；該類的所有方法（不包含子類方法）執行aop方法
如：@Around("@within(org.springframework.transaction.annotation.Transactional)")

//@Around("within(包名前綴.*)")//com.aop.within包下所有類的所有的方法都會執行(不包含子包) aop方法
如：@Around("within(com.aop.test.*)")

//@Around("within(包名前綴..*)")//com.aop.within包下所有的方法都會執行(包含子包)aop 方法
如：@Around("within(com.aop.test..*)")

//@Around("this(java類或接口)")//實現了該接口的類、繼承該類、該類本身的類---的所有方法（包括不是接口定義的方法，但不包含父類的方法）都會執行aop方法
如：@Around("this(com.aop.service.TestService)")

//@Around("target(java類或接口)")//實現了該接口的類、繼承該類、該類本身的類---的所有方法（包括不是接口定義的方法，包含父類的方法）
如：@Around("this(com.aop.service.TestService)")

//@Around("@target(自定義注解)")//springboot項目啟動報如下錯誤，沒有解決
// Caused by: java.lang.IllegalStateException:
// StandardEngine[Tomcat].StandardHost[localhost].TomcatEmbeddedContext[] failed to start

 

所以，如果想在類上使用自定義注解，需要將 LogAspect.class 切面類里的

@Pointcut("@annotation(com.zto.poseidon.datacenter.common.annotation.OperationLog)")
    public void restControllerLog() {
    }

改為：

@Pointcut("@within(com.zto.poseidon.datacenter.common.annotation.OperationLog)")
    public void restControllerLog() {
    }

 

這樣就可以使用在類上了，但是我經過測試發現，改了之后只能用在類上，用在方法上就失效了，不能正常打印日志。暫時沒找到原因，如果有找到原因的朋友，可以留言評論一下。