手撸了一个 starter，同事直夸我 666~

刺骨的言语ヽ痛彻心扉 2023-09-28 13:00 16阅读 0赞

#### Spring Boot starter 原理 ####

Spring Boot 将常见的开发功能，分成了一个个的 starter，这样我们开发功能的时候只需要引入对应的 starter，而不需要去引入一堆依赖了！starter 可以理解为一个依赖组，其主要功能就是完成**引入依赖**和**初始化配置**。Spring 官方提供的 starter 命名规范为 `spring-boot-starter-xxx` ，第三方提供的 starter 命名规范为 `xxx-spring-boot-starter` 。

这里我们以 `RocketMQ` 的依赖 `rocketmq-spring-boot-starter` 来学习 starter 的原理。

在项目中引入 `rocketmq-spring-boot-starter` 之后，实际上就引入了 `rocketmq` 的一些相关依赖。

![e9ba9ad887f196a5182526f6df3849e1.png][]

在 `rocketmq-spring-boot` 中有一个自动装配的类 `RocketMQAutoConfiguration` ，我截取了其中的一小段代码，一起来看看。

@Configuration
    @EnableConfigurationProperties(RocketMQProperties.class)
    @ConditionalOnClass({MQAdmin.class})
    @ConditionalOnProperty(prefix = "rocketmq", value = "name-server", matchIfMissing = true)
    @Import({MessageConverterConfiguration.class, ListenerContainerConfiguration.class, ExtProducerResetConfiguration.class, RocketMQTransactionConfiguration.class})
    @AutoConfigureAfter({MessageConverterConfiguration.class})
    @AutoConfigureBefore({RocketMQTransactionConfiguration.class})
    
    public class RocketMQAutoConfiguration {
        private static final Logger log = LoggerFactory.getLogger(RocketMQAutoConfiguration.class);
    
        public static final String ROCKETMQ_TEMPLATE_DEFAULT_GLOBAL_NAME =
            "rocketMQTemplate";
    
        @Autowired
        private Environment environment;
    
        @Bean(destroyMethod = "destroy")
        @ConditionalOnBean(DefaultMQProducer.class)
        @ConditionalOnMissingBean(name = ROCKETMQ_TEMPLATE_DEFAULT_GLOBAL_NAME)
        public RocketMQTemplate rocketMQTemplate(DefaultMQProducer mqProducer,
            RocketMQMessageConverter rocketMQMessageConverter) {
            RocketMQTemplate rocketMQTemplate = new RocketMQTemplate();
            rocketMQTemplate.setProducer(mqProducer);
            rocketMQTemplate.setMessageConverter(rocketMQMessageConverter.getMessageConverter());
            return rocketMQTemplate;
        }
    }

*  @Configuration 说明这是一个配置类，类中被 @Bean 注解了的方法，就是 spring 的一个 bean，例如 `rocketMQTemplate`。
 *  @EnableConfigurationProperties，启用被 @ConfigurationProperties 的 bean，这里引入了 `RocketMQProperties` 。

`RocketMQProperties` 就是需要在 yml 文件中写入的属性。

@ConfigurationProperties(prefix = "rocketmq")
    public class RocketMQProperties {
    
        private String nameServer;
    
        private String accessChannel;
    
        private Producer producer;
    
        private Consumer consumer = new Consumer();
    }

在 Spring Boot 项目启动的时候默认只会扫描下级目录下带 `@Configuration` 注解的类，那么像本文中提到的 `RocketMQAutoConfiguration` 是如何扫描的呢？其实项目启动的时候会去加载项目中所有的 `spring.factories` 文件，然后加载对应的配置类，因此我们就需要在 `spring.factories` 中只指定需要扫描的类。

原理搞明白了，接下来我们就简单实现一个自己的 starter！这个 starter 的主要作用就是给一个对象尾部拼接一个字符串！

#### 一、新建项目 ####

新建一个名为 `javatip-spring-boot-starter` 的项目，并且引入下面的依赖

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

#### 二、新增配置类 ####

配置类对应的 properties 文件中的属性为 `javatip.name`；

@ConfigurationProperties(prefix = "javatip")
    public class JavatipPorperties {
    
        private String name;
    
        public String getName() {
            return name;
        }
    
        public void setName(String name) {
            this.name = name;
        }
    }

#### 三、新增拼接字符串的方法 ####

此方法主要就是为对象拼接一个固定的字符串

public class StrUt {
    
        private String name;
    
        public String strTo(Object object){
    
            return object +"---"+ getName();
        }
    
        public String getName() {
            return name;
        }
    
        public void setName(String name) {
            this.name = name;
        }
    }

#### 四、新增自动配置类 ####

使用注解 `@EnableConfigurationProperties` 启用 `JavatipProperties` 配置类

使用注解 `@Configuration` 配合 `@Bean` 注册一个拼接字符串的 bean 对象。

@Configuration
    @EnableConfigurationProperties(JavatipPorperties.class)
    public class JavatipAutoConfiguration {
    
        @Autowired
        private JavatipPorperties javatipPorperties;
    
        @Bean
        public StrUt strut(){
            StrUt strut = new StrUt();
            strut.setName(javatipPorperties.getName());
            return strut;
        }
    }

#### 五、新增配置发现文件 ####

在 resources 文件夹中新建 `META-INF` 文件夹，在 `META-INF` 文件夹中新建配置发现文件 `spring.factories`，并且将自动配置类写到文件里。

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.javatip.str.configuration.JavatipAutoConfiguration

#### 六、打包测试 ####

使用 `mvn install` 命令将项目打包推送到本地 maven 仓库，然后新建一个测试项目，引入打包好的依赖。

<dependency>
        <groupId>com.javatip</groupId>
        <artifactId>javatip-spring-boot-starter</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </dependency>

在 `application.yml` 文件中写入自动拼接的字符串对应的属性 `javatip.name` 。

javatip:
      name: Java旅途

然后手写一个测试类：

@RestController
    public class Test {
        
        @Autowired
        private StrUt strUt;
    
        @GetMapping("test")
        public String test(){
    
            String str = strUt.strTo("who are you?");
            return str;
        }
    }

运行测试类后，页面返回了

who are you?---Java旅途

这样，一个简单的 starter 就写好了，只要理解了 starter 的原理，实现起来就很简单，第一点就是 starter 相当于一个依赖组，另一点就是 starter 可以完成初始化配置。

#### 点关注、不迷路 ####

如果觉得文章不错，欢迎关注、点赞、收藏，你们的支持是我创作的动力，感谢大家。

![528d9d98171e4a8b800ad95cd6494959.gif][]

[e9ba9ad887f196a5182526f6df3849e1.png]: https://img-blog.csdnimg.cn/img_convert/e9ba9ad887f196a5182526f6df3849e1.png
[528d9d98171e4a8b800ad95cd6494959.gif]: https://img-blog.csdnimg.cn/528d9d98171e4a8b800ad95cd6494959.gif