Stwzhj-Cloud-Plus/stwzhj-modules/stwzhj-kafka-producer/README.md

52 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# stwzhj-kafka-producer 服务说明
## 功能描述
接收来自消费者服务的HTTP请求并将消息发送到华为认证的Kafka。
## 配置说明
本服务的华为Kafka认证配置从服务器上的以下文件读取
- `/shengting/gpsstore/producer.properties`: Kafka生产者配置
- `/shengting/gpsstore/krb5.conf`: Kerberos配置文件
- `/shengting/gpsstore/user.keytab`: Kerberos认证keytab文件
- `/shengting/gpsstore/kafkaSecurityMode`: 安全模式开关
这些配置文件与原服务保持一致确保华为Kafka认证完全兼容。
## 启动示例
```bash
java -jar stwzhj-kafka-producer.jar
```
## 高吞吐量优化
1. **异步发送**: 支持异步发送消息,提高并发处理能力
2. **批量发送**: 配合Kafka的批量发送机制提高吞吐量
3. **连接复用**: HTTP连接复用减少连接建立开销
## 注意事项
1. 确保服务器上的华为Kafka认证配置文件存在且配置正确
2. 服务启动时会自动读取服务器上的配置文件,无需手动配置
3. 监控Kafka发送成功率及时发现和处理异常
## API接口
### 批量接收消息
**URL**: `/api/kafka/batch`
**方法**: POST
**请求体**: JSON数组包含多条消息
```json
["message1", "message2", "message3"]
```
**响应**:
- 成功: 200 OK, "发送成功"
- 失败: 500 Internal Server Error, "发送失败" 或 "处理异常: xxx"