Android APP必备高级功能，消息推送之MQTT

转：http://blog.csdn.net/qq_17250009/article/details/52774472

标签： android消息推送MQTT长连接apollo

2016-10-10 09:15 7443人阅读 评论(24) 收藏 举报

分类：

Android 应用篇（12）

作者同类文章 X

版权声明：本文为博主原创文章，转载请征得博主同意并注明出处。

目录(?)[+]

1. Android端实现消息推送的几种方式
2. MQTT简介
3. MQTT服务器搭建
4. MQTT Android客户端具体实现
   1. 基本概念
   2. 添加依赖
   3. 添加限权
   4. 注册Service
   5. Android端具体实现

本文已授权微信公众号《鸿洋》原创首发，转载请务必注明出处。

1. Android端实现消息推送的几种方式

1. 轮询：客户端定时向服务器请求数据。伪推送。缺点：费电，费流量。
2. 拦截短信消息。服务器需要向客户端发通知时，发送一条短信，客户端收到特定短信之后，先获取信息，然后拦截短信。伪推送。缺点：贵而且短信可能被安全软件拦截。
3. 持久连接(Push)方式：客户端和服务器之间建立长久连接。真正的推送。
   
   1. Google的C2DM（Cloudto Device Messaging）。需要科学上网，国内大多数用户无法使用。
   2. XMPP。XMPP(可扩展通讯和表示协议)是基于可扩展标记语言（XML）的协议。androidpn是一个基于XMPP协议的java开源Android push notification实现。它包含了完整的客户端和服务器端。
   3. MQTT。MQTT是一个轻量级的消息发布/订阅协议，它是实现基于手机客户端的消息推送服务器的理想解决方案。

2. MQTT简介

MQTT官网：http://mqtt.org/

MQTT介绍：http://www.ibm.com

MQTT Android github：https://github.com/eclipse/paho.mqtt.android

MQTT API：http://www.eclipse.org/paho/files/javadoc/index.html

MQTT Android API： http://www.eclipse.org/paho/files/android-javadoc/index.html

建议时间充裕的同学有顺序的阅读上文五个链接内容，不充裕的同学请看下面简单的介绍（内容大多来自上面五条链接）。

MQTT 协议
客户机较小并且 MQTT 协议 高效地使用网络带宽，在这个意义上，其为轻量级。MQTT 协议支持可靠的传送和即发即弃的传输。 在此协议中，消息传送与应用程序脱离。 脱离应用程序的程度取决于写入 MQTT 客户机和 MQTT 服务器的方式。脱离式传送能够将应用程序从任何服务器连接和等待消息中解脱出来。 交互模式与电子邮件相似，但在应用程序编程方面进行了优化。

协议具有许多不同的功能：

• 它是一种发布/预订协议。
• 除提供一对多消息分发外，发布/预订也脱离了应用程序。对于具有多个客户机的应用程序来说，这些功能非常有用。
• 它与消息内容没有任何关系。
• 它通过 TCP/IP 运行，TCP/IP 可以提供基本网络连接。
• 它针对消息传送提供三种服务质量：
  
  • “至多一次”
    消息根据底层因特网协议网络尽最大努力进行传递。 可能会丢失消息。
    例如，将此服务质量与通信环境传感器数据一起使用。 对于是否丢失个别读取或是否稍后立即发布新的读取并不重要。
  • “至少一次”
    保证消息抵达，但可能会出现重复。
  • “刚好一次”
    确保只收到一次消息。
    例如，将此服务质量与记帐系统一起使用。 重复或丢失消息可能会导致不便或收取错误费用。
• 它是一种管理网络中消息流的经济方式。 例如，固定长度的标题仅 2 个字节长度，并且协议交换可最大程度地减少网络流量。
• 它具有一种“遗嘱”功能，该功能通知订户客户机从 MQTT 服务器异常断开连接。请参阅“最后的消息”发布。

3. MQTT服务器搭建

1. 点击这里，下载Apollo服务器，解压后安装。
2. 命令行进入安装目录bin目录下（例：E:>cd E:\MQTT\apache-apollo-1.7.1\bin）。
3. 输入apollo create XXX（xxx为创建的服务器实例名称，例：apollo create mybroker），之后会在bin目录下创建名称为XXX的文件夹。XXX文件夹下etc\apollo.xml文件下是配置服务器信息的文件。etc\users.properties文件包含连接MQTT服务器时用到的用户名和密码，默认为admin=password，即账号为admin，密码为password，可自行更改。
4. 进入XXX/bin目录，输入apollo-broker.cmd run开启服务器，看到如下界面代表搭建完成

