mqtt client api: 阻塞API

fusesource版本：mqtt-client-1.11.jar
下载地址：https://github.com/fusesource/mqtt-client

fusesource提供三种mqtt client api: 阻塞API，基于Futur的API和回调API。其中，回调API是最复杂的也是性能最好的，另外两种均是对回调API的封装。 我们下面就简单介绍一下回调API的使用方法。

import org.fusesource.hawtbuf.Buffer;
import org.fusesource.hawtbuf.UTF8Buffer;
import org.fusesource.hawtdispatch.Dispatch;
import org.fusesource.hawtdispatch.DispatchQueue;
import org.fusesource.mqtt.client.BlockingConnection;
import org.fusesource.mqtt.client.Callback;
import org.fusesource.mqtt.client.CallbackConnection;
import org.fusesource.mqtt.client.FutureConnection;
import org.fusesource.mqtt.client.Listener;
import org.fusesource.mqtt.client.MQTT;
import org.fusesource.mqtt.client.Message;
import org.fusesource.mqtt.client.QoS;
import org.fusesource.mqtt.client.Topic;
import org.fusesource.mqtt.client.Tracer;
import org.fusesource.mqtt.codec.MQTTFrame; 
public class MqttClient {
public static void main(String[] args)
{
 try {
   MQTT mqtt=new MQTT();
   
   //MQTT设置说明
   mqtt.setHost("tcp://10.1.58.191:1883");
   mqtt.setClientId("876543210"); //用于设置客户端会话的ID。在setCleanSession(false);被调用时，MQTT服务器利用该ID获得相应的会话。此ID应少于23个字符，默认根据本机地址、端口和时间自动生成
   mqtt.setCleanSession(false); //若设为false，MQTT服务器将持久化客户端会话的主体订阅和ACK位置，默认为true
   mqtt.setKeepAlive((short) 60);//定义客户端传来消息的最大时间间隔秒数，服务器可以据此判断与客户端的连接是否已经断开，从而避免TCP/IP超时的长时间等待
   mqtt.setUserName("admin");//服务器认证用户名
   mqtt.setPassword("admin");//服务器认证密码
   
   mqtt.setWillTopic("willTopic");//设置“遗嘱”消息的话题，若客户端与服务器之间的连接意外中断，服务器将发布客户端的“遗嘱”消息
   mqtt.setWillMessage("willMessage");//设置“遗嘱”消息的内容，默认是长度为零的消息
   mqtt.setWillQos(QoS.AT_LEAST_ONCE);//设置“遗嘱”消息的QoS，默认为QoS.ATMOSTONCE
   mqtt.setWillRetain(true);//若想要在发布“遗嘱”消息时拥有retain选项，则为true
   mqtt.setVersion("3.1.1");
   
   //失败重连接设置说明
   mqtt.setConnectAttemptsMax(10L);//客户端首次连接到服务器时，连接的最大重试次数，超出该次数客户端将返回错误。-1意为无重试上限，默认为-1
   mqtt.setReconnectAttemptsMax(3L);//客户端已经连接到服务器，但因某种原因连接断开时的最大重试次数，超出该次数客户端将返回错误。-1意为无重试上限，默认为-1
   mqtt.setReconnectDelay(10L);//首次重连接间隔毫秒数，默认为10ms
   mqtt.setReconnectDelayMax(30000L);//重连接间隔毫秒数，默认为30000ms
   mqtt.setReconnectBackOffMultiplier(2);//设置重连接指数回归。设置为1则停用指数回归，默认为2
   
   //Socket设置说明
         mqtt.setReceiveBufferSize(65536);//设置socket接收缓冲区大小，默认为65536（64k）
         mqtt.setSendBufferSize(65536);//设置socket发送缓冲区大小，默认为65536（64k）
         mqtt.setTrafficClass(8);//设置发送数据包头的流量类型或服务类型字段，默认为8，意为吞吐量最大化传输
         
         //带宽限制设置说明
         mqtt.setMaxReadRate(0);//设置连接的最大接收速率，单位为bytes/s。默认为0，即无限制
         mqtt.setMaxWriteRate(0);//设置连接的最大发送速率，单位为bytes/s。默认为0，即无限制
         
         //选择消息分发队列
         mqtt.setDispatchQueue(Dispatch.createQueue("foo"));//若没有调用方法setDispatchQueue，客户端将为连接新建一个队列。如果想实现多个连接使用公用的队列，显式地指定队列是一个非常方便的实现方法
   
         //设置跟踪器
   mqtt.setTracer(new Tracer(){
             @Override
             public void onReceive(MQTTFrame frame) {
                 System.out.println("recv: "+frame);
             } 
             @Override
             public void onSend(MQTTFrame frame) {
                 System.out.println("send: "+frame);
             } 
             @Override
             public void debug(String message, Object... args) {
                 System.out.println(String.format("debug: "+message, args));
             }
         });
   
   
   
         //使用回调式API
   final CallbackConnection callbackConnection=mqtt.callbackConnection();
   
   //连接监听
   callbackConnection.listener(new Listener() {
   
   //接收订阅话题发布的消息
   @Override
   public void onPublish(UTF8Buffer topic, Buffer payload, Runnable onComplete) {
    System.out.println("=============receive msg================"+new String(payload.toByteArray()));
     onComplete.run();
   }
   
   //连接失败
   @Override
   public void onFailure(Throwable value) {
    System.out.println("===========connect failure===========");
    callbackConnection.disconnect(null);
   }
   
      //连接断开
   @Override
   public void onDisconnected() {
    System.out.println("====mqtt disconnected=====");
    
   }
   
   //连接成功
   @Override
   public void onConnected() {
    System.out.println("====mqtt connected=====");
    
   }
  });
   
   
   
   //连接
   callbackConnection.connect(new Callback() {
    
     //连接失败
       public void onFailure(Throwable value) {
           System.out.println("============连接失败："+value.getLocalizedMessage()+"============");
       } 
       // 连接成功
       public void onSuccess(Void v) { 
           //订阅主题
           Topic[] topics = {new Topic("foo", QoS.AT_LEAST_ONCE)};
           callbackConnection.subscribe(topics, new Callback<byte[]>() {
               //订阅主题成功
            public void onSuccess(byte[] qoses) {
                   System.out.println("========订阅成功=======");
               }
            //订阅主题失败
               public void onFailure(Throwable value) {
                System.out.println("========订阅失败=======");
                callbackConnection.disconnect(null);
               }
           });
           
           
            //发布消息
           callbackConnection.publish("foo", ("Hello ").getBytes(), QoS.AT_LEAST_ONCE, true, new Callback() {
               public void onSuccess(Void v) {
                 System.out.println("===========消息发布成功============");
               }
               public void onFailure(Throwable value) {
                System.out.println("========消息发布失败=======");
                callbackConnection.disconnect(null);
               }
           }); 
  
       }
   });
   
   
   
   while(true)
   {
    
   }
 
  
 } catch (Exception e) {
  e.printStackTrace();
 } 
  
}
}