Android平台下基于XMPP的IM研究(一)

 

本文转自：http://blog.csdn.net/liuhongwei123888/archive/2011/04/22/6340757.aspx

 

由于项目需要做一个基于XMPP协议的Android通讯软件。故开始研究XMPP
XMPP协议采用的是客户端-服务器架构，所有从一个客户端发到另一个客户端的消息和数据都必须经过XMPP服务器转发，而且支持服务器间DNS的路由，也就是说可以构建服务器集群，使不同的

服务器下的客户端也可以通信，XMPP的前身是一个开源组织制定的网络通信协议——Jabber，XMPP的核心是在网络上分片段发送XML流的协议，这个协议是XMPP的即时通讯指令的传递手段。
      为了防止服务器间发送的数据被篡改或偷听，XMPP服务器通信引入了TLS机制，使用TLS机制能实现数据的加密，从而保证了在数据传输过程种数据的安全。
      一个XMPP实体的地址称为Jabber Identifier或JID，作用类似于IP地址。一个合法的JID包括节点名,域名资源名，其格式为：jid=[node'@']domain['/'resource]

XMPP协议的命名空间：
jabber:iq:private   -- 私有数据存储，用于本地用户私人设置信息，比如用户备注等。
jabber:iq:conference  -- 一般会议，用于多个用户之间的信息共享
jabber:x:encrypted -- 加密的消息，用于发送加密消息
jabber:x:expire  -- 消息终止
jabber:iq:time  -- 客户端时间
jabber:iq:auth  -- 简单用户认证，一般用于服务器之间或者服务器和客户端之间的认证
jabber:x:roster  -- 内部花名册
jabber:x:signed  -- 标记的在线状态
jabber:iq:search -- 用户数据库查询，用于向服务器发送查询请求
jabber:iq:register -- 注册请求，用于用户注册相关信息
jabber:x:iq:roster -- 花名册管理
jabber:x:conference -- 会议邀请，用于向参加会议用户发送开会通知
jabber:x:event  -- 消息事件
vcard-temp  -- 临时的vCard,用于设置用户的头像以及昵称等

在网上找了下，有开源的项目BEEM，开源的用于android的xmpp框架asmack，asmack是smack的android版本。现在开始学习smack

。Xmpp就是神马东西，就不废话了。首先在网上下一个Openfire和Spack，不知道这两个是什么东西，就直接google吧。安装openfire需要mysql的支持，当然，oracle，sqlserver肯定是可以的。还是先上图吧： 

Openfire + Spark + MyXMPPP



 

import java.io.InputStreamReader;
import java.util.Collection;

import org.jivesoftware.smack.Chat;
import org.jivesoftware.smack.ChatManager;
import org.jivesoftware.smack.ChatManagerListener;
import org.jivesoftware.smack.ConnectionConfiguration;
import org.jivesoftware.smack.MessageListener;
import org.jivesoftware.smack.PrivacyListManager;
import org.jivesoftware.smack.Roster;
import org.jivesoftware.smack.RosterEntry;
import org.jivesoftware.smack.RosterGroup;
import org.jivesoftware.smack.RosterListener;
import org.jivesoftware.smack.XMPPConnection;
import org.jivesoftware.smack.packet.Message;
import org.jivesoftware.smack.packet.Presence;

public class TestSmack {
public static void main(String[] args) {XMPPConnection.DEBUG_ENABLED = true;
//我的电脑IP:10.16.25.90
final ConnectionConfiguration connectionConfig = new ConnectionConfiguration("10.16.25.91", 5222, "");
connectionConfig.setSASLAuthenticationEnabled(false);
try {

XMPPConnection connection = new XMPPConnection(connectionConfig);
connection.connect();//连接
connection.login("test", "test");//登陆
System.out.println(connection.getUser());
ChatManager chatmanager = connection.getChatManager();

//新建一个会话
Chat newChat = chatmanager.createChat("test3@pc2010102716", new MessageListener() {
public void processMessage(Chat chat, Message message) {
System.out.println("Received from 【" + message.getFrom() + "】 message: " + message.getBody());
}
});

// 监听被动接收消息，或广播消息监听器
chatmanager.addChatListener(new ChatManagerListener() {
@Override
public void chatCreated(Chat chat, boolean createdLocally) {
chat.addMessageListener(new MessageListener() {
@Override
public void processMessage(Chat chat, Message message) {
System.out.println("Received from 【" + message.getFrom() + "】 message: " + message.getBody());
}

});
}
});
//发送消息
newChat.sendMessage("我是菜鸟");

//获取花名册
Roster roster = connection.getRoster();
Collection<RosterEntry> entries = roster.getEntries();
for(RosterEntry entry : entries) {
System.out.print(entry.getName() + " - " + entry.getUser() + " - " + entry.getType() + " - " + entry.getGroups().size());
Presence presence = roster.getPresence(entry.getUser());
System.out.println(" - " + presence.getStatus() +" - "+ presence.getFrom());
}

//添加花名册监听器，监听好友状态的改变。
roster.addRosterListener(new RosterListener() {

@Override
public void entriesAdded(Collection<String> addresses) {
System.out.println("entriesAdded");
}

@Override
public void entriesUpdated(Collection<String> addresses) {
System.out.println("entriesUpdated");
}

@Override
public void entriesDeleted(Collection<String> addresses) {
System.out.println("entriesDeleted");
}

@Override
public void presenceChanged(Presence presence) {
System.out.println("presenceChanged - >" + presence.getStatus());
}

});

//创建组
//                  /RosterGroup group = roster.createGroup("大学");
//                  for(RosterEntry entry : entries) {
//                      group.addEntry(entry);
//                  }
for(RosterGroup g : roster.getGroups()) {
for(RosterEntry entry : g.getEntries()) {
System.out.println("Group " +g.getName() +" >> " + entry.getName() + " - " + entry.getUser() + " - " + entry.getType() + " - " + entry.getGroups().size());
}
}

//发送消息
BufferedReader cmdIn = new BufferedReader(new InputStreamReader(System.in));
while(true) {
try {
String cmd = cmdIn.readLine();
if("!q".equalsIgnoreCase(cmd)) {
break;
}
newChat.sendMessage(cmd);
}catch(Exception ex) {
}
}
connection.disconnect();
System.exit(0);
} catch (Exception e) {
e.printStackTrace();
}
}
}

 

