把 mqtt封装成为 springboot自定义 starter，对外提供 util 工具访问

MQTT 是一种轻量级的消息传输协议，可以帮助我们实现设备之间的通信和数据交换。Spring Boot 是一个非常流行的 Java Web 开发框架，提供了很多方便的工具和组件，可以帮助我们快速构建 Web 应用程序。将 MQTT 封装成 Spring Boot 自定义 starter，可以更方便地在 Spring Boot 项目中使用 MQTT。

下面是如何将 MQTT 封装成 Spring Boot 自定义 starter 的步骤：

1. 创建一个 Spring Boot 项目

首先，我们需要创建一个新的 Spring Boot 项目。可以使用 Spring Initializr 或者手动创建一个 Maven 或 Gradle 项目。

2. 添加 MQTT 依赖

在 pom.xml 或 build.gradle 文件中添加 MQTT 的依赖，例如：

<dependency>
    <groupId>org.eclipse.paho</groupId>
    <artifactId>org.eclipse.paho.client.mqttv3</artifactId>
    <version>1.2.5</version>
</dependency>

3. 创建 MQTT 工具类

创建一个 MQTT 工具类，用于连接 MQTT 服务器、订阅主题、发布消息等操作。可以参考 Eclipse Paho 官方文档编写 MQTT 工具类。

4. 创建自定义 starter

创建一个新的模块，用于封装 MQTT 工具类，可以命名为 mqtt-spring-boot-starter。

在该模块的 pom.xml 或 build.gradle 文件中添加 Spring Boot Starter 的依赖，例如：

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

在 src/main/resources/META-INF 目录下创建 spring.factories 文件，内容如下：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.mqtt.MqttAutoConfiguration

其中，`com.example.mqtt.MqttAutoConfiguration` 是自动配置类的全限定名，用于将 MQTT 工具类注入到 Spring 容器中。

5. 创建自动配置类

创建一个自动配置类，用于将 MQTT 工具类注入到 Spring 容器中。可以参考 Spring Boot 官方文档编写自动配置类。

@Configuration
@ConditionalOnClass({MqttClient.class})
@EnableConfigurationProperties(MqttProperties.class)
public class MqttAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public MqttClient mqttClient(MqttProperties properties) throws MqttException {
        MqttClient mqttClient = new MqttClient(properties.getBrokerUrl(), properties.getClientId(),
                new MemoryPersistence());
        mqttClient.connect();
        return mqttClient;
    }

    @Bean
    @ConditionalOnMissingBean
    public MqttTemplate mqttTemplate(MqttClient mqttClient) {
        return new MqttTemplate(mqttClient);
    }

}

在上面的代码中，我们使用了 @ConditionalOnClass 和 @EnableConfigurationProperties 注解来控制自动配置类的启用条件和属性配置。

6. 创建配置文件

在 src/main/resources 目录下创建 application.properties 或 application.yml 文件，用于配置 MQTT 的参数。例如：

mqtt.brokerUrl=tcp://localhost:1883
mqtt.clientId=example-client

7. 测试

使用 Spring Boot 的 starter 机制，我们可以非常方便地将自定义的 MQTT Starter 引入到项目中，并直接使用 MQTT 工具类进行操作。例如：

@Autowired
private MqttTemplate mqttTemplate;

public void publishMessage(String topic, String payload) {
    mqttTemplate.publish(topic, payload.getBytes(), 0, false);
}

通过以上步骤，我们就可以将 MQTT 封装成 Spring Boot 自定义 starter，并提供 util 工具访问了。