Spring Boot手写starter

1.介绍

1.1 什么是 Starter 机制？

Starter 机制是 Spring Boot 提供的一种约定优于配置的实现方式，可以抛弃以前繁杂的配置，将其统一集成进starter，应用者只需要在maven中引入starter依赖，SpringBoot就能自动扫描到要加载的信息并启动相应的默认配置。

starter让我们摆脱了各种依赖库的处理，需要配置各种信息的困扰。SpringBoot会自动通过classpath路径下的类发现需要的Bean，并注册进IOC容器。

1.2 Starter 机制的工作原理？

当 Spring Boot 应用启动时，它会扫描 classpath 下的 META-INF/spring.factories 文件，查找所有标记为 org.springframework.boot.autoconfigure.EnableAutoConfiguration 的配置类。这些配置类中定义了应用所需的 Bean 和自动配置逻辑。

Spring Boot 会根据条件注解（如 @ConditionalOnClass、@ConditionalOnMissingBean 等）来决定是否进行自动配置。

2.starter自定义

springboot 官方推荐使用格式：

• springboot官方：spring-boot-starter-xxx
• 第三方开发者自定义：xxxx-spring-boot-starter

自定义一个的启动器，包含一个自定义的记录方法执行时间的注解：logtimex-spring-boot-starter

2.1 新建工程

引入以下依赖：

 <!--日志-->
<dependency><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId>
</dependency>
<!--aop相关-->
<dependency><groupId>org.aspectj</groupId><artifactId>aspectjweaver</artifactId>
</dependency>
<!--工具类-->
<dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId>
</dependency>
<!--自动配置相关-->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-autoconfigure</artifactId>
</dependency>

2.2 自定义注解

package cn.smart.pagex.annotation;import java.lang.annotation.*;
@Target({ElementType.METHOD})		//放在方法上
@Retention(RetentionPolicy.RUNTIME)		//运行时注解可见(用于通过反射读取注解)
@Documentedpublic @interface PageX {String value() default "";
}

2.3 创建增强类

package cn.smart.logtimex.aop;import cn.hutool.core.date.StopWatch;
import lombok.extern.slf4j.Slf4j;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;
import org.springframework.stereotype.Component;@Component
@Aspect
@Slf4j
public class LogTimeXAop {//指定注解为切入点@Pointcut("@annotation(cn.smart.core.annotation.LogTimeX)")public void pointCut() {}@Around("pointCut()")public Object around(ProceedingJoinPoint pjp) throws Throwable {StopWatch stopWatch = new StopWatch();//开始计时stopWatch.start();//放行被增强的方法Object result = pjp.proceed();//结束计时stopWatch.stop();log.debug("方法执行时间：{}", stopWatch.getTotalTimeMillis());return result;}
}

2.4 创建自动配置类

package cn.smart.logtimex.autoconfiguration;import cn.smart.logtimex.aop.LogTimeXAop;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;@Configuration
@Import(LogTimeXAop.class)
//开关
//cn.smart.logtimex.enable = true
@ConditionalOnProperty(prefix = "cn.smart.logtimex",value = "enable", havingValue = "true", matchIfMissing = true)
public class LogTimeXAutoConfiguration { //领头羊
}

2.5 配置自动配置

在resourecs文件目录下创建META-INF，并创建我们自己的spring.factories，并把我们的 LogTimeXAutoConfiguration 添加进去

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
cn.smart.logtimex.autoconfiguration.LogTimeXAutoConfiguration

2.6 测试

在其他模块引入依赖

<!--输出执行时间--><dependency><groupId>cn.smart</groupId><artifactId>logtimex-spring-boot-starter</artifactId><version>0.0.1-SNAPSHOT</version></dependency>

在application.properties配置文件中可以对我们的starter进行设置

//使starter有效，默认
cn.smart.logtimex.enable = true//使starter无效，原理就是控制是否进行自动配置
cn.smart.logtimex.enable = false