mqttjar包_MQTT客户端代码 -- JAVA fusesource mqtt-client

转：http://ywx217.iteye.com/blog/1797463

MQTT是一款针对机对机(M2M)通信的，非常轻量级的的消息订阅、发布协议。它适用于一些系统资源和网络带宽非常有限的情况下的远程连接。MQTT-Client提供一个ASL 2.0证书下的MQTT接口。在网络连接失败时，它能够自动地重新连接服务器并尝试恢复会话。应用程序能够使用阻塞API、基于Future的API和回调API，共三种接口形式。

在Maven中引用MQTT-Client

将下列文本加入到pom.xml文件中。

org.fusesource.mqtt-client

mqtt-client

1.0-SNAPSHOT

fusesource.snapshots

FuseSource Snapshot Repository

http://repo.fusesource.com/nexus/content/repositories/snapshots

true

false

以其他方式引用MQTT-Client

下载uber jar文件并加入编译路径中，该jar文件中包含MQTT-Client的所有依赖。

在Java 1.4环境中使用

作者同时提供了适用于Java 1.4的API。由于Java1.4中没有SSLEngine类依赖的NIO，因此该API不支持SSL连接。

配置MQTT连接

前面提到的阻塞、Future和回调这3种API，建立连接时使用的代码时完全相同的。首先新建一个MQTT对象并配置连接参数。在连接前至少要调用setHost方法，来指定所要连接的服务器地址。

MQTT mqtt = new MQTT();

mqtt.setHost("localhost", 1883);

// or

mqtt.setHost("tcp://localhost:1883");

MQTT设置说明

setClientId：用于设置客户端会话的ID。在setCleanSession(false);被调用时，MQTT服务器利用该ID获得相应的会话。此ID应少于23个字符，默认根据本机地址、端口和时间自动生成。

setCleanSession：若设为false，MQTT服务器将持久化客户端会话的主体订阅和ACK位置，默认为true。

setKeepAlive：定义客户端传来消息的最大时间间隔秒数，服务器可以据此判断与客户端的连接是否已经断开，从而避免TCP/IP超时的长时间等待。

setUserName：服务器认证用户名。

setPassword：服务器认证密码。

setWillTopic：设置“遗嘱”消息的话题，若客户端与服务器之间的连接意外中断，服务器将发布客户端的“遗嘱”消息。

setWillMessage：设置“遗嘱”消息的内容，默认是长度为零的消息。

setWillQos：设置“遗嘱”消息的QoS，默认为QoS.ATMOSTONCE。

setWillRetain：若想要在发布“遗嘱”消息时拥有retain选项，则为true。

失败重连接设置说明

网络出现故障时，程序能够自动重新连接并重建会话。利用下列方法能够配置重新连接的间隔和最大重试次数：

setConnectAttemptsMax：客户端首次连接到服务器时，连接的最大重试次数，超出该次数客户端将返回错误。-1意为无重试上限，默认为-1。

setReconnectAttemptsMax：客户端已经连接到服务器，但因某种原因连接断开时的最大重试次数，超出该次数客户端将返回错误。-1意为无重试上限，默认为-1。

setReconnectDelay：首次重连接间隔毫秒数，默认为10ms。

setReconnectDelayMax：重连接间隔毫秒数，默认为30000ms。

setReconnectBackOffMultiplier：设置重连接指数回归。设置为1则停用指数回归，默认为2。

Socket设置说明

可以利用下列方法调整socket设置：

setReceiveBufferSize：设置socket接收缓冲区大小，默认为65536(64k)。

setSendBufferSize：设置socket发送缓冲区大小，默认为65536(64k)。

setTrafficClass：设置发送数据包头的流量类型或服务类型字段，默认为8，意为吞吐量最大化传输。

带宽限制设置说明

可通过下述方法设置读写速率限制：

setMaxReadRate：设置连接的最大接收速率，单位为bytes/s。默认为0，即无限制。

setMaxWriteRate：设置连接的最大发送速率，单位为bytes/s。默认为0，即无限制。

使用SSL连接

