xmppmini - 真正实用的 xmpp 客户端 - xmppmini 协议整理文档 -- 3.好友协议

您的位置：首页 >> xmppmini - 真正实用的 xmpp 客户端 >> 主题: xmppmini 协议整理文档 -- 3.好友协议 [回主站] [分站链接]

您的位置：首页 >> xmppmini - 真正实用的 xmpp 客户端 >> 主题: xmppmini 协议整理文档 -- 3.好友协议 [最新] [回主站]

标题

xmppmini 协议整理文档 -- 3.好友协议

clq

浏览(833) + 2020-10-18 12:49:52 发表编辑

关键字:

[2020-10-28 16:57:40 最后更新]
xmppmini 协议整理文档 -- 3.好友协议

这部分太复杂，因此先整理这一部分。

----------------------------------------------------------------
1.取好友列表
比较简单，就是一个请求一个回复。

//返回好友列表的操作
//if "jabber:iq:roster" == xmlns
//查询好友列表
//参考 https://blog.csdn.net/w690333243/article/details/70207210
//请求大概是,其实 spark 客户端是不发送 from 节的（至少我手头的版本如此）
//<iq from='juliet@example.com/balcony'
//       id='bv1bs71f'
//       type='get'>
//    <query xmlns='jabber:iq:roster'/>
//</iq>

返回的内容大致为

   res := "<iq type=\"result\"" +
   //+' id="tckDM-9"'
   " id=\"" + id + "\"" + //id 一定要和原来的一样
   ////" to=\"" + t_jid + "\"" + //查询的是自己的,所以回应中也要写这个
   " to=\"" + from_jid + "\"" + //查询的是自己的,所以回应中也要写这个
   ">" +


   "<query xmlns=\"jabber:iq:roster\">" +

   /*
   //subscription="none" 应该是是否在线//不对，应该是否已通过为好友，取值为 both from to
   ////+'<item jid="elizabeth@longbourn.lit" name="Elizabeth" subscription="both"/>'
   ////+'<item jid="bingley@netherfield.lit" name="Bingley" subscription="both"/>'
   "<item jid=\"elizabethaaa@longbourn.lit\" name=\"Elizabeth\" subscription=\"both\"><group>Friends</group></item>" +
   "<item jid=\"bingley@netherfield.lit\" name=\"Bingley\" subscription=\"both\"><group>Friends</group></item>" +
   "<item jid=\"t111@127.0.0.1\" name=\"t111@127.0.0.1\" subscription=\"both\"><group>Friends</group></item>" +
   "<item jid=\"t211@127.0.0.1\" name=\"t211@127.0.0.1\" subscription=\"both\"><group>Friends</group></item>" +
   "<item jid=\"n1@newbt.net\" name=\"n1@newbt.net\" subscription=\"both\"><group>Friends</group></item>" +
   "<item jid=\"n2@newbt.net\" name=\"n2@newbt.net\" subscription=\"both\"><group>Friends</group></item>" +
   //openfire 多了 <group>Friends</group>
   */

   uls +


   "</query>" +
   "</iq>"
   ;

2.单个好友新增通知
这部分其实并不是必须的，但在多数客户端中不实现的话它们会不认新增加的用户，因为它们不会去在添加好友后刷新整个好友列表。
消息本身比较简单，相关概念则需要理解。
实际上是由服务器在任意时刻发送一个消息包，客户端发现这种类型的包后会在自己的好友列表中添加。实际在这一包的变体还用于更新好友间的关系（我们放到下个包说）。

3.添加好友的请求

请求为
<iq id="lhj5w-99" type="set">
<query xmlns="jabber:iq:roster">
    <item jid="ccc4@127.0.0.1" name="ccc4">
      <group>Friend</group>
    </item>
</query>
</iq>

会回应一个添加新好友的信息。其实是一个独立的上述的“单个好友新增通知”，信息 id 都是新的。
<iq id="377-3" to="clq@127.0.0.1/Spark" type="set">
<query xmlns="jabber:iq:roster">
    <item jid="ccc4@127.0.0.1" name="ccc4" subscription="none">
      <group>Friend</group>
    </item>
</query>
</iq>

不过对应这个消息 id 的回应其实是下面这个，其实照协议应该是回应这一个。上面的那个应该是可选的，不过事实上变成了必须的。
<iq id="lhj5w-99" to="clq@127.0.0.1/Spark" type="result"/>

4.请求对方添加自己的回应
有些客户端，在得不到对方回应时居然会报错（例如 spark）。这其实不应该，因为对方就可能不在线或者是对方的服务器这时候暂停了啊。
所以有一些客户端是不强求的这一部分的，不过可以尽量实现。