之后在浏览器输入http://127.0.0.1:61680/，查看是否安装成功。

4. MQTT Android客户端具体实现

基本概念：

• topic：中文意思是“话题”。在MQTT中订阅了(subscribe)同一话题（topic）的客户端会同时收到消息推送。直接实现了“群聊”功能。
• clientId：客户身份唯一标识。
• qos：服务质量。
• retained：要保留最后的断开连接信息。
• MqttAndroidClient#subscribe()：订阅某个话题。
• MqttAndroidClient#publish()： 向某个话题发送消息，之后服务器会推送给所有订阅了此话题的客户。
• userName：连接到MQTT服务器的用户名。
• passWord ：连接到MQTT服务器的密码。

添加依赖

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'
}
    
    
1
2
3
4
5
6
7
8
9
10
    
    

     
     
    
    

添加限权

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    
    
1
2
3
    
    

     
     
    
    

注册Service

        <!-- Mqtt Service -->
        <service android:name="org.eclipse.paho.android.service.MqttService" />
        <service android:name="com.dongyk.service.MQTTService"/>
    
    
1
2
3
    
    

     
     
    
    

Android端具体实现

package com.dongyk.service;

import android.app.Service;
...

/**
 * MQTT长连接服务
 *
 * @author 一口仨馍 联系方式 : yikousamo@gmail.com
 * @version 创建时间：2016/9/16 22:06
 */
public class MQTTService extends Service {

    public static final String TAG = MQTTService.class.getSimpleName();

    private static MqttAndroidClient client;
    private MqttConnectOptions conOpt;

//    private String host = "tcp://10.0.2.2:61613";
    private String host = "tcp://192.168.1.103:61613";
    private String userName = "admin";
    private String passWord = "password";
    private static String myTopic = "topic";
    private String clientId = "test";

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        init();
        return super.onStartCommand(intent, flags, startId);
    }

    public static void publish(String msg){
        String topic = myTopic;
        Integer qos = 0;
        Boolean retained = false;
        try {
            client.publish(topic, msg.getBytes(), qos.intValue(), retained.booleanValue());
        } catch (MqttException e) {
            e.printStackTrace();
        }
    }

    private void init() {
        // 服务器地址（协议+地址+端口号）
        String uri = host;
        client = new MqttAndroidClient(this, uri, clientId);
        // 设置MQTT监听并且接受消息
        client.setCallback(mqttCallback);

        conOpt = new MqttConnectOptions();
        // 清除缓存
        conOpt.setCleanSession(true);
        // 设置超时时间，单位：秒
        conOpt.setConnectionTimeout(10);
        // 心跳包发送间隔，单位：秒
        conOpt.setKeepAliveInterval(20);
        // 用户名
        conOpt.setUserName(userName);
        // 密码
        conOpt.setPassword(passWord.toCharArray());

        // last will message
        boolean doConnect = true;
        String message = "{\"terminal_uid\":\"" + clientId + "\"}";
        String topic = myTopic;
        Integer qos = 0;
        Boolean retained = false;
        if ((!message.equals("")) || (!topic.equals(""))) {
            // 最后的遗嘱
            try {
                conOpt.setWill(topic, message.getBytes(), qos.intValue(), retained.booleanValue());
            } catch (Exception e) {
                Log.i(TAG, "Exception Occured", e);
                doConnect = false;
                iMqttActionListener.onFailure(null, e);
            }
        }

        if (doConnect) {
            doClientConnection();
        }

    }

    @Override
    public void onDestroy() {
        try {
            client.disconnect();
        } catch (MqttException e) {
            e.printStackTrace();
        }
        super.onDestroy();
    }

    /** 连接MQTT服务器 */
    private void doClientConnection() {
        if (!client.isConnected() && isConnectIsNomarl()) {
            try {
                client.connect(conOpt, null, iMqttActionListener);
            } catch (MqttException e) {
                e.printStackTrace();
            }
        }

    }

    // MQTT是否连接成功
    private IMqttActionListener iMqttActionListener = new IMqttActionListener() {

        @Override
        public void onSuccess(IMqttToken arg0) {
            Log.i(TAG, "连接成功 ");
            try {
                // 订阅myTopic话题
                client.subscribe(myTopic,1);
            } catch (MqttException e) {
                e.printStackTrace();
            }
        }

        @Override
        public void onFailure(IMqttToken arg0, Throwable arg1) {
            arg1.printStackTrace();
              // 连接失败，重连
        }
    };

    // MQTT监听并且接受消息
    private MqttCallback mqttCallback = new MqttCallback() {

        @Override
        public void messageArrived(String topic, MqttMessage message) throws Exception {

            String str1 = new String(message.getPayload());
            MQTTMessage msg = new MQTTMessage();
            msg.setMessage(str1);
            EventBus.getDefault().post(msg);
            String str2 = topic + ";qos:" + message.getQos() + ";retained:" + message.isRetained();
            Log.i(TAG, "messageArrived:" + str1);
            Log.i(TAG, str2);
        }

        @Override
        public void deliveryComplete(IMqttDeliveryToken arg0) {

        }

        @Override
        public void connectionLost(Throwable arg0) {
            // 失去连接，重连
        }
    };

    /** 判断网络是否连接 */
    private boolean isConnectIsNomarl() {
        ConnectivityManager connectivityManager = (ConnectivityManager) this.getApplicationContext().getSystemService(Context.CONNECTIVITY_SERVICE);
        NetworkInfo info = connectivityManager.getActiveNetworkInfo();
        if (info != null && info.isAvailable()) {
            String name = info.getTypeName();
            Log.i(TAG, "MQTT当前网络名称：" + name);
            return true;
        } else {
            Log.i(TAG, "MQTT 没有可用网络");
            return false;
        }
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}
    
    
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
    
    

     
     
    
    

