MQTT(Message Queuing Telemetry Transport,消息队列遥测传输)
最早是IBM开发的一个即时通讯协议,MQTT协议是为大量计算能力有限且工作在低带宽、
不可靠网络的远程传感器和控制设备通讯而设计的一种协议。从当前物联网应用发展趋势
来分析,MQTT协议具有一定的优势。因为目前国内外主要的云计算服务商,比如阿里云、
AWS、百度云、Azure以及腾讯云都一概支持MQTT协议,有可能成为物联网的重要组成部分。
MQTT的Software已经迁移到了Github上,Brokers/servers中有众多MQTT的实现方式,其中 Moquette是基于Netty模型的一个纯Java MQTT代理。Moquette是由Google团队参与开发讨论,它的设计初衷是为了使用Netty作为协议编码和解码的部分。(Tip:Netty是由JBOSS提供的一个java开源框架。Netty提供异步的、事件驱动的网络应用程序框架和工具,用以快速开发高性能、高可靠性的网络服务器和客户端程序。也就是说,Netty是一个基于NIO的客户、服务器端编程框架,使用Netty可以确保你快速和简单的开发出一个网络应用,例如实现了某种协议的客户,服务端应用。Netty相当简化和流线化了网络应用的编程开发过程,例如,TCP和UDP的socket服务开发。)
从BinTray下载tar包,在bin文件夹下有.bat和.sh两个脚本文件。
其中moquette.sh是在linux系统运行的脚本
tar zxf distribution-0.10-bundle-tar.tar.gz
cd bin
./moquette.sh
moquette.bat是在DOS和Windows系统运行的脚本
cd bin
.\moquette.bat
运行moquette.sh或moquette.bat便可启动端口为1883的代理。我们接下来看看脚本都做了什么工作
moquette.bat配置内容
rem #
#关闭回显,不显示下面的命令;“echo off”也是命令,它本身也会显示,
#如果连这条也不显示,就在前面加个“@”。
rem #
@ECHO OFF
rem rem表示注释
rem #
rem # Copyright (c) 2012-2015 Andrea Selva
rem #
echo " "
echo " ___ ___ _ _ ___ ________ _____ _____ "
echo " | \/ | | | | | | \/ | _ |_ _|_ _| "
echo " | . . | ___ __ _ _ _ ___| |_| |_ ___ | . . | | | | | | | | "
echo " | |\/| |/ _ \ / _\ | | | |/ _ \ __| __/ _ \ | |\/| | | | | | | | | "
echo " | | | | (_) | (_| | |_| | __/ |_| || __/ | | | \ \/' / | | | | "
echo " \_| |_/\___/ \__, |\__,_|\___|\__|\__\___| \_| |_/\_/\_\ \_/ \_/ "
echo " | | "
echo " |_| "
echo " "
rem #
#设置CURRENT_DIR环境变量为当前目录 注:%cd%的值为当前目录的值
#如果一个名称用%括起来,那么就是用的它的赋值,而不是本身的字母
rem #
set "CURRENT_DIR=%cd%"
rem 如果设置了MOQUETTE_HOME环境变量 ,就直接到下面的gotHome处
if not "%MOQUETTE_HOME%" == "" goto gotHome
rem 如果没有设置MOQUETTE_HOME环境变量,就设置MOQUETTE_HOME为CURRENT_DIR(当前目录)
set "MOQUETTE_HOME=%CURRENT_DIR%"
rem 如果在指定目录是否能找到moquette.bat,找到了就直接跳到下面的okHome处
if exist "%MOQUETTE_HOME%\bin\moquette.bat" goto okHome
rem 如果没有找到,就退到当前目录的上一级目录
cd ..
rem 打印结果 cd .. :"上一级目录"
echo cd .. :"%cd%"
rem 重新设置MOQUETTE_HOME环境变量为上一级目录
set "MOQUETTE_HOME=%cd%"
rem 进入CURRENT_DIR环境变量代表的目录
cd "%CURRENT_DIR%"
:gotHome
rem 再次判断moquette.bat是否找到了,找到了就直接跳到下面的okHome处,没有的话,就打印如下提示信息
if exist "%MOQUETTE_HOME%\bin\moquette.bat" goto okHome
echo The MOQUETTE_HOME environment variable is not defined correctly
echo This environment variable is needed to run this program
goto end
:okHome
rem #
#Set JavaHome if it exists
#环境变量中是否存在JAVA_HOME这个系统变量且有值,并存在%JAVA_HOME%\bin\java路径
rem #
if exist { "%JAVA_HOME%\bin\java" } (
rem 存在则把路径复制给JAVA
set "JAVA="%JAVA_HOME%\bin\java""
)
echo Using JAVA_HOME: "%JAVA_HOME%"
echo Using MOQUETTE_HOME: "%MOQUETTE_HOME%"
rem set LOG_CONSOLE_LEVEL=info ,控制台级别-日志
rem set LOG_FILE_LEVEL=fine ,文件级别---日志
rem #
# 以下设置Java虚拟机(JVM)相关运行参数的变量
rem #
set JAVA_OPTS=
rem #
#使用了标志-XX:+HeapDumpOnOutOfMemoryError
#JVM会在遇到OutOfMemoryError(内存外溢)时拍摄一个“堆转储快照”,并将其保存在一个文件中.
#如果没有安装图形界面,Linux/Unix上的时候有可能出现图形不能显示的错误
#可以在Java运行时加上参数:-Djava.awt.headless=true
rem #
set JAVA_OPTS_SCRIPT=-XX:+HeapDumpOnOutOfMemoryError -Djava.awt.headless=true
rem #为MOQUETTE_PATH赋值%MOQUETTE_HOME%路径
set MOQUETTE_PATH=%MOQUETTE_HOME%
rem #为LOG_FILE赋值日志路径
set LOG_FILE=%MOQUETTE_HOME%\config\moquette-log.properties
rem #
#使用G1垃圾回收器,适用于堆内存很大的情况,G1垃圾回收器会优先选择第一块垃圾最多的区域
## Use the Hotspot garbage-first collector.
rem #
set JAVA_OPTS=%JAVA_OPTS% -XX:+UseG1GC
rem #
#高吞吐低延迟
#设置GC evacuation(疏散)阶段期间G1 GC更新RSets消耗时间的百分比(默认是目标停顿时间的10%)。
#你可以增大或减小百分比的值,以便在stop-the-world(STW)GC阶段花费更多或更少的时间,
#让concurrent refinement thread处理相应的缓冲区。
#记住,减少百分比的值,你在推迟concurrent refinement thread的工作;
#因此,你会看到并发任务增加。
## Have the JVM do less remembered set work during STW, instead
## preferring concurrent GC. Reduces p99.9 latency.
rem #
set JAVA_OPTS=%JAVA_OPTS% -XX:G1RSetUpdatingPauseTimePercent=5
rem #
#最大垃圾回收暂停:指定垃圾回收时的最长暂停时间.毫秒级别
#如果指定了此值的话,堆大小和垃圾回收相关参数会进行调整以达到指定值。设定此值可能会减少应用的吞吐量
#降低暂停目标时间将降低吞吐量
## Main G1GC tunable: lowering the pause target will lower throughput and vise versa.
## 200ms is the JVM default and lowest viable setting
## 1000ms increases throughput. Keep it smaller than the timeouts.
rem #
set JAVA_OPTS=%JAVA_OPTS% -XX:MaxGCPauseMillis=500
rem #
#下面为可选的G1垃圾回收器设置
## Optional G1 Settings
rem #
rem #
#设置触发标记周期的 Java 堆占用率阈值。默认占用率是整个 Java 堆的 40%
#启动并发GC周期时的堆内存占用百分比. G1之类的垃圾收集器用它来触发并发GC周期,
#基于整个堆的使用率,而不只是某一代内存的使用比.
#值为 0 则表示一直执行GC循环. 默认值为 40
# Save CPU time on large (>= 16GB) heaps by delaying region scanning
# until the heap is 70% full. The default in Hotspot 8u40 is 40%.
rem #
#set JAVA_OPTS=%JAVA_OPTS% -XX:InitiatingHeapOccupancyPercent=70
rem #
#设置垃圾收集器在并行阶段使用的线程数,默认值随JVM运行的平台不同而不同.
#设置 STW 工作线程数的值。将 n 的值设置为逻辑处理器的数量。
#n 的值与逻辑处理器的数量相同,最多为 8。
#如果逻辑处理器不止八个,则将 n 的值设置为逻辑处理器数的 5/8 左右。
#这适用于大多数情况,除非是较大的 SPARC 系统,
#其中 n 的值可以是逻辑处理器数的 5/16 左右。
# For systems with > 8 cores, the default ParallelGCThreads is 5/8 the number of logical cores.
# Otherwise equal to the number of cores when 8 or less.
# Machines with > 10 cores should try setting these to <= full cores.
rem #
#set JAVA_OPTS=%JAVA_OPTS% -XX:ParallelGCThreads=16
rem #
#并发垃圾收集器使用的线程数量. 默认值随JVM运行的平台不同而不同.
#通过采用 -XX:ConcGCThreads=n 选项增加标记线程(marking threads)的数量
#设置并行标记的线程数。将 n 设置为并行垃圾回收线程数 (ParallelGCThreads) 的 1/4 左右。
# By default, ConcGCThreads is 1/4 of ParallelGCThreads.
# Setting both to the same value can reduce STW durations.
rem #
#set JAVA_OPTS=%JAVA_OPTS% -XX:ConcGCThreads=16
rem #
#GC(Garbage Collection,垃圾收集,垃圾回收)机制
#日志选项——取消注释以启用。
### GC logging options -- uncomment to enable
rem #
rem #
#设置日志级别为 更好 finer. 使用此选项会显示以下信息:
#每个阶段的 Average, Min, 以及 Max 时间.
#根扫描(Root Scan), RSet 更新(同时处理缓冲区信息), RSet扫描(Scan), 对象拷贝(Object Copy),
#终止(Termination, 包括尝试次数).还显示 “other” 执行时间,
#比如选择 CSet, 引用处理(reference processing),引用排队(reference enqueuing)
#以及释放(freeing) CSet等.显示 Eden, Survivors 以及总的 Heap 占用信息(occupancies).
rem #
set JAVA_OPTS=%JAVA_OPTS% -XX:+PrintGCDetails
rem #在每条记录前加上日期时间
set JAVA_OPTS=%JAVA_OPTS% -XX:+PrintGCDateStamps
rem #在进行GC的前后打印出堆的信息
set JAVA_OPTS=%JAVA_OPTS% -XX:+PrintHeapAtGC
rem #
#JVM 在每次新生成GC时,输出显示在survivor空间里面有效的对象的岁数情况
#输出的方式是观察在每一个岁数上面,对象的存活的数量,
#以及其增减情况,以及HotSpot VM计算的任期阀值是不是等于或者近似于设定的最大任期阀值。
rem #
set JAVA_OPTS=%JAVA_OPTS% -XX:+PrintTenuringDistribution
rem # 输出GC造成应用暂停的时间
set JAVA_OPTS=%JAVA_OPTS% -XX:+PrintGCApplicationStoppedTime
rem #晋升失败Promotion Failed的时候打印
set JAVA_OPTS=%JAVA_OPTS% -XX:+PrintPromotionFailure
rem #
#打印每次GC前后的Heap余量。较大的余量,可以怀疑Heap中存在内存碎片过多。
#打印FLS的统计数据
rem #
#set JAVA_OPTS=%JAVA_OPTS% -XX:PrintFLSStatistics=1
rem #日志文件的输出路径
#set JAVA_OPTS=%JAVA_OPTS% -Xloggc:/var/log/moquette/gc.log
rem #使用GC日志文件的自动转储
set JAVA_OPTS=%JAVA_OPTS% -XX:+UseGCLogFileRotation
rem #GC日志文件的循环数目
set JAVA_OPTS=%JAVA_OPTS% -XX:NumberOfGCLogFiles=10
rem #控制GC日志文件的大小
set JAVA_OPTS=%JAVA_OPTS% -XX:GCLogFileSize=10M
rem #
rem #以下是启动JVM虚拟机、配置日志、jar包路径和启动
rem #
#java -server 和 java -client
#服务器模式 和 客户端模式
#这两个参数用于设置虚拟机使用何种运行模式,client模式启动比较快,
#但运行时性能和内存管理效率不如server模式,
#通常用于客户端应用程序。相反,server模式启动比client慢,但可获得更高的运行性能。
#在 windows上,缺省的虚拟机类型为client模式,如果要使用 server模式,
#就需要在启动虚拟机时加-server参数,
#以获得更高性能,对服务器端应用,推荐采用server模式,尤其是多个CPU的系统。
#在 Linux,Solaris上缺省采用server模式。
#添加log4j配置文件地址
#-cp 和 -classpath 一样,是指定类运行所依赖其他类的路径,通常是类库,jar包之类
#运行jar文件中的class
#原理和运行class文件一样,只需加上参数-cp jar文件名 即可。
#例如:执行test.jar中的类com.ee2ee.test.PackageTest,命令行如下:
#java -cp test.jar com.ee2ee.test.PackageTest
rem #
"
%JAVA% -server %JAVA_OPTS% %JAVA_OPTS_SCRIPT%
-Dlog4j.configuration=file:%LOG_FILE%
-Dmoquette.path=%MOQUETTE_PATH%
-cp %MOQUETTE_HOME%\lib\* io.moquette.server.Server
moquette.sh配置内容
#shell中#一般表示注释的意思,#!是特殊的表示符,其后面跟的是解释此脚本的shell的路径,
#如果没有声明,则脚本将在默认的shell中执行,默认shell是由用户所在的系统定义为执行shell脚本。
#下面指令指此脚本使用/bin/sh 来执行
#!/bin/sh
#
# Copyright (c) 2012-2015 Andrea Selva
#
echo " "
echo " ___ ___ _ _ ___ ________ _____ _____ "
echo " | \/ | | | | | | \/ | _ |_ _|_ _| "
echo " | . . | ___ __ _ _ _ ___| |_| |_ ___ | . . | | | | | | | | "
echo " | |\/| |/ _ \ / _\ | | | |/ _ \ __| __/ _ \ | |\/| | | | | | | | | "
echo " | | | | (_) | (_| | |_| | __/ |_| || __/ | | | \ \/' / | | | | "
echo " \_| |_/\___/ \__, |\__,_|\___|\__|\__\___| \_| |_/\_/\_\ \_/ \_/ "
echo " | | "
echo " |_| "
echo " "
#定位到当前执行脚本文件的目录
cd "$(dirname "$0")"
# $0 表示命令本身,也就是moquette.sh,赋值给PRG。解析链接 - $0可能是一个软链接。
# resolve links - $0 may be a softlink
PRG="$0"
#以下循环判断可执行文件是否是一个符号连接(symbolic link,叫软连接),如果是符号连接,找到实际指向的文件位置
#-h 表示判断一个文件存在且是一个软链接。当文件存在且是一个软链接时,判断的结果是真,执行do~done之间的脚本
#ls=`ls -ld "$PRG"` -->列出软连接的当前目录信息,只是目录,不包括目录下的子目录和文件
#link=`expr "$ls" : '.*-> .∗$'` -->expr的模式匹配方法,这里expr的返回值为软连接文件的真实路径
#if expr "$link" : '/.*' > /dev/null -->查询link字符数>1,即路径名存在并返回1
#PRG="$link" -->软连接文件的真实路径赋值给PRG
#PRG=`dirname "$PRG"`/"$link" -->定位到"$PRG"`/"$link"
while [ -h "$PRG" ]; do
ls=`ls -ld "$PRG"`
link=`expr "$ls" : '.*-> \(.*\)$'`
if expr "$link" : '/.*' > /dev/null; then
PRG="$link"
else
PRG=`dirname "$PRG"`/"$link"
fi
done
# 此时,$PRG 指向实际的文件
# Get standard environment variables
PRGDIR=`dirname "$PRG"`
#如果还没有设置,就只设置MOQUETTE_HOME
# Only set MOQUETTE_HOME if not already set
# -f filename 如果 filename为常规文件,则为真 [ -f /usr/bin/grep ]
# pwd 显示当前目录所在路径
# export MOQUETTE_HOME //定义环境变量
[ -f "$MOQUETTE_HOME"/bin/moquette.sh ] || MOQUETTE_HOME=`cd "$PRGDIR/.." ; pwd`
export MOQUETTE_HOME
# 如果JavaHome存在,设置JavaHome。
# Set JavaHome if it exists
if [ -f "${JAVA_HOME}/bin/java" ]; then
JAVA=${JAVA_HOME}/bin/java
else
JAVA=java
fi
export JAVA
#
# 以下设置Java虚拟机(JVM)相关运行参数的变量,可参照moquette.bat解释
#
#给LOG_FILE赋值日志路径
LOG_FILE=$MOQUETTE_HOME/config/moquette-log.properties
MOQUETTE_PATH=$MOQUETTE_HOME/
#LOG_CONSOLE_LEVEL=info
#LOG_FILE_LEVEL=fine
JAVA_OPTS_SCRIPT="-XX:+HeapDumpOnOutOfMemoryError -Djava.awt.headless=true"
## Use the Hotspot garbage-first collector.
JAVA_OPTS="$JAVA_OPTS -XX:+UseG1GC"
## Have the JVM do less remembered set work during STW, instead
## preferring concurrent GC. Reduces p99.9 latency.
JAVA_OPTS="$JAVA_OPTS -XX:G1RSetUpdatingPauseTimePercent=5"
## Main G1GC tunable: lowering the pause target will lower throughput and vise versa.
## 200ms is the JVM default and lowest viable setting
## 1000ms increases throughput. Keep it smaller than the timeouts.
JAVA_OPTS="$JAVA_OPTS -XX:MaxGCPauseMillis=500"
## Optional G1 Settings
# Save CPU time on large (>= 16GB) heaps by delaying region scanning
# until the heap is 70% full. The default in Hotspot 8u40 is 40%.
#JAVA_OPTS="$JAVA_OPTS -XX:InitiatingHeapOccupancyPercent=70"
# For systems with > 8 cores, the default ParallelGCThreads is 5/8 the number of logical cores.
# Otherwise equal to the number of cores when 8 or less.
# Machines with > 10 cores should try setting these to <= full cores.
#JAVA_OPTS="$JAVA_OPTS -XX:ParallelGCThreads=16"
# By default, ConcGCThreads is 1/4 of ParallelGCThreads.
# Setting both to the same value can reduce STW durations.
#JAVA_OPTS="$JAVA_OPTS -XX:ConcGCThreads=16"
### GC logging options -- uncomment to enable
JAVA_OPTS="$JAVA_OPTS -XX:+PrintGCDetails"
JAVA_OPTS="$JAVA_OPTS -XX:+PrintGCDateStamps"
JAVA_OPTS="$JAVA_OPTS -XX:+PrintHeapAtGC"
JAVA_OPTS="$JAVA_OPTS -XX:+PrintTenuringDistribution"
JAVA_OPTS="$JAVA_OPTS -XX:+PrintGCApplicationStoppedTime"
JAVA_OPTS="$JAVA_OPTS -XX:+PrintPromotionFailure"
#JAVA_OPTS="$JAVA_OPTS -XX:PrintFLSStatistics=1"
#JAVA_OPTS="$JAVA_OPTS -Xloggc:/var/log/moquette/gc.log"
JAVA_OPTS="$JAVA_OPTS -XX:+UseGCLogFileRotation"
JAVA_OPTS="$JAVA_OPTS -XX:NumberOfGCLogFiles=10"
JAVA_OPTS="$JAVA_OPTS -XX:GCLogFileSize=10M"
#
# 以下是启动JVM虚拟机、配置日志、jar包路径和启动,可参照moquette.bat解释
#
$JAVA -server $JAVA_OPTS $JAVA_OPTS_SCRIPT
-Dlog4j.configuration="file:$LOG_FILE"
-Dmoquette.path="$MOQUETTE_PATH"
-cp "$MOQUETTE_HOME/lib/*" io.moquette.server.Server