客户端：
<presence id="lhj5w-27" to="ccc3@127.0.0.1" type="subscribe"></presence>

回应的格式比较特别，目前的实现，例如 openfire 的回应如下。这其实上已经与传统的 RFC3920 不一样的，查了一下，应该是定义在 rfc6121 中的。参考 https://blog.csdn.net/jdcdrdim/article/details/7226987

<iq xmlns="jabber:client" type="set" id="494-10" to="clq@127.0.0.1/gajim.6929J2FG">
<query xmlns="jabber:iq:roster">
<item jid="ccc5@127.0.0.1" ask="subscribe" subscription="none" />
</query>
</iq>

这里要特别注意的是，如果是实现客户端，一定要注意 presence 包是在收到设置用户的回应的 "result" 的 iq 包才能发送的，并且这个 iq 包中的 id 要和自己请求添加好友时的包 id 一致才行。

clq

2020-10-19 16:30:17 发表编辑

5.

这时候服务器可发送一个包给对方，提示对方也加自己好友。

服务器：

<status>您好, 我是clq. 我想添加您到我的联系人列表.</status>
<x xmlns="vcard-temp:x:update">
<photo/>
</x>
<c xmlns="http://jabber.org/protocol/caps" hash="sha-1" node="http://gajim.org" ver="EhDgXYarwDkGz8n/wbp2z37FJWE="/>

</presence>

如果对方同意就会回应两个包给服务器：

<presence id="4cx6D-51" to="clq@127.0.0.1" type="subscribed"/> //同意对方添加
id 是新的。

第二个包可以理解为给对方加注释别名，不过实际上是设置好友信息。实际上可以不发。

<iq id="AixN9-131" type="set">
<query xmlns="jabber:iq:roster">
    <item jid="clq@127.0.0.1" name="clq">
      <group>Friends</group>
    </item>
</query>
</iq>
可以看到这就是前述的“单个好友新增通知”。后面还有一些复杂的操作，主要是通知对方有没有加自己为好友。这其实没有必要，而且现代的 im 大都不支持这样做，特别是标准 xmpp 允许对方将自己地址簿中的好友删除，这显然是不合适的。

因此，xmppmini 并不支持后续的操作。

如果不想理会对方本来是可以不回应的，不过在有些服务器环境下比如 openfire 的时候，不回应的话，下次每次你上线的时候都会自动给您发一次。这显然是不符合现在的 im 系统现状的。为了兼容这种情况，还是明确拒绝得了。消息包为

<presence id="4cx6D-51" to="clq@127.0.0.1" type="unsubscribed"/> //拒绝对方添加

可以看到，只是 type 不同罢了。

另外这个提示对方也加自己好友的消息包可以由服务器多次发送，客户端是会多次提示的。
而客户端也可以通过发送以下包多次通过服务器发送这个提示。
这个包实际上是包3和包4的合集，实际上就是重复添加对方为好友的请求，实际上也就是说现在 xmpp 客户端普通是在请求好友时同时发送包3和包4。

clq

2020-10-28 15:36:19 发表编辑

6.考虑兼容标准 xmpp 服务器的情况下
实际上众多复杂的好友相关操作信息包也只是由三种包组成。

一种是比较简单的 result 的 iq 包。
二是 "jabber:iq:roster" 好友信息 iq 包。
三是 presence 好友关注状态包。

而相关的各种操作是由用户与好友之前的“好友状态”（实际上是相互是否关注状态）决定的。这个状态客户端全部是通过"jabber:iq:roster" 好友信息 iq 包知晓的。
取得这种状态的方法有两个：一是取好友列表，二是取单个好友状态。而取单个好友状态实际上就是添加好友的消息包，服务器对于好友不同的回应也是不同的。

首先，这个状态为消息包中的节点 subscription 的值。
有 none, both, from, to 四种，实际上还有 remove 。

//subscription 关系到联系人状态信息的传输，有 none, both, from, to 四种，实际上还有 remove
//remove 就是对方删除了你的好友。
//none 是你刚建立的地址，但服务器还没同意是否加入你的好友地址簿，要你发出 presence 请求后才修改为 to
//none 也有可能在对方已经删除你的请求下由服务器主动发过来。注意还不是 "remove"。只有对方也主动删除后才会是 "remove"。
//to 表示你加了对方，但对方没加你。并且要对方回复过同意的 presence 包。这时你可看到对方是否上线。
//from 表示对方加了你，你还没加对方。并且要你回复过同意的 presence 包。这时对方可以看到你是否上线。
//both 这时才是双方互相加了好友。你发送了 jabber:iq:roster set 请求在服务器中加对方地址，同时发送 presence 要求知道对方在线状态，并且对方回复了同意的 presence 包。
//同时对方也这样做了。这种情况下才会是 both 。

