詳解SpringBoot如何自定義一個(gè)Starter

更新時(shí)間：2022年11月16日 08:22:14 作者：一只小coder

小伙伴們?cè)?jīng)可能都經(jīng)歷過(guò)整天寫(xiě)著CURD的業(yè)務(wù)，都沒(méi)寫(xiě)過(guò)一些組件相關(guān)的東西，這篇文章記錄一下SpringBoot如何自定義一個(gè)Starter。原理和理論就不用多說(shuō)了，可以在網(wǎng)上找到很多關(guān)于該方面的資料，這里主要分享如何自定義

需求

在一個(gè)項(xiàng)目中，用戶需要發(fā)送消息，可以通過(guò)郵件，QQ，微信，釘釘，飛書(shū)等，目前這些發(fā)送消息的方式都已經(jīng)提供了公開(kāi)的API，想要實(shí)現(xiàn)在項(xiàng)目中通過(guò)簡(jiǎn)單的配置各個(gè)發(fā)發(fā)送方的發(fā)送方信息，然后直接調(diào)用發(fā)送的API，發(fā)送信息即可，下面舉個(gè)例子：

配置

message:
  email:
    username: Aden
    password: 123456
    key: HJFHADJSFBDASFHUADSINF
    api-url: http://blog.qiyuan.run
  feishu:
    user-name: Aden
    pass-word: 654321
    key: HFJKADSBFJKADSJFKADSNFAD
    api-url: http://blog.qiyuan.run

調(diào)用

    @Autowired
    SendEmailMessageServiceImpl emailMessageService;
    
    @Autowired
    SendFeishuMessageServiceImpl feishuMessageService;

    public boolean sendEmail(String msg) {
        return emailMessageService.sendMessage(msg);
    }
    
    public boolean sendFeishu(String msg){
        return feishuMessageService.sendMessage(msg);
    }

效果的就是以上這樣，只要通過(guò)配置需要發(fā)送消息的配置，自動(dòng)注入發(fā)送消息的API，就可以實(shí)現(xiàn)發(fā)送消息了，以下是實(shí)現(xiàn)過(guò)程。

starter創(chuàng)建

第一步，需要為你的starter取一個(gè)響亮的名字，spring的官方文檔中說(shuō)明，官方的 starter 的命名格式為 spring-boot-starter-{xxxx} 比如spring-boot-starter-activemq第三方我們自己的命名格式為 {xxxx}-spring-boot-starter。比如mybatis-spring-boot-starter，此處，我命名為message-spring-boot-starter

自定義配置信息類

因?yàn)橐陧?xiàng)目中的配置文件中寫(xiě)配置信息，所以在這個(gè)starter中，我們需要通過(guò)一個(gè)配置信息類來(lái)接收配置的信息。

@ConfigurationProperties(prefix = "message")
@Data
public class MessageProperties {
    /**
     * 郵箱消息
     */
    private MessageConfigInfo email = new MessageConfigInfo();
    /**
     * 飛書(shū)消息
     */
    private MessageConfigInfo feishu = new MessageConfigInfo();

    @Data
    public static class MessageConfigInfo {
        /**
         * 用戶名
         */
        private String userName;
        /**
         * 密碼
         */
        private String passWord;
        /**
         * 秘鑰
         */
        private String key;
        /**
         * 消息發(fā)送API
         */
        private String apiUrl;
    }
}

發(fā)送消息的實(shí)現(xiàn)

由于需要通過(guò)這個(gè)starter實(shí)現(xiàn)發(fā)送消息，所以這里可能得要引入發(fā)送郵件，發(fā)送飛書(shū)的官方API，這里就不搞這么復(fù)雜了，主要還是看過(guò)程，自定義一個(gè)接口模擬一下即可。

模擬接口定義

public interface SendMessageService {
    Boolean sendMessage(String message);
}

模擬接口實(shí)現(xiàn)

public class SendEmailMessageServiceImpl implements SendMessageService {

    private MessageProperties messageProperties;

    public SendEmailMessageServiceImpl(MessageProperties messageProperties) {
        this.messageProperties = messageProperties;
    }

    @Override
    public Boolean sendMessage(String message) {
        System.out.println(messageProperties.toString() + "  開(kāi)發(fā)發(fā)送郵件，發(fā)送內(nèi)容為：" + message);
        return true;
    }
}

public class SendFeishuMessageServiceImpl implements SendMessageService {

    private MessageProperties messageProperties;

    public SendFeishuMessageServiceImpl(MessageProperties messageProperties) {
        this.messageProperties = messageProperties;
    }

    @Override
    public Boolean sendMessage(String message) {
        System.out.println(messageProperties.toString() + "  開(kāi)發(fā)發(fā)送郵件，發(fā)送內(nèi)容為：" + message);
        return true;
    }
}

自動(dòng)配置類

@EnableConfigurationProperties(value = MessageProperties.class)
@Configuration
public class MessageAutoConfiguration {
    /**
     * 給發(fā)送郵件的實(shí)現(xiàn)類，注入配置信息
     * @param messageProperties
     * @return
     */
    @Bean
    public SendEmailMessageServiceImpl emailMessageConfig(MessageProperties messageProperties){
        return new SendEmailMessageServiceImpl(messageProperties);
    }


    /**
     * 給發(fā)送飛書(shū)的實(shí)現(xiàn)類，注入配置信息
     * @param messageProperties
     * @return
     */
    @Bean
    public SendFeishuMessageServiceImpl feishuMessageConfig(MessageProperties messageProperties){
        return new SendFeishuMessageServiceImpl(messageProperties);
    }
}

spring.factories

org.springframework.boot.autoconfigure.EnableAutoConfiguration=run.qiyuan.message.config.MessageAutoConfiguration

項(xiàng)目結(jié)構(gòu)

編寫(xiě)完之后，mvn install即可。

如何使用該starter

在我們的項(xiàng)目中，引入自定義starter的坐標(biāo)

        <dependency>
            <groupId>run.qiyuan</groupId>
            <artifactId>message-spring-boot-starter</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>

然后在配置文件中配置相關(guān)的信息

message:
  email:
    username: Aden
    password: 123456
    key: HJFHADJSFBDASFHUADSINF
    api-url: http://blog.qiyuan.run
  feishu:
    user-name: Aden
    pass-word: 654321
    key: HFJKADSBFJKADSJFKADSNFAD
    api-url: http://blog.qiyuan.run

測(cè)試

@SpringBootApplication
public class TeachApplication {

    public static void main(String[] args) {
        ConfigurableApplicationContext context = SpringApplication.run(TeachApplication.class, args);
        SendEmailMessageServiceImpl emailMessageService = context.getBean(SendEmailMessageServiceImpl.class);
        emailMessageService.sendMessage("你好，Starter!，這是一封郵件信息！\n\n");
        SendFeishuMessageServiceImpl feishuMessageService = context.getBean(SendFeishuMessageServiceImpl.class);
        feishuMessageService.sendMessage("你好，Starter!，這是一封飛書(shū)信息！");
    }
}