SpringCloud Alibaba 2021微服务实战二十 业务日志处理,starter实战

SpringCloud Alibaba微服务实战之业务日志组件

要实现上述的功能我们需要借助SringBoot Starter来实现，SpringBoot 的一大优势就是Starter，通过Starter我们可以封装公共的业务逻辑以及参数的初始化，如果你在进行微服务开发，Starter的编写是一定要掌握的。

概述

前面我们通过gateway记录了请求响应日志信息，但对某个业务场景记录更确切的日志，我们要编写通用的一个组件来处理。日志如何处理，根据业务要求合理处理日志，这里只提供一个处理的思路，细化不再处理。.

在单体项目中如果我们需要记录操作日志一般会通过如下手段实现：

• 建立一个自定义注解，标注业务操作类型
• 通过AOP组装日志实体，完成日志的收集工作

但是在微服务架构中我们不可能每个服务都写一个自定义注解，再写一个AOP，这很明显违反了 Don’t repeat yourself 精神。所以这时候我们一般都会建立一个公共的组件，在公共组件中完成日志的收集，后端服务只需要引入这个公共的组件即可。

这就是今天文章的内容，独立的业务日志收集组件。

SpringBoot Starter

要实现上述的功能我们需要借助SringBoot Starter来实现，SpringBoot 的一大优势就是Starter，通过Starter我们可以封装公共的业务逻辑以及参数的初始化，如果你在进行微服务开发，Starter的编写是一定要掌握的。

这里我们简单提一下SpringBoot Starter实现自动化配置的流程

• spring-boot启动的时候会找到starterjar包中的resources/META-INF/spring.factories文件，根据spring.factories文件中的配置，找到需要自动配置的类，xxxAutoConfigure
• 通过xxxAutoConfigure上的注解@EnableConfigurationProperties将当前模块的属性绑定到「Environment」 上(若有)。
• 通过xxxAutoConfigure中定义的bean自动装配到IOC容器中。

实战

过程如下：

首先我们在项目中建立一个starter的module，如cloud-component-logging-starter

编写配置类SysLogAutoConfigure

1. @Configuration 
2. public class SysLogAutoConfigure { 
4.     @Bean 
5.     public SysLogAspect controllerLogAspect(){ 
6.         return new SysLogAspect(); 
7.     } 
9. } 

在SysLogAutoConfigure中我们注入了一个日志切面SysLogAspect，由于日志收集工具不需要额外配置属性，所以我们也就不需要定义属性配置类了。

自定义日志注解 SysLog

1. @Target(ElementType.METHOD) 
2. @Retention(RetentionPolicy.RUNTIME) 
3. @Documented 
4. public @interface SysLog { 
5.  /** 
6.   * 日志内容 
7.   * @return {String} 
8.   */ 
9.  String value(); 
10. } 

定义日志切面 SysLogAspect

1. @Aspect 
2. public class SysLogAspect { 
4.     private final Logger log = LoggerFactory.getLogger(this.getClass()); 
6.     @Pointcut("@annotation(com.javadaily.component.logging.annotation.SysLog)") 
7.     public void logPointCut() { 
9.     } 
11.     @Around("logPointCut()") 
12.     public Object around(ProceedingJoinPoint pjp) throws Throwable { 
13.         MethodSignature signature = (MethodSignature) pjp.getSignature(); 
14.         Method method = signature.getMethod(); 
15.        //类名 
16.         String className = pjp.getTarget().getClass().getName(); 
17.         //方法名 
18.         String methodName = signature.getName(); 
19.      
20.         SysLog syslog = method.getAnnotation(SysLog.class); 
21.         //操作 
22.         String operator =syslog.value(); 
24.         long beginTime = System.currentTimeMillis(); 
26.         Object returnValue = null; 
27.         Exception ex = null; 
28.         try { 
29.             returnValue = pjp.proceed(); 
30.             return returnValue; 
31.         } catch (Exception e) { 
32.             ex = e; 
33.             throw e; 
34.         } finally { 
35.             long cost = System.currentTimeMillis() - beginTime; 
36.             if (ex != null) { 
37.                 log.error("[class: {}][method: {}][operator: {}][cost: {}ms][args: {}][发生异常]", 
38.                         className, methodName, operator, pjp.getArgs(), ex); 
39.             } else { 
40.                 log.info("[class: {}][method: {}][operator: {}][cost: {}ms][args: {}][return: {}]", 
41.                         className, methodName, operator, cost, pjp.getArgs(), returnValue); 
42.             } 
43.         } 
45.     } 
46. } 

上面的切面表示，对于使用了@SysLog注解的方法自动进行日志收集，将日志输入到日志文件。

在resource/META-INF目录下建立spring.factories文件，加载配置类SysLogAutoConfigure

1. org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ 
2. com.javadaily.component.logging.configure.SysLogAutoConfigure 

在微服务中引入日志组件

1. <dependency> 
2.     <groupId>com.jianzh5.cloud</groupId> 
3.     <artifactId>cloud-component-logging-starter</artifactId> 
4.     <version>1.0.0</version> 
5. </dependency> 

在需要进行日志收集的方法上添加@SysLog注解

1. @SysLog("查找用户") 
2. public ResultData<AccountDTO> getByCode(@PathVariable(value = "accountCode") String accountCode){ 
3.     log.warn("get account detail,accountCode is :{}",accountCode); 
5.     SecurityUser securityUser = SecurityUtils.getUser(); 
6.     log.info(securityUser); 
8.     AccountDTO accountDTO = accountService.selectByCode(accountCode); 
9.     return ResultData.success(accountDTO); 
10. } 

小结

通过上面7步我们完成了日志收集组件的自定义Starter编写，这里可能有的同学会问，在 SysLogAutoConfigure类中不是有了 @Configuration和 @Bean注解，这两个注解不是可以自动加载定义的Bean到IOC容器吗?为什么还需要通过在spring.factories文件中导入 SysLogAutoConfigure呢?

这是因为springboot项目默认只会扫描本项目下的带@Configuration注解的类，如果自定义starter，不在本工程中，是无法加载的，所以要配置META-INF/spring.factories配置文件，通过spring.factories来装载配置类。