//所以 xmppmini 的处理逻辑是，只要 subscription 不是 remove 就应该让对方的消息通过。因为这时候不是你添加过对方，就是你同意过对方添加。
//但只要状态不是 both 就提示你要加一下对方好友。
//所以当明确对方是好友，而状态不是 both 时最好是依次发送三个包：
//同意对方加自己的包（不论对方是否真的请求过）；加对方入地址的 jabber:iq:roster set 包；提示对方加自己的 presence 包。

客户端“添加好友”、“设置好友备注”、“取好友间关注状态”实际上是同一个包。可以理解为：“我要设置某个地址为我的好友，备注名为什么什么”。这时候服务会告诉你
“好的，你们现在是好友了，好友间状态是什么什么”另外根据不同的场景还有可能告诉客户端好友的备注是什么什么。之所以不是每次都返回备注，是因为，服务器可能主动发一个包来告诉客户端，对方已经删除了你之类的，其中只包括了好友间的关注状态。

而且，收到这个包时。服务器还会判断是否你加过对方好友（即 subscription 为 none ），如果没有，还会发一个 presence 包给对方，提示对方也加你的好友。

所以说，对于标准 xmpp 来说，这个 subscription 的值是很重要的。

而在 xmppmini 中，我们可以利用这一点来处理好友间的关系。当本地缓存的 subscription 不是 both 时都自动发送一个 "jabber:iq:roster" 的 set 类型 iq 包去设置用户的备注。这样服务器会回一个相同类型的包给我们，我们就知道好友当前与我们的状态了，如果不是 both ，那么我们就需要告诉用户消息有可能无法送达（实际上标准 xmpp 是可以的，不过我们 xmppmini 中必须限制，因为垃圾消息太多了）。同时提醒用户发送一个提醒对方加了我方为好友的 presence 包。

目前的标准 xmpp 服务器会在客户端登录发送 presence 在线包时会判断如果我加了对方对方没加我，就自动提示对方添加自己好友，这样做显然并不好，这不是间接提示对方说我上线了嘛。应当提示用户，让用户自己决定是否提示对方。现在的标准 xmpp 服务器也会在回复的 "jabber:iq:roster" 中说明是否发送过添加好友的请求。也就是 ask 节点中的内容。

clq

2020-10-28 15:47:47 发表编辑

7.删除好友
有了以上的知识，删除好友就容易理解了。
客户端发送：
<iq xmlns="jabber:client" type="set" id="1674169c-e422-4a05-abd9-a8a90cc75d24" from="clq@127.0.0.1/gajim.6929J2FG">
<query xmlns="jabber:iq:roster">
<item jid="ccc@127.0.0.1" subscription="remove" />
</query>
</iq>

服务器回应两个包。

<iq type="set" id="809-61" to="clq@127.0.0.1/gajim.6929J2FG">
<query xmlns="jabber:iq:roster">
<item jid="ccc@127.0.0.1" name="ccc" ask="unsubscribe" subscription="none">
<group>Friends</group>
</item>
</query>
</iq>

<iq type="set" id="700-64" to="clq@127.0.0.1/gajim.6929J2FG">
<query xmlns="jabber:iq:roster">
<item jid="ccc@127.0.0.1" subscription="remove" />
</query>
</iq>

同时还会给对方一个 set 的好友信息包，是将状态改为 "none"，注意还不是 "remove"。只有对方也主动删除后才会是 "remove"。

clq

2020-10-28 16:57:40 发表编辑

8.
"jabber:iq:roster"
如果是 get 后面的 item 是没有用处的，服务器会返回全部好友信息 .

另外，对于 openfire 这样的标准 xmpp 服务器，如果添加的用户域名是它的它就会判断用户是否存在。不存在的话就不允许添加。反而是不在服务器上的能加上去。
而 xmppmini 中，这是不检测的。客户端主动添加了，就加入到地址簿中。这样才合理。

服务器最好也不要提示是否有这个用户，那样就给黑客留下了机会。相当于告诉它 “没错，有这个手机号，来骚扰它吧。”

总数：4　页次：1/1　首页尾页　　

所在合集/目录

xmpp协议最小实现合集更多

xmppmini协议整理文档更多

发表评论:

NEWBT官方QQ群1: 276678893
可求档连环画,漫画;询问文本处理大师等软件使用技巧;求档softhub软件下载及使用技巧.
但不可"开车",严禁国家敏感话题,不可求档涉及版权的文档软件.
验证问题说明申请入群原因即可.