首先初始化各个参数，之后连接服务器。连接成功之后在http://127.0.0.1:61680/看到自动创建了名称为”topic”的topic。这里我使用了一个真机和一个模拟器运行程序。http://127.0.0.1:61680/服务端看到的是这个样子

这里需要注意两个地方
1. 模拟器运行的时候host = "tcp://10.0.2.2:61613"，因为10.0.2.2 是模拟器设置的特定ip，是你电脑的别名。真机运行的时候host = "tcp://192.168.1.103:61613"。192.168.1.103是我主机的IPv4地址，查看本机IP的cmd命令为ipconfig/all。
2. 两次运行时的clientId不能一样（为了保证客户标识的唯一性）。

这里为了测试，在MQTTService中暴露了一个公共方法publish(String msg)给MainActivity调用。代码如下

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        EventBus.getDefault().register(this);
        startService(new Intent(this, MQTTService.class));
        findViewById(R.id.publishBtn).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                MQTTService.publish("CSDN 一口仨馍");
            }
        });
    }

    @Subscribe(threadMode = ThreadMode.MAIN)
    public void getMqttMessage(MQTTMessage mqttMessage){
        Log.i(MQTTService.TAG,"get message:"+mqttMessage.getMessage());
        Toast.makeText(this,mqttMessage.getMessage(),Toast.LENGTH_SHORT).show();
    }

    @Override
    protected void onDestroy() {
        EventBus.getDefault().unregister(this);
        super.onDestroy();
    }

}
    
    
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
    
    

     
     
    
    

这里使用了EventBus3.0发送消息，感兴趣的可以看下EventBus3.0使用及源码解析。当然，你也可以使用接口回调的方式甚至直接在Service中弹出Toast。whatever，现在点击一个客户端MainActivity中的Button，两个客户端已经能同时弹出消息。已经get到数据了。接下来，show time~

顶

8

踩

0

 

 

• 上一篇Android 高级自定义Toast及源码解析
• 下一篇Android 手把手带你玩转自定义相机

  相关文章推荐

• • 用MqttAndroidClient实现IM
• • Go语言编程入门实战技巧
• • Android MQTT消息推送实践
• • 机器学习大咖在等你
• • 即时通讯-Android推送方案（MQTT）
• • Android高手进阶
• • MqttAndroidClient
• • 深入探究Linux/VxWorks的设备树

• • 基于MQTT的消息推送
• • SDCC 2017之区块链技术实战线上峰会
• • MQTT协议之订阅及发布（使用paho-mqtt-client或mqttv3实现）
• • SDCC 2017之大数据技术实战线上峰会
• • Android EventBus3.0使用及源码解析
• • Android开发之利用MQTT协议实现消息的即时推送
• • Service的两种启动方式onstartService和onbindService区别
• • Android中bindService()启动Service的过程分析

查看评论

9楼 wsljt03142017-06-30 19:38发表 [回复] [引用][举报]

您好，登录失败的情况下会导致应用闪退
java.lang.NullPointerException: cancel() called with a null PendingIntent
at android.app.AlarmManager.cancel(AlarmManager.java:951)

Re: 一口仨馍2017-06-30 19:49发表 [回复] [引用][举报]

回复wsljt0314：这个报错信息比较奇怪，感觉不像是我的代码导致的。nullPointer一般还是比较容易解决的，自己断点看下应该就明白了

