打开APP
userphoto
未登录

开通VIP,畅享免费电子书等14项超值服

开通VIP
xmpp协议3
4.6. 流特性

如果发送实体在其发送的初始流hea的人中包含了版本属性且此属性值至少为“1.0”,那么接受实体必须(MUST)发送一个<features/>子元素(带有流命名空间的前缀)给发送实体,用于报告那些可制定的任何流级别的特性(或者是其它必须注册的性能)。目前,这个只用于注册TLS的使用,SASL的使用以及这儿定义的资源绑定和定义在[XMPP-IM]中的建立会话;可是,在将来流的功能特性能够用来注册其它被制定的特性。如果一个实体不理解或支持一些特性,它应该(SHOULD)忽略它们。如果需要在提供非安全相关特征前成功的制定一个或多个安全特性(如:TLS和SASL),那么在制定相关的安全特性前我们不应该(SHOULD NOT)在已注册的流特性中包含那些非安全相关特性。


4.7. 流错误

流的根元素可以(MAY)包含一个被赋予流命名空间前缀的<error/>子元素。如果错误子元素感觉到一个流级别错误发生,该错误子元素必须(MUST)由一个兼容实体(通常是一个服务器而非客户端)来发送。
4.7.1. 规则

以下规则应用于流级别错误:

   1. 我们设想说有流级别的错误都是不可复原的;因此,要是在流级别上发生了错误,侦查到该错误的实体必须(MUST)发送一个流错误给其它实体,然后发送一个闭</stream>标志,并终止underlyingTCP连接。
   2. 如果在流被建立期间发生错误,接收实体必须(MUST)仍旧发送起始<stream>标记,将<error/>元素作为流元素的子元素包括在内,然后发送关闭</stream>标记,并终止潜在的TCP连接。此种情况下,如果初始实体在‘to’属性(或根本没提供 ‘to’属性)中提供了一个未知主机,服务器应当(SHOULD)在流头的‘from’属性中提供服务器的授权主机名,并在终止前发送。

4.7.2. 语法

流错误的语法如下:

<stream:error>
<defined-condition xmlns='urn:ietf:params:xml:ns:xmpp-streams'/>
<text xmlns='urn:ietf:params:xml:ns:xmpp-streams'
xml:lang='langcode'>
OPTIONAL descriptive text
</text>
[OPTIONAL application-specific condition element]
</stream:error>

<error/>元素:

   1. 必须(MUST)包含一个子元素,此子元素与后面定义的节错误因素之一相符;此子元素必须(MUST)由‘urn:ietf:params:xml:ns:xmpp-streams’命名空间限定。
   2. 可能(MAY)包含一个<text/>子元素,用于包含更详细的描述错误的XML字符数据;此子元素必须(MUST)由‘urn:ietf: params:xml:ns:xmpp-streams’命名空间限定,并且,应当(SHOULD)有一个'xml:lang'属性来指定XML字符数据使用的语言。
   3. 可能(MAY)包含一个用于说明特定应用中的错误因素的子元素;此元素必须(MUST)由一个已定义的应用的命名空间来限定,并且,它的结构也由那个命名空间来定义。

<text/>元素是可选(OPTIONAL)的。如果包含了此元素,它应当(SHOULD)仅用于提供描述性或诊断性的信息,来补充一个已定义的因素或特殊应用中的因素所表示的意思;它不应当(SHOULD NOT)由一个应用以程序化的形式叙述。它不应当(SHOULD NOT)作为错误消息展示给一个用户,但可以(MAY)特定条件下显示在与包含错误因素的元素(或元素们)相关的错误消息中。

4.7.3 已定义因素

