Android端使用MQTT协议

Android端MQTT协议的使用

由于公司开发智能终端产品，使用MQTT协议进行通信，特记录一下，需要了解原理和服务器端的请移步

一、MQTT协议

MQTT（Message Queuing Telemetry Transport，消息队列遥测传输）是IBM开发的一个即时通讯协议，有可能成为物联网的重要组成部分。该协议支持所有平台，几乎可以把所有联网物品和外部连接起来，被用来当做传感器和制动器（比如通过Twitter让房屋联网）的通信协议。

MQTT协议是为大量计算能力有限，且工作在低带宽、不可靠的网络的远程传感器和控制设备通讯而设计的协议，它具有以下主要的几项特性：

1、使用发布/订阅消息模式，提供一对多的消息发布，解除应用程序耦合；

2、对负载内容屏蔽的消息传输；

3、使用 TCP/IP 提供网络连接；

4、有三种消息发布服务质量：

MQTT协议通信过程

二、MQTT协议的数据格式

MqttMessage

    private boolean mutable = true;
    private byte[] payload;
    private int qos = 1;
    private boolean retained = false;
    private boolean dup = false;

三、MQTT协议在Android端的集成

在app的build.gradle中添加依赖。或者自己去网上下载对应版本的jar包也可以。

 

repositories {

    maven {

       url"https://repo.eclipse.org/content/repositories/paho-releases/"

    }

}

 

dependencies {

    compile 'org.eclipse.paho:org.eclipse.paho.client.mqttv3:1.1.0'

    compile 'org.eclipse.paho:org.eclipse.paho.android.service:1.1.0'

}

 

 

注意记得在manifest.xml文件中配置权限

<uses-permission android:name="android.permission.INTERNET" />

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<uses-permission android:name="android.permission.WAKE_LOCK" />

 

四、MQTT的连接配置

if(client==null || !client.isConnected()){
            try {
                //设置连接指定的额ip，连接人
                client = new MqttClient(host, clientId, new MemoryPersistence());
                //开始设置连接时的参数
                options = new MqttConnectOptions();
                //设置是否清空session,这里如果设置为false表示服务器会保留客户端的连接记录，这里
                设置为true表示每次连接到服务器都以新的身份连接
                options.setCleanSession(true);
                //设置连接用户名
                options.setUserName(userName);
                //设置连接密码
                options.setPassword(passWord.toCharArray());
                //设置超时连接
                options.setConnectionTimeout(10);
                //设置心跳间隔
                options.setKeepAliveInterval(20);
                //设置当连接断开时发送的死亡预告，当这句被接受到时 证明本连接断开
               //options.setWill(publishTopic, (clientId+"destroy").getBytes(), 0, true);
                //连接回调函数
                client.setCallback(new MqttCallback() {
                    @Override
                    public void messageArrived(String topicName, MqttMessage message) throws Exception {
                        String srt2=new String(message.getPayload(),"UTF-8");
                        Log.i("subscribe","--->"+srt2);
                        // TODO Auto-generated method stub
                        Message msg = new Message();
                        msg.what=1;
                        msg.obj=srt2;
                        handler.sendMessage(msg);
                    }
                    @Override
                    public void deliveryComplete(IMqttDeliveryToken token) {
                        // TODO Auto-generated method stub
                        Log.i("connect","--->deliver Success");
                    }

                    @Override
                    public void connectionLost(Throwable cause) {
                        // TODO Auto-generated method stub
                        Log.i("connect","--->connect lost");
                    }
                });
                client.connect(options);
                client.subscribe(subTopics, subQos);
            } catch (MqttSecurityException e){
                Log.i("connect","--->SecurityFailed"+e.getMessage());
            } catch (MqttException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
                Log.i("connect","--->failed"+e.getMessage());
            }
        }

五、订阅消息

在callback中的messageArrived中做处理

@Override

public void messageArrived(String topicName, MqttMessage message) throws Exception {

    String srt2=new String(message.getPayload(),"UTF-8");

    Log.i("subscribe","--->"+srt2);

    // TODO Auto-generated method stub

    Message msg = new Message();

    msg.what=1;

    msg.obj=srt2;

    handler.sendMessage(msg);

 

六、发送消息

public void sendMessage(String msg) {
        if (client != null && client.isConnected()) {
           Log.i("connect" ,"--->呀!MQTT发送消息了:"+ msg);
            try {
                MqttMessage message = new MqttMessage();
                //设置消息传输的类型 0,1,2可选
                message.setQos(2);
                //设置是否在服务器中保存消息体
                message.setRetained(false);
                //设置消息的内容
                message.setPayload(msg.getBytes());
                //循环发送，因为一次只能一个
                for (String publishTopic : publishTopics) {
                    topic = client.getTopic(publishTopic);
                    MqttDeliveryToken token = topic.publish(message);
                    token.waitForCompletion();
                }
            } catch (MqttPersistenceException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            } catch (MqttException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            } catch (NullPointerException e) {
                // TODO: handle exception
                e.printStackTrace();
            }
        }
        else if (client==null){
           Log.i("connect","---->client null");
        }
        else if (!client.isConnected()){
            Log.i("connect","---->client disconnect");
        }
    }