以上代码如果在一般的Java Project上运行需要加入smack.jar 和klmx2.jar,如果是Android Project，基本代码不需改变只需将其放入onCreate(...)方法下即可，需要加入asmack.jar包.

1、ConnectionConfiguration
 作为用于与XMPP服务建立连接的配置。它能配置；连接是否使用TLS，SASL加密。
 包含内嵌类：ConnectionConfiguration.SecurityMode

2、XMPPConnection.
 XMPPConnection这个类用来连接XMPP服务.
 可以使用connect()方法建立与服务器的连接。disconnect()方法断开与服务器的连接. 
 在创建连接前可以使用XMPPConnection.DEBUG_ENABLED = true; 使开发过程中可以弹出一个GUI窗口，用于显示我们的连接与发送Packet的信息。



3、ChatManager
 用于监控当前所有chat。可以使用createChat(String userJID, MessageListener listener)创建一个聊天。
 
4、Chat
 Chat用于监控两个用户间的一系列message。使用addMessageListener(MessageListener listener)当有任何消息到达时将会触发listener的processMessage(Chat chat, Message message) 
方法.
 我们可以使用sendMessage()发送消息,这个方法有两个重载方法，一种类类型的参数时String类型，另一种则是传入Message对象(后面介绍)。
 那么有这样一种情况，当别人主动跟我们建立连接发送消息，或者系统发送消息时我们怎么才能接收消息呢？
    我现在是这样操作的：
 chatmanager.addChatListener(new ChatManagerListener() {
  @Override
  public void chatCreated(Chat chat, boolean createdLocally) {
   chat.addMessageListener(new MessageListener() {
    @Override
    public void processMessage(Chat chat, Message message) {
     System.out.println("Received message: " + message.getBody());
    }
         
   });
  }
 });
 
5、Message
 Message用于表示一个消息包(可以用调试工具看到发送包和接收包的具体内容)。它有以下多种类型。
  Message.Type.NORMAL -- （默认）文本消息（比如邮件）
  Message.Type.CHAT -- 典型的短消息，如QQ聊天的一行一行显示的消息
  Message.Type.GROUP_CHAT -- 群聊消息
  Message.Type.HEADLINE -- 滚动显示的消息
  Message.TYPE.ERROR -- 错误的消息
 Message有两个内部类：
  Message.Body -- 表示消息体
  Message.Type -- 表示消息类型
 
6、Roster
 表示存储了很多RosterEntry的一个花名册.为了易于管理，花名册的项被分贝到了各个group中.
 当建立与XMPP服务的连接后可以使用connection.getRoster()获取Roster对象。
 别的用户可以使用一个订阅请求(相当于QQ加好友)尝试订阅目的用户。可以使用枚举类型Roster.SubscriptionMode的值处理这些请求：
 accept_all: 接收所有订阅请求
 reject_all：拒绝所有订阅请求
 manual：  手工处理订阅请求
 
 创建组：RosterGroup group = roster.createGroup("大学");
 向组中添加RosterEntry对象: group.addEntry(entry);
 
7、RosterEntry
 表示Roster（花名册）中的每条记录.它包含了用户的JID，用户名，或用户分配的昵称.
 
8、RosterGroup
 表示RosterEntry的组。可以使用addEntry(RosterEntry entry)添加。contains(String user) 判断某用户是否在组中.当然removeEntry(RosterEntry entry)就是从组中移除了。getEntries()

获取所有RosterEntry.
 
9、Presence
 表示XMPP状态的packet。每个presence packet都有一个状态。用枚举类型Presence.Type的值表示：
 available -- （默认）用户空闲状态
 unavailable -- 用户没空看消息 
 subscribe -- 请求订阅别人，即请求加对方为好友 
 subscribed -- 统一被别人订阅，也就是确认被对方加为好友 
 unsubscribe -- 他取消订阅别人，请求删除某好友
 unsubscribed -- 拒绝被别人订阅，即拒绝对放的添加请求 
 error -- 当前状态packet有错误
 内嵌两个枚举类型:Presence.Mode和Presence.Type.
 可以使用setStatus自定义用户当前的状态（像QQ一样的)