Re: wsljt03142017-06-30 19:46发表 [回复] [引用][举报]

回复wsljt0314：解决了，service包换成最新的就行了，之前的版本调用stop方法使用pendingIntent的时候没有判空

Re: 一口仨馍2017-06-30 19:51发表 [回复] [引用][举报]

回复wsljt0314：嗯嗯，解决了就好~~

8楼 zzcdyx_ok2017-06-19 15:37发表 [回复] [引用][举报]

断开连接以后，怎么重连？

Re: 一口仨馍2017-06-19 16:39发表 [回复] [引用][举报]

回复zzcdyx_ok：调用doClientConnection()方法再次进行连接

7楼 欧拉啊旺2017-05-11 15:16发表 [回复] [引用][举报]

您好。如何登陆呀。除了admin那个用户

Re: 一口仨馍2017-05-11 15:37发表 [回复] [引用][举报]

回复欧拉啊旺：不是登陆，是连接。admin是账号，根据不同的clientId识别不同的用户。

Re: 欧拉啊旺2017-05-11 16:08发表 [回复] [引用][举报]

回复一口仨馍：多谢。我已经明白了。你微博也说了。O(∩_∩)O哈哈~

Re: 一口仨馍2017-05-11 17:41发表 [回复] [引用][举报]

回复欧拉啊旺：我不玩微博呀，exo me???

Re: 欧拉啊旺2017-05-12 09:33发表 [回复] [引用][举报]

回复一口仨馍：don't worry，是CSDN博客

6楼 欧拉啊旺2017-05-11 14:28发表 [回复] [引用][举报]

非常感谢作者的无私贡献。

5楼 xin991656932017-04-12 13:16发表 [回复] [引用][举报]

ava.lang.IllegalStateException: Handler (android.telephony.PhoneStateListener$1) {916447c} sending message to a Handler on a dead thread
没有看到链接成功的log

4楼 xin991656932017-04-12 13:15发表 [回复] [引用][举报]

您好，我在使用的时候抛了异常，Handler (android.telephony.PhoneStateListener$1) {916447c} sending message to a Handler on a dead thread
java.lang.IllegalStateException: Handler (android.telephony.PhoneStateListener$1) {916447c} sending message to a Handler on a dead thread

导致链接失败，这是为什么呢

Re: 一口仨馍2017-06-30 19:50发表 [回复] [引用][举报]

回复xin99165693：log中已经说明了

3楼 Kelvin_Zou2017-04-01 11:10发表 [回复] [引用][举报]

已经找到原因了，在AndroidManifest中漏了注册
"org-eclipse-paho-android-service-MqttService"
十分感谢博主分享
csdn一直说连接过多没法发表评论

2楼 Kelvin_Zou2017-03-31 17:53发表 [回复] [引用][举报]

博主你好MQTTService 类中，MQTTMessage 报错，请问这个是自定义类吗

Re: xhsSuccess2017-04-11 16:55发表 [回复] [引用][举报]

回复Kelvin_Zou： 你好，请问你MQTT推送弄好了吗？

Re: 一口仨馍2017-04-01 09:01发表 [回复] [引用][举报]

回复Kelvin_Zou：MQTTMessage类用于EventBus的自定义实体类，无关紧要~

Re: Kelvin_Zou2017-04-01 10:59发表 [回复] [引用][举报]

回复一口仨馍：问题已经解决，谢谢但是在IMqttActionListener类中返回了onFailure方法，连接失败，除了ipv4地址修改成我本机地址，不知道什么原因

Re: 一口仨馍2017-04-01 11:07发表 [回复] [引用][举报]

回复Kelvin_Zou：仔细看下异常信息

Re: Kelvin_Zou2017-04-01 11:12发表 [回复] [引用][举报]

回复一口仨馍：问题已经解决，漏了第三方android.service.MqttService的注册，谢谢博主分享

1楼 旋哥112016-10-11 14:50发表 [回复] [引用][举报]

这个东西和其他第三方推送，哪个比较好。

Re: 一口仨馍2016-10-11 16:07发表 [回复] [引用][举报]

回复旋哥11：自己用MQTT实现推送或者IM比较复杂且难度较大，好处是灵活，可定制性非常强。如果只是为了简单的实现推送而且对数据保密性要求不高的话，建议用第三方。

发表评论

• 用 户 名：
• RootYxb

• 评论内容：
• 
  HTML/XML objective-c Delphi Ruby PHP C# C++ JavaScript Visual Basic Python Java CSS SQL 其它

•   

* 以上用户言论只代表其个人观点，不代表CSDN网站的观点或立场