自定义springboot - starter 实现日志打印

Posted yangxiaohui227

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了自定义springboot - starter 实现日志打印相关的知识,希望对你有一定的参考价值。

1. starter 命名规则:

           springboot项目有很多专一功能的starter组件,命名都是spring-boot-starter-xx,如spring-boot-starter-logging,spring-boot-starter-web,

  如果是第三方的starter命名一般是:xx-springboot-starter 如:mongodb-plus-spring-boot-starter,mybatis-spring-boot-starter;
2. starter的原理:

      2.1 springboot的自动装配机制

 

 

 

    2.2 属性文件自动装配

 

 3. 需求,我们准备弄个日志相关的starter,当别人依赖我们的jar包时,在需要打印日志的方法上贴上对应的注解即可,日志打印的前置通知和后置通知内容可以在application.yml或者application.properties中配置

     思路: 我们需要定义一个注解:这样别人在需要打日志的地方贴上该注解即可:

package com.yang.log.hui.annotion;

import java.lang.annotation.*;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@Documented
public @interface MyLogAnnotation {
}

接着,我们要让注解生效,所以需要一个切面类:

package com.yang.log.hui.config;


import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;

import java.util.Arrays;

@Aspect
public class MyLogAspect {
    private MylogProperties mylogProperties;
    public MyLogAspect(MylogProperties mylogProperties) {  当一个bean没有无参构造器时,spring创建bean时,对于构造器参数会从容器中取,这里其实是省略了@Autowired,该注解可以用在方法参数上
        this.mylogProperties=mylogProperties;
    }

    @Pointcut("@annotation(com.yang.log.hui.annotion.MyLogAnnotation)")
    public void logAnnotationAnnotationPointcut() {
    }
    @Around("logAnnotationAnnotationPointcut()")
    public Object logInvoke(ProceedingJoinPoint joinPoint) throws Throwable {
        System.out.println(mylogProperties.getOrDefualtPrefix("请求参数")+ Arrays.toString(joinPoint.getArgs())); //如果配置文件配了对应的前缀,就用配置文件的,否则用默认的
        Object obj = joinPoint.proceed();
        System.out.println(mylogProperties.getOrDefualtSubfix("返回值:")+ obj.toString());//跟前缀一样
        return obj;
    }


}

 

切面类中有个配置文件类:

package com.yang.log.hui.config;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.util.StringUtils;

@ConfigurationProperties(value ="mylog") //这个注解可以让配置文件中的属性根据前缀来注入对应的属性
public class MylogProperties {
    //日志前缀
    private String prefix;  //会自动找配置文件中 mylog.prefix的值
    //日志后缀
    private String subfix; //会自动找配置文件中 mylog.subfix的值


    public String getOrDefualtPrefix(String defualtPrefix){
        if(StringUtils.isEmpty(prefix)){
            return defualtPrefix;
        }
        return prefix;
    }

    public String getOrDefualtSubfix(String defualtSubfix){
        if(StringUtils.isEmpty(subfix)){
            return defualtSubfix;
        }
        return subfix;
    }

    public void setPrefix(String prefix) {
        this.prefix = prefix;
    }

    public void setSubfix(String subfix) {
        this.subfix = subfix;
    }


}

 

要让上面类注入spring容器,需要一个配置类:

package com.yang.log.hui.config;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
@EnableConfigurationProperties(MylogProperties.class) //该注解可以使MylogProperties注入spring容器
public class MyLogAutoConfiguration {
    @Bean
    public MyLogAspect myLogAspect(@Autowired MylogProperties mylogProperties){
        return new MyLogAspect(mylogProperties);
    }
}

 

到此为止,只要MyLogAutoConfiguration 注入spring容器了,那么他里面的bean也会被注入,而怎么样使得MyLogAutoConfiguration 注入spring呢,那就要用到springboot的自动装配机制:

在resources下创建一个META-INF文件夹,然后在创建一个文件:spring.factories文件加入内容:key是固定的org.springframework.boot.autoconfigure.EnableAutoConfiguration,value可以有多个

 

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\\
com.yang.log.hui.config.MyLogAutoConfiguration

 

 

 

依赖: 平时我们在写application.yml时会有提示,那么我也想让我的日志配置也会生效,也就是当我输入mylog时,会提示mylog.prefix 或者mylog.subfix,此时需要下面的配置:

 

      <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
       </dependency>

 

 