以下定义了流级别的错误因素:

   1. <bad-format/> -- 已经发送XML的实体不能被处理;此错误可以(MAY)用于代替更特殊的XML相关错误,例如:<bad-namespace- prefix/>、<invalid-xml/>、<restricted-xml/>、<unsupported -encoding/>和<xml-not-well-formed/>,虽然更特殊的错误才是首选。
   2. <bad-namespace-prefix/> -- 实体发送了一个不被支持的名空间前缀,或在一个需要那样一个前缀的元素中发送了没有命名空间的前缀(参考XML命名空间名与前缀(11.2))。
   3. <conflict/> -- 服务器正为实体关闭活动流,因为一个已经被初始化的新流与现存流冲突。
   4. <connection-timeout/> -- 一段时间内(根据本地服务配置)实体并不通过流产生任何通信。
   5. <host-gone/> -- 由初始实体在流头中提供的‘to’属性值对应于一个主机名,而此主机名已不再被一个服务器当作主机名了。
   6. <host-unknown/> -- 由初始实体在流头中提供的‘to’属性值与服务器所拥有的主机名不一致。
   7. <improper-addressing/> -- 一个在两个服务器间发送的节,缺少‘to’或‘from’属性(或此属性无值)
   8. <internal-server-error/> -- 服务器经历了错误配置或其它未定义内部错误使其无法提供服务。
   9. <invalid-from/> -- 在‘from’地址中提供的JID或主机名与已授权的JID或有效域协商不匹配,此有效域协商为通过SASL或回叫服务器间的协商,或通过授权与资源绑定的客户端与服务器间的协商。
  10. <invalid-id/> -- 流ID或回叫ID是无效的或与以前提供的ID不匹配。
  11. <invalid-namespace/> -- 流命名空间名不只是http://etherx.jabber.org/streams,或回叫命名空间名不只是"jabber:server:dialback"(参考XML命名空间名与前缀(11.2))
  12. <invalid-xml/> -- 实体通过流向执行验证的服务器发送了无效的XML(参考验证(11.3))。
  13. <not-authorized/> -- 实体试图在流被认证前发送数据,或不授权执行一个相关流协商的活动;接收实体在发送流错误前不准处理违规节。
  14. <policy-violation/> -- 实体违反了某些本地策略;服务器可能选择在<text/>元素或特殊-应用条件元素中指定策略。
  15. <remote-connection-failed/> -- 服务器不能适当的连接到远程实体,需要认证或授权。
  16. <resource-constraint/> -- 服务器缺少提供服务给流的必要的系统资源。
  17. <restricted-xml/> -- 实体试图发送受限的XML特征,例如评注、处理介绍,DTD,实体参考,或保留字符(参考(11.1))。
  18. <see-other-host/> -- 服务器将不提供服务给初始实体,但正重定向传输给另一个主机;服务器应当指定替换的主机名或IP地址(必须是有效域标识符),作为<see-other-host/>元素的XML字符数据。
  19. <system-shutdown/> -- 服务器被关闭,并且所有的活动流被关闭。
  20. <undefined-condition/> -- 错误因素是由此列表中的其它已定义因素中的一个;此错误因素应当仅用于与特殊应用错误因素相结合。
  21. <unsupported-encoding/> -- 初始实体以不被服务器支持的编码给流编码(11.5)
  22. <unsupported-stanza-type/> -- 初始实体发送了一个不被服务器支持的第一级子流。
  23. <unsupported-version/> -- 由初始实体在流头提供的版本属性值指定了一个不被服务器支持的XMPP版本;服务器可能在<text/>元素中指定它支持的版本。
  24. <xml-not-well-formed/> -- 初始实体发送了不标准的XML,标准的XML由[XML]定义。


接下来是一个例子

此部分包含两个简化的客户端与服务器(“C”行是从客户端发送到服务器,而“S”行是由服务器发送到客户端)间基于流会话的例子;这些例子用于进一步的介绍这些概念。

A basic "session": //一个基础的会话

C: <?xml version='1.0'?>
<stream:stream
to='example.com'
xmlns='jabber:client'
xmlns:stream='http://etherx.jabber.org/streams'
version='1.0'>
S: <?xml version='1.0'?>
<stream:stream
from='example.com'
id='someid'
xmlns='jabber:client'
xmlns:stream='http://etherx.jabber.org/streams'
version='1.0'>
...  encryption, authentication, and resource binding ...
C:   <message from='juliet@example.com'
to='romeo@example.net'
xml:lang='en'>
C:     <body>Art thou not Romeo, and a Montague?</body>
C:   </message>
S:   <message from='romeo@example.net'
to='juliet@example.com'
xml:lang='en'>
S:     <body>Neithe*, **ir saint, if either thee dislike.</body>
S:   </message>
C: </stream:stream>
S: </stream:stream>

A "session" gone bad: //出现错误的会话

C: <?xml version='1.0'?>
<stream:stream
to='example.com'
xmlns='jabber:client'
xmlns:stream='http://etherx.jabber.org/streams'
version='1.0'>
S: <?xml version='1.0'?>
<stream:stream
from='example.com'
id='someid'
xmlns='jabber:client'
xmlns:stream='http://etherx.jabber.org/streams'
version='1.0'>
...  encryption, authentication, and resource binding ...
C: <message xml:lang='en'>
<body>Bad XML, no closing body tag!
</message>
S: <stream:error>
<xml-not-well-formed
xmlns='urn:ietf:params:xml:ns:xmpp-streams'/>
</stream:error>
S: </stream:stream>

我想到这里xmpp协议应该是有一个简单了解哦。上面都是基础。深入的我会在我的空间里接着写的!  
本站仅提供存储服务,所有内容均由用户发布,如发现有害或侵权内容,请点击举报
打开APP,阅读全文并永久保存 查看更多类似文章
猜你喜欢
类似文章
【热】打开小程序,算一算2024你的财运
XMPP协议简介
XMPP-TLS和SASL握手 | 姜糖水
Openfire与XMPP协议
gloox 链接openfire服务器问题解决办法
could not connect to XMPP server via smack:no response from server
XMPP通讯过程简介
更多类似文章 >>
生活服务
热点新闻
分享 收藏 导长图 关注 下载文章
绑定账号成功
后续可登录账号畅享VIP特权!
如果VIP功能使用有故障,
可点击这里联系客服!

联系客服