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

迈不过友情╰ 2023-01-18 04:22 148阅读 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` 的一些相关依赖。

![9a451152c6eb0e7453409ca79808451a.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可以完成初始化配置。

推荐好文

[强大，10k+点赞的 SpringBoot 后台管理系统竟然出了详细教程！][10k_ SpringBoot]

[分享一套基于SpringBoot和Vue的企业级中后台开源项目，代码很规范！][SpringBoot_Vue]

[能挣钱的，开源 SpringBoot 商城系统，功能超全，超漂亮][SpringBoot]![7585008e63986fb9950a48e5b25a5585.png][]

[9a451152c6eb0e7453409ca79808451a.png]: /images/20221021/a125c5b33bf34a31a476a4b104d8e358.png
[10k_ SpringBoot]: http://mp.weixin.qq.com/s?__biz=MzI4Njc5NjM1NQ%3D%3D&chksm=ebd5c411dca24d07446a4f22772cd12d2cc1143b62eb922a14500ae981cd57fb850ef74ca257&idx=2&mid=2247498557&scene=21&sn=84902d7030e174e152615d8fae3755cc#wechat_redirect
[SpringBoot_Vue]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc799be6cb0e12f0b58479f8b031bc5ae79efdca1880ff9b19f0a107c3a88c37b9596dc73203&idx=2&mid=2247497288&scene=21&sn=65d7111a19e920df1e9416959594b2f4#wechat_redirect
[SpringBoot]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc799a9ccb0e138a64a2671f31b8d4be1b3c061a288f7b0d1d4af02a60c45a72231446b91e00&idx=2&mid=2247497522&scene=21&sn=c5b4e596be4ac7d7f293e7e2f0ea0769#wechat_redirect
[7585008e63986fb9950a48e5b25a5585.png]: /images/20221021/97ecc572fcfc4596a6292575240260f8.png