这是个人学习MQTT协议的项目,主要记录学习过程中所写的代码,仅供参考。
- reactor-mqtt-akka: 使用AKKA进行集群内实例间通讯和集群实例管理。
- reactor-mqtt-api:服务提供的RESTful的API接口。
- reactor-mqtt-auth:认证鉴权模块,提供认证鉴权功能。
- reactor-mqtt-broker:Broker模块,服务端主程序。
- reactor-mqtt-client:客户端模块,提供连接服务的功能。
- reactor-mqtt-store: 缓存或持久化模块,提供Redis,Hbase,Ignite存储。
- reactor-mqtt-common: 基础模块。
- reactor-mqtt-protocol: 协议模块。
- reactor-mqtt-transport:消息处理模块。
- reactor-mqtt-session:MQTT session管理模块。
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO]
[INFO] reactor-mqtt-server [pom]
[INFO] reactor-mqtt-common [jar]
[INFO] reactor-mqtt-auth [jar]
[INFO] reactor-mqtt-protocol [jar]
[INFO] reactor-mqtt-akka [jar]
[INFO] reactor-mqtt-store [jar]
[INFO] reactor-mqtt-session [jar]
[INFO] reactor-mqtt-transport [jar]
[INFO] reactor-mqtt-api [jar]
[INFO] reactor-mqtt-broker [jar]
[INFO] reactor-mqtt-client [jar]
[INFO]
要运行本项目首先要保证安装以下工具,基础工具安装步骤请自行百度。
- JDK 1.8+
- SpringBoot 2.0+
- Maven 3+
- Netty 4.1+
- Ignite 2.6+
- Hbase 2.0+
- redis 3.0+
- akka 2.5.19
- guava 30.1.1
-
本项目主要是为了熟悉物联网领域常用的协议而建的项目,计划实现行业内常用的协议,如MQTT、Websocket、coAP、XMPP等物联网行业常用协议。
MQTT 协议文档:http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html
MQTT协议中文文档:http://mqtt.p2hp.com/mqtt311
-
本项目采用集群部署,支持集群内Seesion共享,采用AKKA进行集群内实例间通讯和集群实例管理。
akka官方文档:https://akka.io/docs/
-
本项目采用HBase存储消息,Redis存储连接信息。
暂缺
- 配置文件配置完成后,执行 start-hbase.sh 脚本。
[zak@hadoop001 hbase-2.2.5]$ bin/start-hbase.sh
......
hadoop001: running regionserver, logging to /opt/module/hbase-2.2.5/bin/../logs/hbase-zak-regionserver-hadoop001.out
hadoop002: running regionserver, logging to /opt/module/hbase-2.2.5/bin/../logs/hbase-zak-regionserver-hadoop002.out
hadoop003: running regionserver, logging to /opt/module/hbase-2.2.5/bin/../logs/hbase-zak-regionserver-hadoop003.out
[zak@hadoop003 bin]$ ./hbase shell
......
HBase Shell
Use "help" to get list of supported commands.
Use "exit" to quit this interactive shell.
For Reference, please visit: http://hbase.apache.org/2.0/book.html#shell
Version 2.2.5, rf76a601273e834267b55c0cda12474590283fd4c, 2020年 05月 21日 星期四 18:34:40 CST
Took 0.0027 seconds
hbase(main):001:0> list
......
hbase(main):020:0> create 'reactor-mqtt-message', 'message'
Created table reactor-mqtt-message
Took 0.7811 seconds
=> Hbase::Table - reactor-mqtt-message
......
hbase(main):021:0> list
TABLE
reactor-mqtt-message
user
2 row(s)
Took 0.0075 seconds
=> ["reactor-mqtt-message", "user"]
hbase(main):022:0>
直接运行 reactor-mqtt-broker 模块中的 BrokerApplication 主程序即可启动。当控制台出现以下信息时表示启动成功:
o.s.b.web.embedded.netty.NettyWebServer : Netty started on port(s): 8800
c.s.iot.mqtt.server.BrokerApplication : Started BrokerApplication in 5.993 seconds (JVM running for 6.847)
c.s.i.m.p.proto.mqtt.MqttTransport : mqtt protocol host: localhost port: 1800
c.s.i.m.protocol.proto.ws.WsTransport : websocket protocol host: localhost port: 1802
# 开发环境配置
server:
# Http协议端口
port: 8800
spring:
akka:
# Akka 系统名称
system-name: reactorActorSystem
# 配置文件
config: application.conf
cache:
# 缓存类型,支持:memory、ignite、redis
mode: memory
hbase:
# Hbase 配置
master: hadoop001:16010
# ZK集群
quorum: hadoop001,hadoop002,hadoop003
# HDFS 上存储的路径
root-dir: hdfs://hadoop001:9000/hbase
# HBase 的根 ZNode
znode-parent: /hbase
# 客户端端口
client-port: 2181
# Session 超时时间
session-timeout: 60000
# RPC 超时时间
rpc-timeout: 60000
# 操作超时时间
operation-timeout: 30000
# Scanner超时时间
scanner-timeout: 200000
# SSL 是否启用
ssl-enabled: false
# 是否启用分布式
distributed: true
mqtt:
broker:
# 主机地址
host: localhost
# MQTT端口
port: 1800
# Websocket端口
ws-port: 1802
# CoAP端口
co-port: 1804
# XMPP 端口
xm-port: 1806
# 心跳时间(秒)
heart: 100000
#开启日志
enable-log: true
#开启SSL
enable-ssl: false
#队列长度
backlog: 128
# 连接保活
keep-alive: false
# 开启Epoll模式, linux下建议开启
use-epoll: false
ignite:
# broker唯一标识
instance-name: reactor-mqtt-broker
# 开启组播方式集群
enable-multicast-group: false
# 组播地址
multicast-group: 239.255.255.255
#IP地址
static-ip-addresses: 127.0.0.1:47500..47509
# 持久化缓存内存初始化大小(MB)
persistence-initial-size: 64
# 持久化缓存占用内存最大值(MB)
persistence-max-size: 128
# 非持久化缓存内存初始化大小(MB)
not-persistence-initial-size: 64
# 非持久化缓存占用内存最大值(MB)
not-persistence-max-size: 128
# 持久化磁盘存储路径
persistence-store-path: ./mqtt-broker/persistence
redis:
# Redis 地址
host: 10.20.1.182
# Redis 端口
port: 6379
# 数据库
database: 0
- 使用自带的Client连接
直接在 reactor-mqtt-client 模块中运行 TestConsumer类即可。当控制台打印以下日志时说明连接成功:
c.s.i.mqtt.protocol.mqtt.MqttTransport : connected successes
- 使用客户端工具连接
配置参数如图所示,配置完成后点击连接按钮。
连接成功后如图所示:
连接成功后可以通过客户端工具的Topic正常发布消息。也可以使用 reactor-mqtt-client 模块中运行 TestProducer类发布消息。
- MQTT Broker 的基本逻辑。
- MQTT Broker 实例间通Topic发布订阅消息。
- MQTT client 的连接逻辑。
- HBase 存储的功能封装。
- Redis 工具类。
- Akka进群管理功能及实例间通讯工具。
- 常用的工具类。
- ignite的基础配置。
- 认证模块。
- metric基础模块。
- MQTT Broker 功能完成,集群内Session共享。
- MQTT 消息队列支持,保证消息的有序性。
- 连接对象的存储。
- Akka集群内实例掉线后的处理。
- metric功能完善。
- coAP、XMPP、Websocket协议支持。
- 代码优化,重构。
- 功能测试和压力测试。
本项目没有经过严格的功能测试,没有压力测试,没有上过生产,请谨慎使用。
根据学习进度,持续更新....
欢迎大家指出不足,如有任何疑问,请邮件联系 [email protected] 或者直接修复并提交 Pull Request。