asmack搜索添加好友

在做添加好友之间，必须要对xmpp的好友订阅有一定的了解，以前我不了解其中原理，盲目的做，以为添加到了各自的列表能够发消息就没事了，后来发现这样会导致很多问题，比如好友上下线无提醒，好友更新了vcard没有提示等一系列和好友相关的问题都出来了。

 

后来终于重视这个问题，查找相关资料，自行百度，发现很多资料都是只说了单边实现没有设计原理，事实上，那也不算真的实现了，现在我来说下原理和流程，希望对同是做即时通讯的同学们有所帮助；

 

我们知道，一个好友就对应一个RosterEntry，那我们看怎么来构造一个RosterEntry对象：

 

 

/**
     * Creates a new roster entry.
     *
     * @param user the user. 用户的jid
     * @param name the nickname for the entry. 指定给这个用户的昵称（其实我更愿意叫做备注）
     * @param type the subscription type. 这个用户和我的好友关系类型
     * @param status the subscription status (related to subscriptions pending to be approbed).这个用户和我的好友状态
     * @param connection a connection to the XMPP server.连接，不解释
     */
    RosterEntry(String user, String name, RosterPacket.ItemType type,
                RosterPacket.ItemStatus status, Roster roster, Connection connection) {
        this.user = user;
        this.name = name;
        this.type = type;
        this.status = status;
        this.roster = roster;
        this.connection = connection;
    }

 

 

 

上面的user和nickname还有Connection相信大家都知道了，Roster是花名册，相信大家也不陌生，通过XmppConnection.getRoster()可以获取到当前连接的花名册，我们重点来说下type和 status是干嘛用的；

 

凭我们用过qq的经验来看，添加好友是需要有几种状态的，比如我加了你，你同意了，但是你不想把动态让我看到，所以你不一定加我，这就是单方订阅，我加你，但是你拒绝了我 ，那我们就没啥关系，我加了你，你也加了我，那我们就是朋友了，我们是双方订阅，现在我们来捋一捋xmpp中有哪几种状态；

 

我们先看itemType是个什么鬼，点进去源码看一下；

 

 

public static enum ItemType {

        /**
         * The user and subscriber have no interest in each other's presence.
         */
        none,

        /**
         * The user is interested in receiving presence updates from the subscriber.
         */
        to,

        /**
         * The subscriber is interested in receiving presence updates from the user.
         */
        from,

        /**
         * The user and subscriber have a mutual interest in each other's presence.
         */
        both,

        /**
         * The user wishes to stop receiving presence updates from the subscriber.
         */
        remove
    }

 

 

我们看到，这是一个枚举类型，上面都有注释，为了大家更清楚一些我就给大家翻译一下；none表示我和对方没有任何关系；to表示我发了我请求订阅了对方，对方同意了，但是他没有订阅我；from就是to反过来，他订阅了我，但是我没有订阅他；both表示我们双方互相订阅了；remove表示我想取消以前的订阅；

 

这种订阅状态是通过发送Presence来实现的。我们结合具体的应用场景来讲一下，怎么来订阅：

 

 

一、添加者

1、加入到 用户 roster列表

<iq type="set"><query xmlns="jabber:iq:roster"><item jid="13548583222@iz28sr0uiyaz" name="13548583222"></item></query></iq>


2、发送订阅presence

<presence type="subscribe" to="13548583222@iz28sr0uiyaz"></presence>

3、对方同意，互相订阅
<presence type="subscribed" to="13548583222@iz28sr0uiyaz"></presence>


二、被添加者

接受好友添加

1 、发送接受请求订阅
 <presence type="subscribed" to="13548583222@iz28sr0uiyaz"></presence>

2、添加到roster列表
<iq type="set"><query xmlns="jabber:iq:roster"><item jid="13548583222@iz28sr0uiyaz"></item></query></iq>

3、发送订阅
<presence type="subscribe" to="13548583222@iz28sr0uiyaz"></presence>

这时添加者发现已经在花名册中了，只需要发送subscribed就OK了，同时更新自己显示的列表；
添加者：<presence type="subscribed" to="13548583222@iz28sr0uiyaz"></presence>

 

 

上面这个流程通过发包的方式呈现，可能大家不是很明白，那么我画一个UML图加深理解；

 

 到此，两个人就成为了双方的好友了，这时候只要有一方有更新，另一方就会受到与之相关的消息，比如vcard更新，状态更新等；

 

那么既然加了好友，我们来看下好友列表这块，如果我们只想显示双方都添加对方好友的列表，那我们需要做一个刷选，回归到前面的RosterEntry来，做一个判断：

 

if ( entry.getType()==ItemType.both) {
				User user = transEntryToUser(entry);
				tempUsers.add(user);
				UserManager.getInstance(mContext).saveUserDetail2Local(user);
			}

 这样的话，好友列表就只有互相都订阅的好友了；

 

本文属原创，如需转载请注明出处，尊重劳动成果，谢谢！

有问题欢迎下面留言问题；

 

下面补充一点，关于删除好友出现了删除好友后无需处理就是好友的问题，于是我跟踪了下发送的包，正确的顺序应该是这样的：

 

如同增加一个名册条目, 如果服务器能成功地处理roster set那么它必须在该用户的名册中更新该条目, 发送一个roster push到该用户的所有感兴趣的资源(其中的'subscription'属性值设为"remove"), 并发送一个IQ result给初始的资源; 详见章节2.3.
另外, 该用户的服务器可能需要生成一个或更多subscription相关的presence节, 如下:
如果该用户对该联系人有一个出席信息订阅, 那么该用户的服务器必须发送一个type为"unsubscribe"的presence节给该联系人(为了对该联系人的出席信息取消订阅).
如果该联系人对该用户有一个出席信息订阅, 那么该用户的服务器必须发送一个type为"unsubscribed"的presence节给该联系人(为了取消该联系人对该用户的订阅).
如果出席信息订阅是相互的, 那么该用户的服务器必须同时发送type为"unsubscribe"presence节和type为"unsubscribed"的的presence节给该联系人.

 

也就是说，我们需要对于互相订阅的用户，我们需要发送两个presence：

Presence.Type.unsubscribe,和Presence.Type.unsubscribed,同时，我们需要从花名册中移除这个用户：

roster.removeEntry(entry);