# message-conversion

**Repository Path**: ZhimingMa/message-conversion

## Basic Information

- **Project Name**: message-conversion
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-05
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 消息转换服务 (Message Conversion Service)

这是一个基于Spring Boot的消息转换服务，主要功能是通过MQTT协议接收消息并转换为HTTP请求发送到目标服务器。该项目适用于物联网（IoT）场景下的消息处理与转发。

## 功能概述

- **MQTT消息处理**：接收来自MQTT客户端的消息，并进行解析。
- **HTTP请求转发**：将解析后的消息通过HTTP协议转发到指定的服务端。
- **身份验证支持**：支持基于Token的身份验证机制。
- **配置灵活**：通过配置文件可灵活配置MQTT服务器、HTTP客户端和认证信息。

## 模块结构

- `MessageConversionApplication`：Spring Boot主启动类。
- `MessageConversionThreadLocal`：线程上下文管理类，用于保存请求相关的信息。
- `HttpClient`：HTTP客户端配置类，定义REST客户端Bean。
- `MqttServer`：MQTT服务器配置类，初始化MQTT Broker服务。
- `AuthResponseModel`, `CommonResponse`, `DataReportModel`：数据模型类，用于封装响应和上报数据。
- `AuthProperties`, `MqttProperties`：配置属性类，从配置文件中加载认证和MQTT相关参数。
- `CustomizeInterceptHandler`：MQTT拦截处理器，处理连接、发布、订阅等事件。
- `HttpPushHandler`：HTTP推送处理器，负责消息转发、身份验证等逻辑。

## 配置说明

请参考`application.yml`文件进行相关配置，主要包括：

- MQTT服务器地址与端口
- HTTP客户端基础URL
- 身份验证的AppKey与AppSecret

## 使用说明

1. **启动服务**：运行`MessageConversionApplication`启动Spring Boot应用。
2. **MQTT连接**：客户端连接至MQTT服务器并发布消息。
3. **消息处理**：服务端接收到消息后，通过`CustomizeInterceptHandler`处理消息，并调用`HttpPushHandler`转发至目标HTTP服务。

## 依赖管理

使用Maven进行依赖管理，请参考`pom.xml`文件查看所有依赖项。

## 贡献指南

欢迎提交PR或Issue。请确保遵循项目编码规范，并提供必要的测试用例。

## 许可证

本项目采用Apache 2.0协议，请详见`LICENSE`文件。