因为我们项目用到springboot和aop,所以需要:

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

注意:maven打包时,不能用spring-boot-maven-plugin,我用它打包没报错,给其他服务引用对应的jar时,启动报错了。需要换成:

 <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

 

至此,项目创建完毕: 现在看下整体情况:

 

 

 pom文件整体:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.0.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.yang.xiao.hui</groupId>
    <artifactId>log-spring-boot-starter</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>log-spring-boot-starter</name>
    <description>Demo project for Spring Boot</description>
    <packaging>jar</packaging>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-aop</artifactId>
        </dependency>
        <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
       </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

 

 

   项目打包进行测试:

 

 

新建web项目引入我们的日志依赖:

    <dependency>
           <groupId>com.yang.xiao.hui</groupId>
           <artifactId>log-spring-boot-starter</artifactId>
           <version>0.0.1-SNAPSHOT</version>
       </dependency>

测试项目提供一个controller,对应方法贴上我们的日志注解:

package com.yang.xiao.hui.product.controller;

import com.yang.log.hui.annotion.MyLogAnnotation;
import com.yang.xiao.hui.product.entity.Product;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class ProductController {
    @RequestMapping("/info/{id}")
    @ResponseBody
    @MyLogAnnotation //这个是我们的日志注解
    public Product getProductInfo(@PathVariable("id") Integer id){
        Product product = new Product();
        product.setId(id);
        product.setName("苹果手机");
        return product;
    }
}

 

测试项目的整体情况:

 

 此时我们没有在yml中配置日志前缀,启动测试项目测试:

浏览器输入:http://localhost:8673/info/3

控制台输出:

 

 我们在yml配置文件输入前后缀:

 

 可见,有提示,跟我们配置其他组件的属性一样:

 

 重启测试项目,再次在浏览器输入:http://localhost:8673/info/3

 

 至此,我们实现了一个完整的springboot starter,在springboot项目中,很多组件的底层原理都是这样实现的,通过这种实现,可以做底层架构,然后给其他服务使用,如可以校验请求参数,处理返回结果等

附加git代码地址: https://gitee.com/yangxioahui/log-spring-boot-starter.git

 

上面的实现,有个问题,当我不想用该功能时,相关的bean也会注入容器中,那如果我想实现动态可插拔功能,怎么处理?

要实现可插拔功能,那关键是对MyLogAutoConfiguration 这个配置类下手了,用到@ConditionalOnBean(xx.class)注解,当容器中含有xxbean时,才会使得配置生效,那如何使得xxbean可以注入容器,那就要用到@EnableXX注解

xxbean只是一个标记类,不用作特殊配置:

 

public class LogMarkerConfiguration {
}

 

 @EnableXX注解:

 

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Documented
@Import(LogMarkerConfiguration.class) //往容器中注入xxBean
public @interface EnableMyLog {
}

 

 修改MyLogAutoConfiguration配置类:

 

@Configuration
@EnableConfigurationProperties(MylogProperties.class)
@ConditionalOnBean(LogMarkerConfiguration.class) //当容器中有这个xxbean就会使得下面配置生效
public class MyLogAutoConfiguration {
    @Bean
    public MyLogAspect myLogAspect(@Autowired MylogProperties mylogProperties){
        return new MyLogAspect(mylogProperties);
    }
}

 

 通过上面代码知道,如果要使得MyLogAutoConfiguration生效,容器中必须有LogMarkerConfiguration这个标志bean,容器中要有这个标志bean,就要用到@EnableMyLog注解,因此,当第三方引用我们的依赖时,只需要再主启动类上加入@EnableMyLog注解即可:

附加: zuul网关实现可插拔的原理也是一样:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

   

以上是关于自定义springboot - starter 实现日志打印的主要内容,如果未能解决你的问题,请参考以下文章

springBoot学习笔记自定义starter

SpringBoot系列之自定义starter实践教程

自定义SpringBoot Starter 实现请求日志打印

自定义SpringBoot Starter 通过注解启动装配

SpringBoot——SpringBoot四大核心之起步依赖(自定义starter)

SpringBoot——SpringBoot四大核心之起步依赖(自定义starter)