詳解SpringBoot?Start組件開發(fā)之記錄接口日志信息

更新時間：2023年04月28日 10:00:18 作者：Anoxia1

這篇文章主要為大家介紹了SpringBoot-Start組件開發(fā)之記錄接口日志信息詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪

前言

不積跬步無以至千里，不積小流，無以成江海

在公司一般來說，都只會接觸一些CRUD的業(yè)務，很多時候可能你想設計很多的代碼結構，但是時間不允許。近期接到一個項目，領導說要擴展、要兼容、等等等。然后我就想著那我就花點時間把代碼結構設計一下，然后給出排期，當領導看到我的排期時間的時候，他跟我說，我們要小步快跑，我覺得他在CPU我，明明上一次還再說要擴展要兼容的。自己去完成一些springboot-start的功能實現(xiàn)，我覺得是一個很鍛煉人的方式，一是可以讓自己多去思考自己的代碼改怎么組織，再一個是springboot-start一般都是抽出一些公共的邏輯，所以這對我們理解項目的能力也有一定的要求。springboot 存在很多的start組件，他們可以很方便的幫我們注入一些我們需要的功能，不需要的時候，直接刪除依賴就可以了，開發(fā)出來的組件可以拔插式的接入項目。

目標

基于 AOP 實現(xiàn)系統(tǒng)監(jiān)控，主要是通過aop切面功能來增強方法，實現(xiàn)監(jiān)控。

設計

項目結構

cn-anoxia-start-log
└── src
    ├── main
    │   └── java
    │       ├── cn.anoxia.log
    │       │   ├── annotation
    │       │   │   └── LogCheck.java
    │       │   ├── config
    │       │   │   └── LogAutoConfigure.java
    │       │   └── LogCheckJoinPoint.java
    │       └── resources
    │           └── META-INF 
    │               └── spring.factories
    └── test
        └── java
            └── cn.anoxia.log.test
                └── ApiTest.java

實現(xiàn)過程主要是通過AOP攔截注解，然后對方法進行處理

LogCheck 自定義注解，主要作用就是添加到需要監(jiān)控的方法上。
LogAutoConfigure 配置類，對一些類做初始化操作。
LogCheckJoinPoint 核心類，負責對攔截的方法做邏輯處理。
spring.factories spring-boot 自動注入的配置文件。

springboot 在啟動的時候讀取spring.factories里面的內容，然后把配置類添加到spring容器中。使用 springboot的自動注入的功能完成配置的加載。

org.springframework.boot.autoconfigure.EnableAutoConfiguration=cn.anoxia.log.config.LogAutoConfigure

自定義攔截注解LogCheck

/**
 * @description: 方法耗時檢測注解
 * @author：huangle
 * @date: 2022/7/22
 */
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.METHOD})
public @interface LogCheck {
    String key() default "";
    String desc() default "";
}

AOP 處理類, 定義切點為注解，然后使用環(huán)繞處理對方法進行增強。

/**
 * @description: aop攔截注解，進行方法增強
 * @author：huangle
 * @date: 2022/7/22
 */
@Aspect
@Component
public class LogCheckJoinPoint {
    private final Logger logger = LoggerFactory.getLogger(LogCheckJoinPoint.class);
    @Pointcut("@annotation(cn.anoxia.log.annotation.LogCheck)")
    public void aopPoint(){
        // 定義切點
    }
    @Around("aopPoint() && @annotation(logCheck)")
    public void doCheck(ProceedingJoinPoint joinPoint, LogCheck logCheck) throws Throwable {
        // 執(zhí)行前增強
        logger.info("當前執(zhí)行的類：{}",joinPoint.getClass());
        Method method = getMethod(joinPoint);
        Long start = System.currentTimeMillis();
        try {
            // 執(zhí)行目標方法
            joinPoint.proceed();
        }finally {
            System.out.println("監(jiān)控 - Begin By AOP");
            System.out.println("監(jiān)控索引：" + logCheck.key());
            System.out.println("監(jiān)控描述：" + logCheck.desc());
            System.out.println("方法名稱：" + method.getName());
            System.out.println("方法耗時：" + (System.currentTimeMillis() - start) + "ms");
            System.out.println("監(jiān)控 - End\r\n");
        }
    }
    private Method getMethod(JoinPoint jp) throws NoSuchMethodException {
        Signature sig = jp.getSignature();
        MethodSignature methodSignature = (MethodSignature) sig;
        return jp.getTarget().getClass().getMethod(methodSignature.getName(), methodSignature.getParameterTypes());
    }
}

配置類里面的內容, 對核心類進行初始化，并且添加到spring容器

@Configuration
public class LogAutoConfigure implements EnvironmentAware {
    private final Logger logger = LoggerFactory.getLogger(LogAutoConfigure.class);
    private final Map<String,Object> logConfigMap = new HashMap<>();
    @Bean
    @ConditionalOnMissingBean
    public LogCheckJoinPoint point(){
        return new LogCheckJoinPoint();
    }
}

測試

創(chuàng)建一個項目，然后導入我們創(chuàng)建的start

<dependency>
            <groupId>cn.anoxia</groupId>
            <artifactId>anoxia-spring-start-log</artifactId>
            <version>1.0.0-SNAPSHOT</version>
        </dependency>

添加注解，攔截方法

@LogCheck(key = "cn.anoxia.demo.controller.TestController",desc = "獲取用戶信息")
    @RequestMapping("/v1/info")
    public String testController(){
        return "hello";
    }

測試結果,可以獲取到執(zhí)行方法的一些信息，并且對方法進行增強。