如果想使用SSL/TLS连接，替代TCP连接，可以使用“ssl://”或“tls://”作为连接URI前缀，实现安全连接。支持的协议包括：

ssl:// - 使用JVM默认版本的SSL算法。

sslv*:// - 使用指定版本的SSL算法，星号为JVM支持的SSL算法版本，例如sslv3。

tls:// - 使用JVM默认版本的TLS算法。

tlsv*:// - 使用指定版本的TLS算法，星号为JVM支持的TLS算法版本，例如tlsv1.1。

客户端使用JVM的SSLContext，基于在JVM的系统配置进行连接。可以调用MQTT的setSslContext方法，换用其他连接方式。

对于内部线程池，SSL连接为阻塞特性。调用setBlockingExecutor方法可以替换所要使用的executor。

选择消息分发队列

若没有调用方法setDispatchQueue，客户端将为连接新建一个队列。如果想实现多个连接使用公用的队列，显式地指定队列是一个非常方便的实现方法。

使用阻塞API

MQTT.connectBlocking方法建立并返回一个阻塞API连接。

BlockingConnection connection = mqtt.blockingConnection();

connection.connect();

connection.publish("foo", "Hello".toBytes(), QoS.AT_LEAST_ONCE, false);

Topic[] topics = {new Topic("foo", QoS.AT_LEAST_ONCE)};

byte[] qoses = connection.subscribe(topics);

Message message = connection.receive();

System.out.println(message.getTopic());

byte[] payload = message.getPayload();

// process the message then:

message.ack();

connection.disconnect();

使用基于Future的API

MQTT.connectFuture方法建立并返回一个基于Future类型的API连接。所有连接操作都是非阻塞的，连接结果通过Future对象返回。

FutureConnection connection = mqtt.futureConnection();

Future f1 = connection.connect();

f1.await();

Future f2 = connection.subscribe(new Topic[]{new Topic(utf8("foo"), QoS.AT_LEAST_ONCE)});

byte[] qoses = f2.await();

// We can start future receive..

Future receive = connection.receive();

// send the message..

Future f3 = connection.publish("foo", "Hello".getBytes(), QoS.AT_LEAST_ONCE, false);

// Then the receive will get the message.

Message message = receive.await();

message.ack();

Future f4 connection.disconnect();

f4.await();

使用回调API

MQTT.connectCallback方法建立并返回一个回调API连接。本方法是三种API中最复杂也是性能最好的API，前面提到的两种API其实都是对回调API的封装。对连接的所有操作都是非阻塞的，返回的结果将传至回调接口函数。示例如下：

final CallbackConnection connection = mqtt.callbackConnection();

connection.listener(new Listener() {

public void onDisconnected() {

}

public void onConnected() {

}

public void onSuccess(UTF8Buffer topic, Buffer payload, Runnable ack) {

// You can now process a received message from a topic.

// Once process execute the ack runnable.

ack.run();

}

public void onFailure(Throwable value) {

connection.close(null); // a connection failure occured.

}

})

connection.connect(new Callback() {

public void onFailure(Throwable value) {

result.failure(value); // If we could not connect to the server.

}

// Once we connect..

public void onSuccess(Void v) {

// Subscribe to a topic

Topic[] topics = {new Topic("foo", QoS.AT_LEAST_ONCE)};

connection.subscribe(topics, new Callback() {

public void onSuccess(byte[] qoses) {

// The result of the subcribe request.

}

public void onFailure(Throwable value) {

connection.close(null); // subscribe failed.

}

});

// Send a message to a topic

connection.publish("foo", "Hello".getBytes(), QoS.AT_LEAST_ONCE, false, new Callback() {

public void onSuccess(Void v) {

// the pubish operation completed successfully.

}

public void onFailure(Throwable value) {

connection.close(null); // publish failed.

}

});

// To disconnect..

connection.disconnect(new Callback() {

public void onSuccess(Void v) {

// called once the connection is disconnected.

}

public void onFailure(Throwable value) {

// Disconnects never fail.

}

});

}

});