如何徒手擼了一個SpringBoot Starter

這篇文章將為大家詳細講解有關(guān)如何徒手擼了一個Starter，文章內(nèi)容質(zhì)量較高，因此小編分享給大家做個參考，希望大家閱讀完這篇文章后對相關(guān)知識有一定的了解。

Spring Boot starter原理

Spring Boot  將常見的開發(fā)功能，分成了一個個的starter，這樣我們開發(fā)功能的時候只需要引入對應(yīng)的starter，而不需要去引入一堆依賴了!starter可以理解為一個依賴組，其主要功能就是完成引入依賴和初始化配置。Spring  官方提供的starter 命名規(guī)范為 spring-boot-starter-xxx ，第三方提供的starter命名規(guī)范為  xxx-spring-boot-starter 。

這里我們以 RocketMQ 的依賴 rocketmq-spring-boot-starter 來學習 starter的原理。

在項目中引入 rocketmq-spring-boot-starter 之后，實際上就引入了 rocketmq 的一些相關(guān)依賴。

在 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  文件，然后加載對應(yīng)的配置類，因此我們就需要在 spring.factories 中只指定需要掃描的類。

原理搞明白了，接下來我們就簡單實現(xiàn)一個自己的starter!這個starter的主要作用就是給一個對象尾部拼接一個字符串!

一、新建項目

新建一個名為 javatip-spring-boot-starter 的項目，并且引入下面的依賴

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

二、新增配置類

配置類對應(yīng)的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;     } }

五、新增配置發(fā)現(xiàn)文件

在resources文件夾中新建 META-INF 文件夾，在 META-INF 文件夾中新建配置發(fā)現(xiàn)文件  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 文件中寫入自動拼接的字符串對應(yīng)的屬性 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的原理，實現(xiàn)起來就很簡單，第一點就是starter相當于一個依賴組，另一點就是starter可以完成初始化配置。

關(guān)于如何徒手擼了一個Starter就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，可以學到更多知識。如果覺得文章不錯，可以把它分享出去讓更多的人看到。