8.Smack类库
1.登陆IM
Connection.DEBUG_ENABLED = true;//首先激活调试模式
1.1建立连接
首先，在启动DSM Message时，客户端通过XMPPConnection与服务器建立连接。建立连接的方式有两种：
1.直接连到服务器
Connection conn = new XMPPConnection("localhost");//创建连接
//其中“localhost”是服务器地址，由于我用的是本机，所以是“localhost”。
conn.connect();//接通连接
2.根据配置连接
ConnectionConfiguration config = ConnectionConfiguration();
config.setServiceName("localhost")；//还可以设置很多其他属性，如隐身登陆
Connection conn1 = new XMPPConnection(config);
conn1.connect();
1.2用户登陆
建立连接之后就是用户登陆了，openfire是支持多终端登陆的，下面的resource就是指的是终端名称，如Smack、Spark等。登陆的方法有两个
login(String username, String password)和
login(String username, String password, String resource)
具体例子如下，livsun与livsun1是两个用户，密码都是111
conn.login("livsun", "111","Smack");
resource也可以缺省不设置
conn1.login("livsun1", "111");
本文后面默认livsun与livsun1已经登陆，且与服务器的连接分别conn和conn1.
1.3断开连接
断开连接只需调用disconnect()方法，如conn.disconnect();
2.单人聊天
2.1发起会话请求
作为一款IM软件的通信协议，首要功能就是聊天。聊天包含两种方式，主动向其他人发起会话；也可以接受别人的会话请求。下面是主动对别人发起会话的实现：
conn.getChatManager.createChat(String userID, MessageListener listener)
其中userID是本次对话请求的接收方的标志，如UserID是livsun1@z00189374/Smack，livsun1@z00189374是对话请求的接收方，/Smack说明用户是在哪个终端登陆的，可以缺省不写。
2.1.1消息监听
当想一个用户发起会话请求，对方接受请求并创建会话后，对方可能发送消息回来，这时需要对接受的消息进行处理。这里要用到MessageListener。
下例将创建一个会话并对收到的消息进行输出：
Chat chat = conn.getChatManager().createChat("livsun1@z00189374/Smack", new MessageListener(){
public void processMessage(Chat chat0, Message message)
{
System.out.println("来自livsun1的消息，内容为"+message.getBody());
}
});
红色chat是这次创建的对话对象，它在livsun跟livsun1之间建立一个会话连接；同事处理来自livsun1的消息。如果livsun想要发消息，需要用chat来调用sendMessage方法。
具体可见下例：
chat.sendMessage("Hello,I’m livsun");
2.1.2会话请求监听
通过上面例子可以知道livsun怎样发送了一个消息给livusn1。但是livsun1需要知道何时livsun发了一个消息给自己，同时还要对这个消息进行处理。Smack提供了会话请求监听接口ChatManagerListener，每个用户通过实现该接口，来监听没一个会话的创建请求。这里再以livsun1为例来展示一下：
chat.getChatManager. addChatListener(ChatManagerListener listener)
ChatManagerListener只有一个方法chatCreated(Chat chat, boolean createdLocally)，它用来处理当chat创建时的具体操作。
具体请看下面例子：
conn1.getChatManager().addChatListener(
new ChatManagerListener(){
public void chatCreated(Chat chat, boolean createdLocal)
{
//自己创建是指自己调用createChat方法，它也会触发这个listener
//在创建对话时就会制定MessageListener，这样判断主要是为了避免重复定义//MessageLister
if(createdLocal)
{
System.out.println("这个chat是自己创建的");
}
//创建与livsun的对话，这里面可以通过message来获取发送聊天请求的人信息
else
{
System.out.println("别人想跟我聊天");
chat.addMessageListener(new MessageListener(){
public void processMessage(Chat chat, Message message)
{
System.out.println(message.getFrom+"想跟我聊天)
chat.sendMessage("你好");
}
});
}
}
});2.1.3会话状态监听
通常用户在参加一个会话时，想知道另一个用户是否正在输入。会话状态有五种：active（参加会话）, composing（正在输入）, gone（离开）, inactive（没有参加会话）, paused（暂停输入）。
如果想要对会话状态监听，需要在用户登陆之后，会话建立之前，添加ChatStateManager对象，方法为ChatStateManager.getInstance(XPMMConnectio conn);譬如获取livsun连接的ChatStateManager代码是ChatStateManager csm = ChatStateManager(conn);
在客户端，根据用户对于一个会话的不同操作，通过ChatStateManager调用方法setCurrentState(ChatState newState, Chat chat)来设置会话的即时状态。如当livsun正在打字输入，则可以通过csm.setCurrentState(ChatState.composing, chat)来设置状态为正在输入。
在客户端，还需要对会话状态改变进行监听，ChatStateListener继承MessageListener，
方法是stateChanged(Chat chat, ChatState state)，由于Chat类没有直接添加ChatStateListener的方法，因此需要自己编写一个内部类实现ChatStateListener和MessageListener两个接口。
请看例子：
private class SelfListener implements ChatStateListener, MessageListener{
public void stateChanged(Chat arg0, ChatState arg1){
……
}
Public void processMessage(Chat arg0, Message arg1){
……
}
}
MessageListener messageListener = new SelfListener();这样当会话对方的ChatState发生改变时，stateChanged方法就被触发。实际上是接收到一个内容为空的Message，Message里通知ChatState改变。
2.2消息
2.2.1设置消息的属性
发送消息的方法sendMessage()，它有两种实现方式，sendMessage(String text) 和sendMessage(Message message)。第一种就是上面例子中所用的，直接以String为对象，发送一个消息。
为了满足用户自定义需求，Smack提供了第二种方式，它可以为message添加一些附加属性，在message中他们只显示为String字段。在客户端接收时，可以通过处理来让这些字段有特定的意义，譬如设置发送文字的大小，字体，颜色等。
这里需要了解Message这个类，它有三种构造函数，Message()、Message(String text)和Message(String text, Message.Type type)其中text是要发送的内容，Message.Type共有五种，常用的为chat和groupchat。
Message中有很多方法，通过这些方法可以设置或者取得消息的属性，如addBody()添加消息内容，getBody()获得消息内容，getFrom()获取消息的发送者等。Message还有API中没有提到的方法：setProperty(String name, String value)。通过这个方法我们可以设置很多自己定义的属性，可参见下面例子：
Message message = new Message();
message.setBody(“This is a Message text”);
message.setProperty(“color”,”red”);
message.setProperty(“size”, “big”);
message.setProperty(“isPictureIn”,”false”);
chat.sendMessage(message);这样就发送了一个包含一些特定属性的消息。当用户收到这样的消息后，通过调用message. getPropertyNames()方法来获取所有属性的一个Collection。再通过message.getProprety(String name)来获取名为name属性的值，根据用户自己的定义，可以实现API没有提供的功能，如改变消息显示字体颜色。
2.2.2消息状态跟踪
对于发送出去的消息，有时候需要获取消息发送的情况，如是否发送成功，对方是够处理等，这些功能需要用到MessageEventManager，通过调用MessageEventManager. addNotificationsRequests(Message message, boolean offline, boolean delivered, boolean displayed, boolean composing)来对消息的状态进行标记跟踪，message为将要发送的消息，剩余四项为可选择的跟踪选项，true为跟踪。
当对其中部分选项进行跟踪后，下一步操作就是对跟踪响应结果进行监控。比如你想知道自己发送消息的标记结果，需要创建一个 MessageEvenetManager对象，并调用方法addMessageEventNotificationListener(MessageEventNotificationListener messageEventNotificationListener)。
如果你想监控是否有人给自己发送消息跟踪请求，这时候需要调用方法addMessageEventRequestListener(MessageEventRequestListener messageEventRequestListener)。
2.2.3离线消息
发送消息时，用户不在线，系统会自动保存这些消息。当用户登录后，用户需要主动去服务器获取离线消息。主要用到的接口是OfflineMessageMananger。
这里有一个需要注意的地方，那就是用户login时不能发送Presence（用户状态，这个下章讲），否则收不到离线消息。
具体可以看下面例子：
ConnectionConfiguration connConfig = new ConnectionConfiguration("localhost");
connConfig.setSendPresence(false);//设置不发送Presence
Connection conn2 = new XMPPConnection(connConfig);
Conn2.connect();
Conn2.login("zhang", "111");
OfflineMessageManager omm = new OfflineMessageManager(conn2);//创建一个对象
Iterator<Message> ommlist = omm.getMessages();//获取消息，结果为一个Message迭代器
omm.deleteMessages();//将服务器上的离线消息删除。如果不执行最后一步操作的话，下次登录这些离线消息还在。
2.3文件传输
用户可能希望向其它用户发送文件。其它用户有接受，拒绝，或忽略用户的请求。Smack为用户轻松发送文件提供了一个简单的接口。暂只实现文件传输，没有实现文件夹传输。
2.3.1发送文件
要发送或接受文件首先必须创建FileTransferManager类的一个对象，创建方法是FileTransferManager(XMPPConnection connection)。假设现在livsun创建了一个文件传输管理对象fileTransferManager = new FileTransferManager(conn);现在需要创建一个输出的文件传输对象来发送文件。
OutgoingFileTransfer outfile = fileTransferManager(UserID)，UserID为完全ID，如果要发送文件给livsun1的话，这里UserID为”livsun1@z00189374/Smack”。
通过调用sendFile(file, description)来发送文件，file是文件对象，description是对文件的描述，可以在接受时获取，并提示用户，可以根据描述来选择是否接受。
一个完整的发送文件的过程如下：
FileTransferManager fileTransferManager = new FileTransferManager(conn);
OutgoingFileTransfer outfile =
manager.createOutgoingFileTransfer("livsun1@z00189374/Smack ");
outfile.sendFile(new File("fileToBeSended.txt"), "You won't believe this!");2.3.2接受文件
如果想知道是否有人发送文件给自己，首先同样需要创建一个FileTransferManager对象，如FileTransferManager fileTransferManager1 = new FileTransferManager(conn1);然后对该对象注册一个监听器FileTransferListener，来监听文件传输请求。这个监听器在有文件传输时被触发，它只有一个方法fileTransferRequest(FileTransferRequest request)，这个方法来决定文件时接受还是拒绝。
如果要拒绝接受，只要简单的request.reject()就可以了。
如果要接受，通过request.accept()创建一个IncomingFileTransfer对象，代码实现：
IncomingFileTransfer infile = request.accept();然后infile调用recieveFile(file)来讲文件接受到file中。同时还可以对文件传输的状态进行监听。
监听及接受文件的代码实现：
final FileTransferManager fileTransferManager1 = new FileTransferManager(conn);
fileTransferManager1.addFileTransferListener(new FileTransferListener() {
public void fileTransferRequest(FileTransferRequest request) {
// 监查此请求是否应该被接受,shouldAccept由自己实现
if(shouldAccept(request)) {//接受则接受文件
IncomingFileTransfer infile = request.accept();
infile.recieveFile(new File("FILE_PATH"+infile.getName()));
} else {
request.reject();
}
}
});2.3.3文件传输状态监听
在文件传输过程中，发送方活接收方需要知道文件传输的进度和状态，需要通过FileTransfer类来实现。
IncomingFileTransfer和OutgoingFileTransfer都继承了FileTransfer类，此类提供一些方法监视文件传输的进展：
getStatus() - 文件传输可以有多种状态，协商，拒绝，取消，传输过程中，错误和完成。这个方法会文件传输的当前状态。
getProgress() - 如果文件在传输过程中，这个方法会返回一个0到1的数字，0表示传输还没开始，1表示传输完成。如果没在传输过程中也可能返回-1。
isDone() - 和getProgress()方法类似，不同的是它返回boolean。如果状态为拒绝，取消，错误或完成返回真，否则返回假。
getError() - 如果在传输过程中发生错误，这个方法将会返回所发生的错误的类型。
如在接收方监视文件状态，代码实现如下：
while(!infile.isDone()) {
if(infile.getStatus().equals(Status.ERROR)) {
System.out.println("ERROR!!! " + transfer.getError());
} else {
System.out.println(infile.getStatus());
System.out.println(infile.getProgress());
}
}3.多人聊天
MultiUserChat，即多人聊天，通过一个用户创建群组，并邀请其他用户进入群组，或者其他用户可以自由进入群组，并在群组里聊天。功能有创建房间、邀请、监听邀请或拒绝、权限更改、身份改变等。
3.1创建多人聊天房间
用户可以创建两种多人聊天房间：即时房间和永久房间。即时房间按照默认的设置立马生成，但是在所有参与用户下线后，该房间注销。永久房间是创建者通过自己的设置生成，创建者是第一个参与者，并且是该房间的Owner。
要想创建一个房间，首先需要创建一个MultiUserChat的对象 ，MultiUserChat类的构造函数需要两个参数，当前用户的连接和房间的JID。如
MultiUserChat chatRoom = new MultiUserChat(conn, “myGroup@conference .z00189374”);
通过chatRoom调用create(“nickname”)来创建房间，其中nickName为用户在房间里显示的昵称。
为了使房间成为永久房间并且更加符合用户的习惯，用户需要对房间进行一些设置。第一步是获取房间的配置表格，代码为
Form form = chatRoom.getConfigurationForm();
再根据配置表格生成一个用来提交配置的表格，代码为
Form submitForm = form.createAnswerForm();
在对submifForm进行设置一些属性，属性包含但不限于以下几个：
//房间的名称
submitForm.setAnswer("muc#roomconfig_roomname", "TestUserNumber");
//保证只有注册的昵称才能进入房间
submitForm.setAnswer("x-muc#roomconfig_reservednick",true);
//设置为永久房间
submitForm.setAnswer("muc#roomconfig_persistentroom",true);
//设置房间人数上限，注意，参数不是int！！！！！
submitForm.setAnswer("muc#roomconfig_maxusers",list);
最后通过chatRoom调用sendConfigurationForm(submitForm)来完成对房间的配置。
3.2加入聊天室
为了在聊天室里接受或发送消息，首先需要进入聊天室。进入房间之前，先通过用户连接和房间JID来创建一个MultiUserChat的对象。
MultiUserChat chatRoom1 = new MultiUserChat(conn1, “myGroup@ conference .z00189374”);
有三种进入房间的方式：
一、直接加入不需要密码的房间chatRoom1.join(“nickname”);
二、加入需要密码的房间chatRoom1.join(“nickName”,”password”);
三、加入需要密码的房间，且同时设置接受聊天记录的数目，在一、二中，没有设置这项，接受的数目有服务器决定。
DiscussionHistory history = new DiscussionHistory();
history.setMaxStanzas(5);
muc2.join("testbot2","password",history, SmackConfiguration.getPacketReplyTimeout());
3.3 群组邀请及群组邀请监听
如果你建了一个群，你可能希望你的某些好友也加入到这个群，你可以通过对他们发送邀请并监听结果来实现这个功能。
首先加入一个房间，muc.join(“livsun”)，并且确认你有这个房间的邀请资格。然后通过muc调用invite(user,reason)方法，其中user是被邀请人的JID，reason是邀请原因。为了知道邀请结果，这里只能获取对面拒绝的结果，在发出邀请之前，需要对multiuserChat对象注册一个监听器muc.addInvitationRejectionListener(new InvitationRejectionListener() )；
为了获取来自其他人的群组邀请，用户可以直接通过自己的连接对MultiUserChat注册一个监听器。如MultiUserChat.addInvitationListener(conn1, new InvitationListener() )。
下面看一个livsun对livsun1发起邀请，livsun1拒绝对例子：
MultiUserChat muc = new MultiUserChat(conn, “maGroup@conference.z00189374”);
muc.join("livsun");
muc.addInvitationRejectionListener(new InvitationRejectionListener() {
public void invitationDeclined(String invitee, String reason) {
// 被拒绝了
}
});
//发出邀请
muc.invite("livsun1@z00189374/Smack", "For Dota");
//下面是livsun1的处理
MultiUserChat.addInvitationListener(conn1, new InvitationListener() {
public void invitationReceived(Connection conn, String room, String inviter, String reason, String password) {
// 对请求进行处理，这里是拒绝了
MultiUserChat.decline(conn, room, inviter, "I'm working delay");
//接受并加入
//MultiUserChat muc1 = new MultiUserChat(conn, room);
//muc1.join(“livsun1”);
}
});3.4 在群组中开始一个单人聊天
在群组列表中，你可能想对某个人发起单独对话，这时可以使用下面方法实现：
Chat chat = muc.createPrivateChat("myGroup@conference.z00189374/livsun1");
chat.sendMessage("Hello there");
不过这样livsun1收到的消息并不是来自于livsun，而是来自myGroup@conference.z00189374
3.5更改房间成员权限
一个典型的群组具有三种身份的人：创建者、管理员和成员。房间创建者可以改变房间配置、授予用户所有权和管理权限以及毁掉此房间。房间管理员可以禁止或授予用户权限和主持者权限。房间成员仅能允许用户加入房间。这里用到的方法都是MultiUserChat的方法，具体可以去看Smack的API文档。
还可以对房间其他成员或自己的权限改变进行监听，方法分别为addParticipantStatusListener(ParticipantStatusListener listener)和addUserStatusListener(UserStatusListener listener)
3.6获取自己曾经加入的房间
MultiUserChat没有提供方法获取自己曾经加入的房间，它的getJoinedRooms只能获取一个好友当前正在加入的房间。而当一个用户登陆时，用户需要获取自己加入过的房间列表，这里需要用到收藏夹Bookmarks。
3.6.1保存房间信息
首先需要创建一个Bookmarks的对象，BookeMarks bm = new BookeMarks()。然后创建BookmarkedConference对象bmConference来保存群组信息。
通过bm调用addBookmarkedConference(BookmarkedConference bookmarkedConference)方法，来讲一个BookmarkedConference对象加入Bookmarks中。
最后要把Bookmarks的信息保存到私人专有数据中。先创建PrivateDataManager的一个对象pdmanager，通过pdmanager调用方法setPrivateData(bm)来将数据保存到服务器。
具体代码实现如下：
//创建收藏夹对象
Bookmarks bookmarks = new Bookmarks();
//创建聊天群组收藏,参数分别为房间的名字，JID，是否自动进入房间，用户昵称，密码
BookmarkedConference conference1 = new BookMarkMain("groupName","myGroup@conference.z00189374",true,"nickname",null);
bookmarks.addBookmarkedConference(conference1);
PrivateDataManager manager = new PrivateDataManager(conn);
manager.setPrivateData(bookmarks);
3.6.2获取房间信息
当用户登录时，用户去privateData获取自己的房间信息。用户需要提供Bookmarks的解析方法来正确获取保存在PrivateData中的Bookmarks信息。具体方法如下
Bookmarks bm = new Bookmarks();
PrivateDataManager manager = new PrivateDataManager(conn);
//提供对Bookmarks的IQ包的解析方法
manager.addPrivateDataProvider(bm.getElementName(),
bm.getNamespace(), new Bookmarks.Provider());
//获取Bookmarks信息
bm = (Bookmarks)manager.getPrivateData(bm.getElementName(),
bm.getNamespace());
//获取Bookmarks中群组的信息。
Collection<BookmarkedConference> c = bm.getBookmarkedConferences();
4.联系人
每一个用户都有一个Roster列表，包含多个RosterEntry。
在roster中每个用户用一个RosterEntry表示，它包括：
一个XMPP地址(例如 livsun@z00189374)。
一个您分配给用户的昵称(例如 "2b")。
登陆所属的roster组列表。如果roster登陆不属于任何组，它将被称为“unfiled entry”。 在openfire中一个RosterEntry可以同时属于多个分组。
4.1获取联系人
当用户通过一个连接登录服务器后，用户可以从服务器获取自己的Roster列表。
Roster roster = conn.getRoster();
获取Roster后可以通过调用roster.getEntries()方法来获取所有RosterEntry对象，返回类型为Collection<RosterEntry>。
Collection<RosterEntry> rosterentrys = roster.getEntries();
如果想获得分组信息，需要调用roster.getGroups(), 返回结果是一个Collection<RosterGroup>。可以在通过rosterGroup.getEntries()获取每个分组的成员。
对于每个成员的状态信息，如是否在线，签名等，可通过roster.gerPresence(RosterEntry)获取。
4.2管理好友
用户可能需要添加其他用户到自己的Roster中，并可以获取这些用户的状态更新。Smack使用了一种订阅的Presence的方式来获取状态，这样确保用户隐私，因为只有允许订阅才能获取状态。
对于订阅请求，用户有三种处理方式：接受所有、拒绝所有和手动处理。这需要通过通过Roster.setSubscriptionMode(int subscriptionMode)方法来设置。
添加好友就是一个互相发送状态订阅消息的过程。通过调用roster.createEntry(JID,nickname,group)来将一个用户添加到自己的roster中，并向这个用户发送一个订阅presence的请求。
删除好友只需roster.removeEntry(RosterEntry)就可以将用户从自己的roster中删除。
如果用户想把某位好友从一个群组移动到另外一个群组里，需要用到RosterGroup的removeEntry()和addEntry()方法。假设当前群组名称为groupNow，即将移入的群组名称为groupTo，则代码实现如下
//假设被移动的成员为一个RosterEntry对象rosterEntryMove
RosterGroup gourpNow = roster.getGroup(“groupNow”);
RosterGroup gourpTo = roster.getGroup(“groupTo”);
groupNow.removeEntry(rosterEntryMove);
groupTo.addEntry(rosterEntryMove);
4.2状态修改
Presence是用来管理用户的在线状态，它有在线和不在线两种状态。如果在线又可以包含很多其他信息，如忙碌、离开等，还可以获取签名。
用户可以通过发送Presence包来改变自己的状态。首先需要创建一个Presence对象。
Presence presence = new Presence(Presence.type.available);
presence.setStatus(“吃饭去”);
presence.setMode(“away”);
conn.sendPacket(presence);
这里用户发送了一个Presence包，更新自己状态为离开，且发表即时心情为“吃饭去”。.
4.3隐私设置与黑名单的实现
Privacy是管理其他用户与自己通信的方法。它是由用户定义，可以获取、修改或删除的，保存在服务器端的隐私设置。它基于三种不同的范围JID、Group和签名类型来管理隐私。其中设置包含消息、上线通知、IQ包或所有通信。要实现隐私管理首先需要了解他的三个API
PrivacyListManager: 这是重新获得并处理服务器隐私列表的主API类。
PrivacyList: 代表一个隐私列表，有一个名字，一组隐私项目。例如，可见或不可见列表。PrivacyItem:阻挡或允许隐私的某个方面。例如，允许我的的朋友看到我们的出席状态。
首先要从服务器上获取用户的PrivacyListManager
PrivacyListManager plm = PrivacyListManager.getInstanceFor(conn);
再创建一个隐私列表
List<PrivacyItem> privacyItems = new ArrayList<PrivacyItem>();
然后向这个列表中添加隐私设置
//在线对其隐身
PrivacyItem item = new PrivacyItem(“jid”, false, 1);
item.setValue(userJID);
item.setFilterPresenceout(true);
privacyItems.add(item);
最后要将这个隐私列表创建到服务器上，并设置为激活状态。
plm.createPrivacyList(“myList”, privacyItems);
plm.setActiveListName(“myList”);
黑名单实现
PrivacyItem item1 = new PrivacyItem(“group”, false, 1);
item1.setValue(“blacklist”);
item1.setMessage(true);
privacyItems.add(item1);
其他同JID隐私设置一样。
5.用户信息管理
用户信息包含用户的姓名、昵称、住址、电话、头像和密码等。
5.1 用户信息
VCard是用来管理用户信息的类。为了获取自己的信息，首先需要新建一个VCard对象，然后通过该对象来加载自己的个人信息。
VCard vCard = new VCard();
vCard.load(conn);
通过get方法可以从VCard对象中获取自己想要的信息。如vCard.getNickName()来获取自己的昵称。
如果想设置或修改自己的信息，需要用VCard的set方法。如vCard.setNickName(“2b”).
在设置完成后，需要将vCard的数据保到服务器中，方法是vCard.save(conn)。
上传头像需要向对图片文件进行处理，将其转化为byte[]数组。假设图片文件已被转化成bytes数组。在将图片用set方法保存前，还需要对其进行编码，具体如下：
//调用smack接口对bytes编码
String encodedImage = StringUtils.encodeBase64(bytes);
//设置
card.setAvatar(bytes, encodedImage);
//保存
card.save(conn);
5.2账户信息
账户信息是由AccountManager来管理。它可以创建用户，修改密码，获取用户信息等。
首先根据连接来创建AccountManager对象，再调用它的changePassword(String password)的方法即完成密码修改.
AccountManager accountmanager = new Accountmanager(conn);
accountmanager.changePassword(“new password”);
6.与其他IM绑定
Smcak是基于XMPP通信协议的接口，支持与其他基于XMPP的IM软件互通。
6.1在服务器端安装插件
从网上下载gateway插件，推荐使用Kraken IM Gateway ，将Kraken IM Gateway 单独jar包拷贝到openfire的plugin目录下，重启openfire即可；记住，这样会导致服务暂时终止。
6.2 在客户端获取支持绑定的IM
首先通过ServiceDiscoveryManager来查询当前服务器上的提供服务主体。创建方法如下：
ServiceDiscoveryManager sdm = ServiceDiscoveryManager.getInstanceFor(conn);
再通过sdm调用discoverItems(entityID)，其中entityID代表a given XMPP entity addressed by its JID，本例中为“z00189374”，来获取包含所有items的DiscoveryItems对象 。代码为：
DiscoveryItems discoveryItems = sdm.discoveryItems(“z00189374”);
再通过discoveryItems.getItems()来获取关于所有Items 的迭代器。
Iterator<DiscoverItems.Item> i = di.getItems();
在对每个Item进行判断，观察是否是一种IM绑定支持。
String entityName = item.getEntityID();
if (entityName.startsWith("msn."))