leshjmail

Jabber 协议概述(转)

Jabber 协议概述

Peter Saint-Andre

[email protected]

1.4 版 Jabber 服务协议的概述

1. 介绍

Jabber 是一个由开源社区发起并领导开发的即时消息和在线状态的系统。 Jabber 系统和其它即时消息（ IM ）服务的一个功能上的差别在于 Jabber 拥有开放的 XML 协议。在保持 Jabber1.0 版本有关消息核心以及在线状态的协议的基础上，增加了一些必要的扩展。本文档将对 Jabber 服务器 1.4 版的 Jabber 协议进行介绍。

在 XML 上下文的数据流中， Jabber 开放的 XML 协议包括三个顶级 XML 元素：

l <message/>

l <presence/>

l <iq/>(info/query)

每一个元素通过属性和名字空间包含大量的数据，这些属性和名字空间都是 Jabber 的组成部分（但不包括为特殊应用的名字空间应用）。下面将描述整个 Jabber 协议。如果您想获得关于 Jabber 系统结构的信息，请查看名为 Jabber 技术概述的文档（http://docs.jabber.org/general/html/overview.html）。

2. XML 流

一个 Jabber 会话由两个平行的 XML 流组成，一个从客户端到服务器端，另一个从服务端到客户端。当一个 Jabber 客户端连接上一个 Jabber 服务器时，这个客户端将发起一个客户端－服务器的 XML 流，同时作为响应，服务器也将发起一个服务器－客户端的 XML 流。所有 <message/> ， <presence/> ，以及 <iq/> 元素都被放在这些 XML 流的上下文中。下面就有一个例子：

SEND:<?xml version=”1.0” encoding=”UTF-8” ?>

SEND:<stream:stream

SEND:to=’jabber.org’

SEND:xmlns=’jabber:client’

SEND:xmlns:stream=’http://ether.jabber.org/streams’>

RECV:<stream:stream

RECV:xmlns:stream=’http://etherx.jabber.org/streams’

RECV:id=’39ABA7D2’

RECV:xmlns=’jabber:client’

RECV:from=’jabber.org’>

(XML for user session goes here)*

SEND:</stream:stream>

RECV:</stream:stream>

* 注意：必须等到当一个 <iq/> 元素（特别指一个 ’jabber:iq:auth’ 名字空间下的 <query/> 元素）发送了认证信息后，服务器才会同意用户会话进行工作。

3. <message/> 元素

<message/> 元素是 Jabber 开放 XML 协议三个顶级元素中的一个。它被用来包含两个 Jabber 用户间互相发送消息内容，或者两个 Jabber IDs 之间更一般的消息（因为，通过神奇的传输器，另一个 IM 系统可以用 Jabber ID 代替，如[email protected]）。

3.1. 消息类型－“ type ”属性

Jabber 支持几种不同的消息，这些消息通过 <message/> 的“ type ”属性来进行区分。下面就是“ type ”属性的有效值：

3.1.1 . [default] （不设置“ type ”属性）

表示本消息是一个普通消息。默认的情况下，客户端在没有设置属性时，将消息类型定为普通消息。

例子：

<body>Wherefore art though Romeo?</body>

</message>

3.1.2 .type=”chat”

表示消息需要被一个接一个的显示在聊天界面上（一般是一条接一条的界面，不过实际界面可以被用户自己定义。）

例子：

<body>Wherefore art though Romeo?</body>

</message>

3.1.3 .type=”error”

表示消息被描述成一个错误条件。实际的错误在消息中用一个 <error/> 元素来描述。一个 <message/> 元素包括一个 <body/> 和一个 <error/> 。下面的例子将演示，当 Juliet 对一个不存在的用户发送一个“ hi ”的消息时，将收到的包体：

例子：

<message

to="[email protected]"

from="[email protected]"

type="error">

<error code="404">Not Found</error>

</message>

3.1.4 . type=”groupchat”

表示本消息需要在一个聊天室的界面中进行显示。

例子：

<body>Double, double toil and trouble</body>

</message>

3.2. <message/> 其它属性

除了设置“ type ”属性，还可以通过下面的属性修改 <message/> 元素：

3.2.1 . “ from ”属性

消息发送者的标志。总得来说， Jabber ID 的 ”from” 必须是 user@host/resource 的格式。从 XML 的观点来说，这个属性必须包含于所有的 <message/> 元素中，为了对付一些欺骗，实际应用中服务器添加或置换这个属性。因此，它并不是客户端开发者需要关心的问题。

例子：

<body>Wherefore art thou Romeo?</body>

</message>

3.2.2 . “ id ”属性

“ id ”属性是作为消息的一个唯一标志。它由 Jabber 客户端或客户库（类似 WinJab 或 JabberCOM ），生成，客户端用它来为跟踪消息（比如将发送到一个群组聊天室的信息和从这个聊天室收到的消息相关联，或将一个消息与它可能产生的错误相关联）进行标识。“ id ”属性是可选的，并且在系统的别的方是不可用的。

例子：

<body>Wherefore art thou Romeo?</body>

</message>

3.2.3 . “ to ”属性

表示消息的接收者。 Jabber ID 的“ to ”属性一般是 user@host/resource 格式， user@host 也可以被接受。如果接收者在线，通过 user@host/resource 方式解决，如果用户不在线，直接发送离线存储器。这个属性是所有 <message/> 元素必须的。

例子：

<body>Wherefore art thou Romeo?</body>

</message>

3.3. <message/> 中的子元素

下面的子元素是用来定义一个 Jabber 消息的上下文或数据元。

3.3.1 . <body/>

这个元素包含消息的主要文本。 <body/> 元素只存在于一个 <message/> 元素中，并且只能包含明文。不过，它可以由其它子元素构成（如 <error/> 、 <x/> ）。

3.3.2 . <error/>

当消息类型属性被置为“ error ”时，这个元素将被使用。错误代码被一个 ”type” 属性定义，这个 ”type” 属性包含代码数，通过 <error/> 元素来包含一个这个错误的文本描述。 <error/> 元素必须包含在原始消息的 <body/> 中。下面的例子将演示，当 Juliet 向一个不存在的用户发送“ hi ”消息后的包体：

例子：

<message

to="[email protected]"

from="[email protected]"

type="error">

<error code="404">Not Found</error>

</message>

附文中有非法代码与它们所定义的含义表。

3.3.3 . <html/>

<html/> 元素结合 XHTML 名字空间（ http://www.w3.org/1999/xhtml ），为一个消息提供一个交替的名字空间，就像在 email 世界中规定同时发送普通文本与 HTML 版本的邮件消息一样。这个功能使用的是 W3C 开发的基本 XHTML 格式（ http://www.w3.org/TR/xhtml-basic/ ），关于 Jabber 在消息中的 XHTML 执行细节，请看 Jabber 消息的暂定格式规范（ http://docs.jabber.org/draft-proto/html/xhtml.html ）。所有 XHTML 的根元素都必须是 <html xmlns=”http://www.w3.org/1999/xhmtl”></html> 。这个根元素中，支持任何一个基本 XHTML 格式中定义的元素，但不是每一个元素可以通过即时消息的上下文来进行理解。

3.3.4 . <subject/>

这是一个可选元素，包含消息的标题。

3.3.5 . <thread/>

当一个 Jabber 客户端发送一个 ”chat” 类型的消息，将生成唯一的线程 ID （通常是由发送者的 Jabber ID 和当前时间生成的一个 hash ）。消息发送者和接收者在聊天中后续的消息都包含一个 <thread/> 子元素，这个子元素包含原始线程 ID 。这使得消息发送者和接收者对回复进行认证并创建一个对话线程。下面的是例子：

<message

from="[email protected]/balcony"

to="[email protected]/orchard"

type="chat">

<thread>AAC96FEFDE226C2C04BE8F2E19A2151B</thread>

<body>Art thou not Romeo and a Montague?</body>

</message>

<message

from="[email protected]/orchard"

to="[email protected]/balcony"

type="chat">

<thread>AAC96FEFDE226C2C04BE8F2E19A2151B</thread>

<body>Neither, fair saint, if either thee dislike.</body>

</message>

3.3.6 . <x/>

<x/> 元素作为一个扩展机制来使用，或发送从服务器发送命令给客户端，或从一个客户端发送命令到另一个客户端。每次用到这个元素时，必须指明相关的 XML 名字空间。单一消息可以包含多个 <x/> 子元素实例。下列已定义的名字空间可以被 <x/> 子元素使用：

l jabber:x:autoupdate

l jabber:x:delay

l jabber:x:encrypted

l jabber:x:oob

l jabber:x:roster

这些名字空间在下面的 Jabber 名字空间中被更完整地描述。

下面是一个使用 jabber:x:delay 名字空间在加入的群组聊天室的显示上下文的例子：

<message

type=’groupchat’

from=’[email protected]’>

<body>Thrice the brinded cat hath mew’d.</body>

<x xmlns=’jabber:x:delay’

stamp=’10541031T21:43:40’>Cached In GC History</x>

</message>

4. <presence/> 元素

<presence/> 元素提供关于一个 Jabber 实体的可用性信息。任何一个通过一个 Jabber ID 确认的实体可以与另一个实体进行在线状态信息的通信，这种通信大多以订阅在线状态信息的方式进行。

所有实体表现出的在线状态不是“可用”就是“不可用”。“可用”状态表示发送者可以立即收到消息。“不可用”状态表示发送者不能在当前时间收到任何数据。默认情况下，所有 <presence/> 元素除非包含 type=”unavailable” 属性外，都表示“可用”。“可用”的更多特殊形势通过 <status/> 和 <show/> 子元素进行指定。

4.1. “ type ”属性

<presence/> 的“ type ”属性根据不同目的使用。除了提示其它用户本用户的可用性状态的“普通”用法外，还包括订阅、取消订阅、以及探测在线状态信息。下面是“ type ”属性的可用值：

4.1.1 . type=”available”

如果没有包含任何“ type ”属性，在线状态包将被设为 type=”available” ，用来提供用户在线时的信息。一个 type=”available” 的在线状态包通常包含一个 <show/> 元素以详细说明 Jabber 实体的可用类型，以及一个 <status/> 元素，该元素包含人能看懂的关于该可用类型的描述。在线状态包还可以包含一个 <priority/> 元素，来指明该连接的 Jabber ID 的优先级。

例子：

<presence

from="[email protected]/balcony"

to="[email protected]/orchard"/>

<status>Stay but a little, I will come again.</status>

</presence>

<show/> 元素的可用值为：

l away ―― Jabber 用户或实体在线，但不能马上联系上

l chat ―― Jabber 用户或实体在线并有兴趣聊天

l dnd ―― Jabber 用户或实体在线，但不想被打扰（“ dnd ”表示“ do not disturb ”）

l xa ―― Jabber 用户或实体在线，但已经离开很长时间了（“ xa ”表示“ extended away ”）

<status/> 可以包含任意特性数据，这些数据通常包含对于用户状态的描述，如，“开会中”是“ away ”的一个表现值，或者“忙于编码”可以是“ dnd ”的一个表现。

4.1.2 . type=”error”

当一个在线状态包发送给一个不存在的 JID 时，或在发送在线状态请求时发生一个错误时，服务器都将返回一个 type=”error” 的在线状态包。

下面是一个例子（注意域名的类型）：

<presence

type="subscribe"

to="[email protected]"/>

回复的例子：

<presence

from="[email protected]"

to="[email protected]/balcony"

type="error">

<error code=’504’>Remote server timeout. Unable to deliver

packet.</error>

</presence>

4.1.3 . type=”probe”

向一个特定实体（实体不能发送在线状态消息给自己）发出在线状态信息请求。服务器而非客户端，进行一个探测请求。实际上，虽然 Jabber 客户端也可以发送一个探测一个指定 Jabber 用户是否在线的请求，但通常都是服务器端发出探测请求。注意，只有在发起请求的用户在请求所对应的用户的花名册上，并且拥有“ from ”或“ both ”订阅类型时，服务器才会发出探测请求。在下面的例子中，我们将看到我们的英雄 Romeo 向 Juliet 发出一个探测请求， Juliet 所在服务器回复一个“状态报告包”（包含 jabber:x:delay 名字空间中指明的上次在线状态更新的时间戳）

探测请求的例子：

<presence

from="[email protected]"

to="[email protected]"

type="probe"/>

回复探测请求的例子：

<presence

from="[email protected]/."

to="[email protected]">

<status>Stay but a little, I will come again.</status>

xmlns="jabber:x:delay"

from="[email protected]/."

stamp="15310309T23:47:15"/>

</presence>

4.1.4 . type=”subscribe”

发送一个请求，这个请求是接收者在其在线状态改变时，自动发送在线状态信息给发送者。

例子：

<presence

from="[email protected]"

to="[email protected]"

type="subscribe"/>

4.1.5 . type=”subscribed”

发送一个消息，表明发送者接受了接受者对其再现状态订阅的请求。从现在起，当发送者的在线状态信息改变时，服务器将会把状态信息发送给接收者。

例子：

<presence

from="[email protected]"

to="[email protected]"

type="subscribed"/>

4.1.6 . type=”unavailable”

例子：

<presence

from="[email protected]"

to="[email protected]"

type="unavailable">

<status>Disconnnected</status>

</presence>

4.1.7 . type=”unsubscribe”

发送一个请求，表明接收者停止发送在线状态信息给发送者。

例子：

<presence

from="[email protected]"

to="[email protected]"

type="unsubscribe"/>

4.1.8 . type=”unsubscribed”

这种类型的在线状态包有两个用途：

1. 发送一个表明发送者接受接收者关于不订阅其在线状态信息的请求的通知。服务器将不再发送发送者的在线状态信息给接收者。

2. 拒绝一个订阅请求。服务器将不再发送发送者的在线状态信息给试图订阅其在线状态信息的用户。

例子：

<presence

from="[email protected]"

to="[email protected]"

type="unsubscribed"/>

4.2. 其它 <presence/> 属性

除了设置“ type ”属性，还可以通过下列属性修改 <presence/> 元素：

4.2.1 . “ from ”属性

标识在线状态包的发送者。一般 Jabber ID 再“ from ”属性中必须写成 user@host/resource 的格式。从 XML 的观点来说，这个属性是所有 <presence/> 元素所必须的，而在实际应用中，都是服务器对该属性进行添加和修改（防止一些欺骗的手段），因此客户端开发者不需要考虑它。

例子：

4.2.2 . “ id ”属性

为在线状态请求包配置唯一的验证符。“ id ”属性由 Jabber 客户端或客户库（如 Gabber 或 JabberCOM ）生成，客户端用其为在线状态包的轨迹进行验证。“ id ”属性是可选的，并且不能用于系统其它任何地方。

例子：

4.2.3 . “ to ”属性

标识在线状态包的接收者。一般 Jabber ID 在“ to ”属性中都是 user@host/resource 的格式， user@host 的格式也是可以的，但当接收者在线时，它将转化为 user@host/resource 。在 Jabber 的一般用法中， Jabber 客户端向服务器发出在线状态包，服务器将这些在线状态包发送到该用户花名册上所有的用户。当一个 Jabber 客户端发送的 <presence/> 元素中不含“ to ”属性时，服务器将将其转化为在线状态包发送给指定的 Jabber 实体。下面的例子将演示这一过程。

发送给服务器的在线状态的例子：

<status>Stay but a little, I will come again.</status>

</presence>

服务器发给指定用户的在线状态例子：

<presence

to="[email protected]/orchard"

from="[email protected]/balcony">

<status>Stay but a little, I will come again.</status>

</presence>

4.3. <presence/> 的子元素

下面的元素用于 <presence/> 协议。

4.3.1 . <priority/>

在 Jabber 中，根据 Jabber 知道的设备数或位置数，一个用户可以建立相同数量的连接。用户可以给每一个资源赋予一个数字优先级（通过对指派给该资源的 Jabber 客户端进行设置），这个优先级与 <presence/> 元素的子元素 <priority/> 方法进行通信。

当在线状态包发送到服务器后，服务器有能力决定哪一个连接资源需要指派一个单一的 Jabber ID ，该资源将收到发往该 Jabber ID 的消息，这是因为数字最高的资源是默认或第一资源。如果最高优先级的资源不可用，消息和其它 Jabber 通信将发送给次高优先级的资源（当其它资源都不可用时，一个没有从默认数到 0 的优先级的客户端，也可以成为第一资源）

举例来说， Julie 可以通过两个资源： the balcony 和 the chamber 连接她的帐号 [email protected] 。如果“ balcony ”资源的优先级被设置为“ 2 ” ，而“ chamber ”资源的优先级被设为“ 1 ” ，而且两个资源都可以连接，消息将发送到 [email protected]/balcony ，而不是 [email protected]/chamber 。

4.3.2 . <show/>

可选的 <show/> 元素告诉 Jabber 客户端如何显示一个用户的在线状态。 <show> 标签是一个典型的 <status> 标签的伴随标签， <status> 标签包含更多在线状态改变理由的描述信息。如果 <show/> 元素不在 <presence/> 元素中， Jabber 接收客户端将指明该用户处于“普通”状态。下面是四个可选项：

标签	含义
<show>chat</show>	该客户可以马上联系上
<show>away</show>	该客户在线，但刚刚离开（如吃午饭，开会）
<show>xa</show>	该客户在线，但已经处于非活动状态很长时间了。
<show>dnd<show>	该用户处于谢绝打扰的模式

4.3.3 . <status/>

<status/> 元素包含更多关于用户在线状态的描述。大多数 Jabber 客户端都包含一些 <status/> 元素的默认设置；另外，它们还允许我们提供富有个性的描述如“我在吃午饭”或者“钓鱼中”。

4.3.4 . <x/>

l jabber:x:autoupdate

l jabber:x:delay

l jabber:x:encrypted

l jabber:x:oob

l jabber:x:roster

这些名字空间在下面的 Jabber 名字空间中被更完整地描述。

5. <iq/> 元素

信息 / 查询 (IQ) 在 Jabber 中在两个实体间构建一个根本的会话，并且允许实体间来回传送 XML 格式的请求和响应。信息 / 查询主要的用处是取得或设置公共的用户信息，比如名字，电子邮件，地址等等。但它的灵活设计使得任何种类的会话都可以发生。任何通过一个 Jabber ID 标识的实体都能通过一个 IQ 与其它实体进行会话。

5.1. “ type ”属性

<iq/> 元素的“ type ”属性用于决定信息 / 查询是请求还是响应。下面是“ type ”属性的可用值：

5.1.1 . type=”error”

表示查询失败。实际错误在 <iq/> 元素的 <error/> 子元素中描述。

例子：

<error code="403">Forbidden</error>

</iq>

5.1.2 . type=”get”

找回指派给一个查询名字空间的信息。如果没有设置属性，默认情况，这个属性包含在查询中。一个 type=”get” 的 <iq/> 元素由一个子元素构成，这个子元素通常是 <query> ，但也可以是 <vcard/> 或另一个已有的子元素。不过，指定的子元素必须左空，以便接收一个用户所需提供的信息的空间的清单。一个成功的 get 查询的结果 type=”result” 的 <iq/> 元素，是元素嵌套在包含了所需信息的指定子元素（如 <query> 或 <vcard/> ）。

例子：

</iq>

5.1.3 . type=”result”

表示 <iq/> 包是一个 type=”get” 或 type=”set” 的 <iq/> 查询的成功响应。这个成功查询的结果是一个 type=”result” 的 <iq/> 元素，该元素嵌套在一个包含所查询的信息的子元素中（如 <query> 、 <vcard/> ）。一个成功的查询或获取查询结果的返回是一个空的 type=”result” 的 <iq/> 元素。一个不成功的返回是一个 type=”error” 的 <iq/> 元素。 <iq type=”result”/> 通常与“ id ”属性的获取、设定查询有关。

例子：

vCard data goes here

</vCard>

</iq>

5.1.4 . type=”set”

表示 <iq/> 包是对设值或更改现有数据值。一个 type=”set” 的 <iq/> 元素总是包含一个指定的子元素，通常是 <query> ，也可以是 <vcard/> 或者其它可以接受的子元素。一个设置命令查询的成功返回是一个空的 type=”result” 的 <iq/> 元素。

例子：

vCard data goes here

</vCard>

</iq>

5.2. 其它 <iq/> 属性

除了“ type ”属性外， IQ 元素还可以通过下面的属性进行修改。

5.2.1 . “ from ”属性

表示 iq 包的发送者。从 XML 观点来说，这个属性是所有 <iq/> 元素所必须的，实际应用中这个属性是服务器来增加和修改的（为防止某些欺骗），因此客户端的开发人员不需要过多关注这个属性。

例子：

5.2.2 . “ id ”属性

一个 iq 包只有唯一的标识。 Jabber 客户端或客户库生成“ id ”属性，客户端通过它来标识 <iq/> 包，以完成对 <iq/> 包的跟踪（如：一个 type=”result” 对应一个 type=”get” 或 type=”set” ）。“ id ”属性是可选的，并且不能用于系统的其它地方。

例子：

5.2.3 “ to ”属性

表示 iq 包的接收者。在 Jabber 客户端，对应“ to ”属性的 Jabber ID 的格式为 user@host/resource 。 user@host 也是可以的，如果用户在线， user@host 将被置换成 user@host/resource ，如果用户不在线， user@host 将被直接指向一个离线模块（对于类似服务器端网关这种非用户实体，情况又有所不同，因为它们不拥有资源，并且只是简单通过 Jabber ID 的一个“ server ”端口进行标识。 Jud.jabber.org —— Jabber 用户目录就是这样一个例子）。如果 <iq/> 包没有 <to> 属性，服务器将对该包进行处理。

例子：

5.3 <iq/> 的子元素

下面介绍 <iq/> 元素的子元素。

5.3.1 . <error/>

当 iq 的属性类型被设置为“ error ”时，将用到本属性。错误代码根据一个含有错误数的“ type ”属性进行定义， <error/> 员司包含该错误的文本描述。比如，下面就是一个坏请求：

<error code="400">Bad Request</error>

在附录中，列有错误编码及其对应的错误描述。

5.3.2 . <key/>

<key/> 元素为客户端－服务器之间交互提供一层安全保护。它被用户 jabber:iq:register 和 jabber:iq:search 名字空间中。

当一个客户端发起一个与服务其之间的交互时，服务器将发送一个包含一个唯一值的 <key> 给客户端。客户端在返回 <iq type=”set”/> 的消息中，包含上诉唯一值到 <key/> 子元素中。这样，服务器就认为该客户端时接收到原来密码的同一实体。

5.3.3 . <query/>

<iq/> 元素中的 <query/> 子元素定义所执行的查询的类型。特殊情况下，查询可以拥有一个特殊的名字空间，这个名字空间是一个通过“ xmlns ”属性定义的 <query/> 子元素。一个 <iq/> 元素中只能有一个 <query/> 子元素。

下面的例子是当我通过我的 Linux 机器上的 Grabber 客户端登陆到服务器上，将出现的 XML 。

<username>stpeter</username>

<resource>Gabber</resource>

</query>

</iq>

就象你看到的那样，认证查询通过客户端认证名字空间（ jabber:iq:auth ）向服务器发送认证信息。一般， Jabber 核心协议保留 jabber:iq:* 这样的名字空间。而开发者可以通过增加 jabber:iq:* 名字空间对 Jabber 核心进行扩展。这些将在下面的名字空间中进行更完整的描述。

一个空 <query/> 子元素可以与 <iq type=”get”> 元素一起发送，这样可以找回与 <query/> 子元素中指定的名字空间相关的一个 Jabber 实体的信息。比如，找回一个客户端的花名册（“联系人名单”），下面的 XML 可以被发送：

</iq>

6. 名字空间

现面是 Jabber 中的标准名字空间：

l jabber:iq:agent ——代理工具

l jabber:iq:agents ——有效的代理组

l jabber:iq:auth ——简单用户认证

l jabber:iq:autoupdate ——版本更新申请

l jabber:iq:browse —— Jabber 浏览

l jabber:iq:conference ——一般会议

l jabber:iq:gateway ——用户地址网关

l jabber:iq:last ——上次使用时间

l jabber:iq:oob ——绑定数据输出

l jabber:iq:private ——私有数据存储

l jabber:iq:register ——注册请求

l jabber:iq:roster ——花名册（联系人名单）管理

l jabber:iq:search ——用户数据库查询

l jabber:iq:time ——客户端时间

l jabber:iq:version ——客户端版本

l jabber:x:autoupdate ——版本通知申请

l jabber:x:conference ——会议邀请

l jabber:x:delay ——显示的对象

l jabber:x:encrypted ——加密的消息

l jabber:x:envelope ——消息封套

l jabber:x:event ——消息事件

l jabber:x:expire ——消息终止

l jabber:x:oob ——绑定数据（文件传输）输出

l jabber:x:roster ——内部的花名册条目

l jabber:x:signed ——标记的在线状态

l vcard-temp ——临时的 vCard

下面将详细介绍这些名字空间的细节。

6.1. jabber:iq:agent ——代理工具

代理工具名字空间包含一个代理的所有工具。 jabber:iq:angents 查询通常用于注册到一个指定的服务、代理、传输器。

它也可能检验一个指定代理的所有工具细节。比如，一个客户端可以决定一个开放的注册是否可以进行。

例子：

<name>AIM Transport</name>

<description>This is the AIM Transport</description>

<transport>AIM/AOL ScreenName</transport>

</agent>

</query>

</iq>

6.2. jabber:iq:angents ——可用的代理列表

可用代理列表名字空间包含一组实体，这些实体拥有一些特殊工具，并能够为另一个实体提供服务。大多数情况下，可用代理列表是用来显示一台服务器上的可用传输器列表。

注意：这个名字空间被 jabber:iq:browse 的支持者所反对（？？）。

例子：

<name>User Directory</name>

You may register and create a public searchable

profile, and search for other registered Jabber

users.

</description>

</agent>

<name>AIM Transport</name>

<description>This is the AIM Transport</description>

<transport>AIM/AOL ScreenName</transport>

</agent>

</query>

</iq>

6.3. jabber:iq:auth ——简单客户端认证

简单客户认证名字空间是对客户端进行认证的一个简单机制，它为客户端到服务器之间的连接创建一个资源。

认证成功返回一个 type=”result” 的 IQ 响应。不成功，就返回一个错误 IQ 元素。

如果没有发送名字空间或密码，如果服务器允许，服务器将创建一个匿名资源。

例子：

<username>juliet</username>

<password>secret</password>

<resource>balcony</resource>

</query>

</iq>

<username>juliet</username>

<resource>balcony</resource>

</query>

</iq>

<username>juliet</username>

<hash499>secret</hash499>

<resource>balcony</resource>

</query>

</iq>

6.4. jabber:iq:autoupdate ——版本更新申请

版本更新申请名字空间允许客户端对所有可用软件更新进行申请请求。

例子：

</iq>

6.5. jabber:iq:browse —— Jabber 浏览

Jabber 浏览名字空间的作用是，一是为 Jabber 世界中已有的 Jabber IDs 增加结构的一个途径，一是发现为不同 Jabber 实体提供的服务或应用。一个 Jabber 浏览的基本概念就是一个 jid-type （类似文件的一个模拟类型的概念）。下面是想象中的最高级别的 jid-types ，不过随着时间的推移，一些其它的逻辑将被增加进来：

l 应用

l 会议

l 标题

l 关键字

l 回报

l 服务

l 用户

上面每一个范畴都有一个子类列表，如用户 / 客户端，或用户 / 设备（“客户端”或“设备”只是一个“资源”的概念），会议 /irc ，服务 /icq ，标题 / 库存。一般的，通过使用 jabber:iq:browse 名字空间你将拥有一个与上述某一 jid-type 范畴相对应的元素，这个元素通常有一个指定子类型的“ type ”属性。

Jabber:iq:browse 的一个用户就是代替 jabber:iq:agents 名字空间来列出一个服务器上所对应的代理或其它服务。下面是一个浏览服务器的例子：

Jabber 客户端发送：

</iq>

Jabber 服务器返回：

<service

type="jabber"

jid="jabber.org"

xmlns="jabber:iq:browse>

<service

type="jud"

jid="users.jabber.org"

name="Jabber User Directory">

<ns>jabber:iq:register</ns>

<ns>jabber:iq:search</ns>

</service>

<service

type="aim"

jid="aim.jabber.org"

name="AIM Transport">

<ns>jabber:iq:register</ns>

<ns>jabber:iq:search</ns>

</service>

<conference

type="private"

jid="conference.jabber.org"

name="Private Chatrooms">

</service>

</iq>

在会议中的一个例子：

</conference>

</iq>

6.6. jabber:iq:conference —— 一般会议

一般会议名字空间提供一个会议室的机制（如群组聊天室），并提供该会议室的入口。这个名字空间与 </iq> 元素配套使用来获得一个会议室的信息，包括要求加入这个会议室的请求信息，以及为这个会议室设置信息（通常是为了加入这个房间）。一个普通进入房间的请求将和下面的类似：

1. 想要加入的房间提交一个 type=”get” 的请求。这个 XML 将是下面的形式：

</iq>

2. 接受来自要加入的房间的 type=”result” 的 iq 响应，其中有进入房间所需要的参数。这个 XML 将是下面的形式：

<nick/>

</query>

</iq>

这里所有的请求元素的子元素都是可选的。昵称 (nickname) 元素表示进入房间需要一个昵称。密钥 (secret) 元素表示进入房间的用户需要提供一个密码。独处 (privacy) 元素表示如果用户在一个 type=”set” （下面可以看到例子）的 iq 包中提供这样的元素，会议服务器将隐藏用户的真实 Jabbere ID 。名字（ name ）元素是房间的名字（用 jabber ： iq:browse 浏览房间时可以看到同样的房间名）。

3. 发送当前状态给要加入的房间。 XML 如下：

4. 想要加入的房间提交一个 type=”set” 的 iq 包以及进入所需信息。 XML 如下：

<nick>mynick</nick>

<nick>mysecondnick</nick>

<secret>thesecret</secret>

</query>

</iq>

注意在用户第一个选择被接受时，用户可以提交多个昵称。如果用户没有提供昵称，服务器将指派一个昵称给用户。

5. 收到你加入的房间的通知，这个 iq 以下面的格式返回：

<id>room@server/uniqueidnumber</id>

<nick>mynick</nick>

</query>

</iq>

这个唯一的 ID 号是用户 Jabber ID 的一个哈希。

6.7. jabber:iq:gateway ——用户地址网关

一般通过一个网关或传输器（比如 AIM 传输器）来实现与非 Jabber 网络用户的通信，每一个非 Jabber 网络都可能拥有唯一的用户地址，这个地址可能和 Jabber IDs 并不统一。用户地址网关就是解决这个问题的，它使得 Jabber 客户端向非 Jabber 网络用户发出订阅时给出正确 Jabber IDs 变得很容易。这些通过对用户进行提示和会话，引导用户提供创建一个正确 Jabber ID 所需信息来实现。下面将演示这种普通的交互：

1. 客户端向网关发出带有 jabber:iq:gate 名字空间查询的 iq get ：

</iq>

2. 服务器返回一个包含请求批准及其描述文本的 iq ：

<desc>

Please enter the AOL Screen Name of the person

you would like to contact.

</desc>

<prompt>Screen Name</prompt>

</query>

</iq>

3. 客户端向网关发送一个包含指定信息的 iq set ：

</query>

</iq>

4. 服务器返回一个包含正确 Jabber ID 的 iq result

<jid>[email protected]</jid>

</query>

</iq>

6.8. jabber:iq:last ——最后一次在线时间

最后一次在线时间名字空间提供一个标准的方法，通过这个方法可以查询一个 Jabber 实体一个或多个服务更新时间，或者一个客户最后一次连接（或活动）到一台服务器上的时间。每一次返回的值都是一个秒的数目。进行查询的实体可以通过下面的法则解释获取的信息：

l user@server/resource ——用户最后一次活动的时间

l user@server ——用户最后一次连接的时间

l server ——服务器最后一次启动的时间

例子（服务器）：

</iq>

</iq>

例子（客户端）：

</iq>

Disconnected

</query>

</iq>

6.9. jabber:iq:oob ——绑定数据输出

绑定数据输出名字空间为客户端－客户端的文件传输提供一个标准方法，通过服务器的传输 / 代理的传输器实现一个特殊的名字空间：

例子：

<url>http://denmark.com/act4/letter-1.html</url>

<desc>There’s a letter for you sir.</desc>

</query>

</iq>

6.10. jabber:iq:private ——私有数据存储

私有数据存储名字空间是 Jabber 服务器上存储私有数据的一个机制。存储的数据可以是任何合法的 XML 数据。在服务端存放客户端的当前状态信息是这个名字空间的典型用法。

例子 1 （客户端存储私有数据）：

<defaultnick>Hamlet</defaultnick>

</winjab>

</query>

</iq>

例子 2 （客户端找回私有数据）：

</query>

</iq>

另外，对于私有数据存储， 1.4 版服务器支持服务器上所有有效名字空间（以“ jabber ”开头的名字空间保留，为 Jabber 系统进行调用）的 XML 数据。这个数据存在向服务器端发送 type=”set” 的 iq 包的用户的花名册中。

例子 1 （客户端保存公有数据）：

<fav_things>

</fav_things>

</query>

</iq>

例子 2 （客户端找回公有数据）：

<fav_things/>

</query>

</iq>

6.11. jabber:iq:register ——注册请求

注册请求名字空间对一个或多个服务进行注册。它也被用来更新或删除一个注册。

例子：

Some instructions to be displayed when the

user is filling out the form.

</instructions>

<date/>

<key/>

</query>

6.12. jabber:iq:roster ——联系人名单管理

联系人名单管理名字空间是客户端用来管理他们的花名册的，该花名册保存在服务器上，这样用户可以在任何地方得到它。花名册是该帐号上所有订阅信息的命令列表，包括用户昵称和联系列表。当用户从任何一个资源登陆上来，服务器将把花名册发送给用户。

花名册是一个条目的列表。每一个条目元素都有描述它的属性。每一个条目元素都包含它所属组的组元素。下面是描述 <item/> 元素的属性：

l “ jid ”是条目的 Jabber ID

l “ subscription ”所有和本条目相关的订阅所对应的用户的当前状态。它可以是“ none ”（不可订阅），“ to ”（有一个发到该条目的订阅），“ from ”（从该条目发送一个订阅给我们），“ both ”（ to 、 from ），或者“ remove ”（从花名册上删除一个条目）。

l “ ask ”是对这个条目的一个请求的当前状态。 Subscribe 表示请求对该条目进行订阅，它的值就是， Unsubscribe 表示取消订阅。

l “ name ”表示昵称

通过使用一个 <iq type=”set”/> ，一个 Jabber 客户端可以控制用户的 JabberID ，名称属性，群组元素，并且可以在联系人名单上创建或删除联系人。服务器根据客户端对当前状态订阅请求的响应来管理其它所有属性。

订阅请求的例子：

<item jid="[email protected]"

name="Romeo"

subscription="none"

ask="subscribe">

<group>friends</group>

</item>

</query>

</iq>

当一个花名册条目在服务器上改变时，服务器将把这个改变推送给一个用户。这个推送是一个普通的从服务器发送到客户端的 <iq type=”set”/> 包。下面是一个例子：

</query>

</iq>

在上面的例子中，服务器推送给客户端一个花名册，表明该用户对 [email protected] 的当前状态信息有订阅。一个花名册推送可能发生一个连接的任何时间中，该连接是另一个连接修改资源或服务器（修改订阅属性）的结果。客户端只有使用花名册推送来改变花名册的显示。但不是每次花名册推送都对用户起作用。

6.13. jabber:iq:search ——用户数据库查询

任何一个代理都可以成为一个查询代理。例如， JUD 查询 Jabber 用户， ICQ 传输器查询 ICQ 用户。

用户发送一个进行可查询域的 Get 请求：

<iq

type="get"

id="1001"

to="users.jabber.org"

from="[email protected]/orchard">

</iq>

查询代理返回一个可查域：

<instructions>Fill in a field to search for any

matching Jabber User

</instructions>

<name/>

<last/>

<nick/>

</query>

</iq>

注意这些域是以提示的形式返回。为了传输的安全还包含一个密钥（下面会看到）。用户现在可以在允许的域内进行标准的查询了。用户发回一个 Set 请求给代理进行实际查询：

<iq

type="set"

id="1002"

to="users.jabber.org"

from="[email protected]/orchard">

<last>Capulet</last>

</query>

</iq>

服务器根据查询返回结果：

<name>Juliet Capulet</name>

<first>Juliet</first>

<last>Capulet</last>

<nick>juliC</nick>

</item>

<name>Sampson Capulet</name>

<first>Sampson</first>

<last>Capulet</last>

<nick>sammy</nick>

</item>

</query>

</iq>

注意有两套 items 标记含有指定信息。这是因为通过代理发送返回有两种方法：

l 单一返回标签

l 多个“ pushed ”到用户的标签，类似花名册推送，如在一个时间上的一个记录。

发送的返回的样式是查询代理的一个工具。比如：

<email>[email protected]</email>

<nick>juliC</nick>

<given>Juliet</given>

<family>Capulet</family>

</item>

</query>

</iq>

多个查询结果通过服务器进行推送。当所有数据发送完毕，服务器将发送下面的返回结果：

</iq>

客户端接收到多个“ sets ”，每一个都被记录，最后收到一个表示“数据结尾”的“返回”。在每一个 <item> 标签中， JID 属性都被强制带上。

例子：

<iq

type="get"

id="1001"

to="users.jabber.org"

from="[email protected]">

</iq>

6.14. jabber:iq:time ——客户端时间

客户端时间名字空间是客户端改变当前时间的一个标准方法。

例子：

</query>

</iq>

6.15. jabber:iq:version ——客户端版本

客户端版本名字空间是得到另一个用户的客户端的版本信息的一个标准方法。

例子：

<name>Gabber</name>

<version>0.8.1 (Powered by: jabberoo 1.0.0</version>

<os>Linux 2.2.16-22 i686</os>

</query>

</iq>

6.16. jabber:x:autoupdate ——应用程序版本通知

版本更改申请名字空间使服务器可以在一个应用的新版本可用时通知客户端。

例子：

<x xmlns="jabber:x:autoupdate">A new version of WinJab

is available, see http://winjab.sourceforge.net/

</x>

</message>

6.17. jabber:x:conference ——会议邀请

会议邀请名字空间使用户可以邀请其它 Jabber 用户到指定会议室。相关联信息——该会议室的 Jabber ID ，内嵌在一个消息的 <x/> 元素中。

例子：

<body>Wherefore art thou Romeo?</body>

</message>

6.18. jabber:x:delay ——标记对象延时

标记对象延时名字空间是消息和当前状态信息的时间戳信息，其中，当一个 Jabber 实体不在线时，当前状态信息可以保存并在稍后发送。当实体上线时，包含的信息标记对象延时名字空间使 Jabber 客户端显示出该包体最早产生的时间，而不是它发送给 Jabber 实体的时间。

例子：

<message

type=’groupchat’

from=’[email protected]’>

<body>Thrice the brinded cat hath mew’d.</body>

<x xmlns=’jabber:x:delay’

stamp=’10541031T21:43:40’>Cached In GC History</x>

</message>

6.19. jabber:x:encrypted ——加密消息

加密消息名字空间用来支持使用公共密钥（一般通过客户端使用 PGP 或 GPG ，服务端用同样的名字空间进行加密来实现）加密的消息交互。一个相关的名字空间， jabber:x:signed ，用来进行当前状态信息的加密。

例子：

<body>This Message is Encrypted</body>

hQEOA7ucqu53AhlPEAP/ZbU6oPnRAbIcUxMK1XRVnkgZ/Agtq1tcTQuEZxbpZLl4

C/4psQGLgBU5h5Y3/khxtJTPXKn1izyc+DRZ8hqn2p4mwC8ioKTBJ6P6dfEpQEyt

a4bimM5fqdeh4gRkMhwThRSJxBCJBVVWFEViu+0KlHHB5AeeL4qwRGb2dhGjIgQD

/R9x0D0qtgBGwf/TVnRGZYRX7epxCNuNDEYKZSs4LEoTPL8CVsAWOzS2QgS0GBqt

tFDKId6XaNu36dB2D8VHdxQnI8RtHo9pfTYDaXWB3dMGTt896iEO/sTuucYObf3s

K5Kygg0uWpBpvQPj8Y041FhnUBz8DRGCnuFLQxCI6ch4ybauXfOKNOGDQwmsnJZm

6OaeVFUwdsedI3c6VdQtodnWVutckR5BOjnn0VqnhrVTu7cp6VXrrRK4g9atPEe6

C4R/MilBjzIJBcET0jhWuAyiBo3gN/6IqYRZNSXL9ZqGPJwNTlYim1EHN3qBqiUw

zUMamEoRzcusn80Z7kylve5ujIeSD/pVwoawHHvLp92kO2hd0yGD0UrWSfKU1o6y

EY8yhZ5P1v02pIKigAUI2c6LTDxt/KhSxQ==

=fijN

</x>

</message>

6.20. jabber:x:envelope ——消息信封

消息信封名字空间是表明消息有更多的寻址方式，如联合 email 进行的寻址。下面是一些所支持的名字空间：

l to

l cc

l replyto

l from

l forwardedby

上述每一个元素都带有一个 ”jid” 属性来标识 Jabber 实体是发送、中转、还是收到消息。

例子：

<body>And there I am. Where is my Romeo?</body>

<to jid=’[email protected]>Romeo</to>

</x>

</message>

6.21. jabber:x:event ——消息事件

消息时间名字空间是标识一条消息的状态的一个机制。现在，事件与一条消息如下般相关联：

l <composing/> ——个用户正在对消息进行回复

l <delivered/> ——发送给指定接收者的消息

l <displayed/> ——显示给指定接收者的消息

l <offline/> ——为离线进行存储的消息

对于客户端来说，这些消息事件的支持是可选的，而且，只有在另一用户在聊天中发出请求，这些消息事件才会被发送。不同的 Jabber 客户端将对当前状态消息事件进行不同的显示。

对消息通知的请求的例子：

<message

from="[email protected]/balcony"

to="[email protected]/orchard"

id="1001">

<body>By whose direction found’st thou out this place?</body>

</x>

</message>

发送消息通知的例子：

<body>By whose direction found’st thou out this place?</body>

</x>

</message>

可以同时请求多个消息事件。

6.22. jabber:x:expire ——消息到期

消息到期名字空间是说明一条消息拥有一个有限的存活事件的一个简单扩展。如果消息被离线存储，而到了到期时间，服务器将不再发送该消息。如果一条消息为预览就进行发送， Jabber 客户端可以选择不显示该消息。“ secondes ”属性定义消息发送的事件。

例子：

<body>There’s a letter for you sir</body>

</message>

6.23. jabber:x:oob ——绑定数据输出

绑定数据输出名字空间使用户可以通过交换一个标准的 URL 来实现文件传输的目电。使用 jabber:x:oob 的 URLs 交换可以包含任一消息（在一个 <x/> 子元素内），感觉就像 email 里的附件一样。多个附件可以包含在同一个消息中。

例子：

<body>URL Attached.</body>

<url>http://denmark.com/act4/letter-1.html</url>

<desc>There’s a letter for you sir</desc>

</x>

</message>

6.24. jabber:x:roster ——内置的花名册条目

内置的花名册条目使用户可以在一个消息中包含花名册条目，这样很容易在用户之间发送联系方式。每一个花名册条目都包含在一个 <x/> 的一个 <item/> 子元素中。这个 <x/> 元素一般用在一个 <message/> 元素中，但这不是必须的。

例子：

<body>

Here are some new Jabber users

to add to your contact list!

</body>

<group>Royalty</group>

</item>

<group>Friends</group>

</item>

</x>

</message>

6.25. jabber:x:signed ——有符号的当前状态

有符号的当前状态名字空间用来支持交换使用公共密钥（客户端使用 PGP 或 GPG ，服务端使用同样的名字空间进行加密）加密的当前状态信息。一个相关的名字空间， jabber:x:encrypted 用来支持加密消息。

例子：

<status>be back later</status>

iD8DBQA6kasv0xpc2/POfPkRAnz0AJ9UEYYWWSReddIKk3AYMfTFtqQDJwCfbcLd

JcSUOR0FlS+rDFjAPaSMgSM+iNaNm

</x>

</presence>

6.26. vcard-temp ——临时 vCard

vCard 格式是一个“电子商务卡的标准格式，通过使用通过互联网进行个人数据的直接交换，如同在非互联网下的环境一样”。由于 XML 的 vCard 的格式还没有标准化， Jabber.org 项目在 XML 的 vCard 标准建立之前，暂时设置了这样一个临时名字文件。由于这几年在 vCard 的 XML 的官方标准的指定上没有任何进步， Jabber.org 开发者专门为这个项目创建了一个项目吸引 Jabber 社区外其它开发者的注意。因此，最后的 XML 的 vCard 格式的最后 DTD 可能会在下面的 URL 中找到：

http://www.vcard-xml.org/

例子 1 （对 vCard 的客户端请求）：

</iq>

例子 2 （客户端收到 vCard 数据）：

vCard data goes here

</vCard>

</iq>

例子 3 （客户端向服务端发送 vCard ）：

vCard data goes here

</vCard>

</iq>

7. 使用用例

这一部分提供一些在 Jabber 协议上略有不同的观点，通过用例来阐述。下面每一个例子都展示一个 Jabber 用户完成一个完整的任务的消息流程，该流程包括接收和发送，如注册到一台服务器，登陆，改变当前状态，或者发送一条消息。如果时间允许，我将把这部分引申的更远。

7.1. Jabber 用户注册

本用例同时邪显示 Jabber 用户向服务器开启一个 socket 的连接，以及服务器的响应 ( 如： <stream:stream> 标签 ) 。

1. Jabber 用户通过开启一个从客户端到服务器端的 XML 流，来申请一个在服务器上的 socket 连接。

SEND: <stream:stream

to=’capulet.com’

xmlns=’jabber:client’

xmlns:stream=’http://etherx.jabber.org/streams’>

2. 服务器通过开启一个从服务器到客户端的 XML 流进行回复。

RECV: <stream:stream

from=’capulet.com’

id=’180763465’

xmlns=’jabber:client’

xmlns:stream=’http://etherx.jabber.org/streams’>

3. Jabber 用户提供一个需要注册一个帐号（理论上，这需要一个不同的顺序：首先询问服务器需要什么信息，然后服务器器告知客户端需要什么样的信息；但在实际中，假定需要的信息是：用户名，资源，密码）的信息。

SEND: <iq id=’1’ type=’set’>

<username>Juliet</username>

<resource>balcony</resource>

</query>

</iq>

4. 服务器响应一个空的类型为 ”result” 的 iq 元素，表示注册已成功。

RECV: <iq id=’1’ type=’result’/>

7.2. Jabber 用戶登陆

1. Jabber 用户询问服务器，登陆所需要提供的信息。

SEND: <iq id=’2’ type=’get’>

<username>Juliet</username>

</query>

</iq>

2. 服务器提示 Jabber 用户登陆所需要的信息。

RECV: <iq id=’2’ type=’result’>

<username>Juliet</username>

</query>

</iq>

3. Jabber 用户提供所需的信息——在本例中，是一个 <hash/> 元素，它是对信息进行一个零度知识认证的一个哈希。（详情请见http://docs.jabber.org/draft-proto/html/zerok.html）。

SEND: <iq id=’3’ type=’set’>

<username>Juliet</username>

<resource>balcony</resource>

<hash>77d7eacde5e56b9622d0a075cb88361b110f

b9d7</hash>

</query>

</iq>

4. 服务器响应一个空的类型为 ”result” 的 iq 元素，表明登陆成功。

RECV: <iq id=’3’ type=’result’/>

5. Jabber 用户发送当前状态给服务器，表明其在线。

SEND: <presence>

<status>Online</status>

</presence>

7.3. Jabber 用户增加一个联系人

1. Jabber 客户端在花名册上增加一个联系人（只是预备的操作）。

SEND: <iq type=’set’>

<item jid=’[email protected]’

Name=’remeo’/>

</query>

</iq>

2. Jabber 用户发送一个对该联系人的订阅请求。

SEND: <presence to’[email protected]’ type=’subscribe’>

<status>Wherefore are thou?</status>

</presence>

3. 服务器发送一个花名单推送给用户一个新条目和一个类型为 ”none” 的订阅（早已有了该订阅）。

RECV: <iq type=’set’>

<item jid=’[email protected]’

name=’romeo’

subscription=’none’/>

</query>

</iq>

4. 服务器发送一个类型为 ”result” 的 iq 包，表示花名册推送成功（让人有点疑惑的是，这个包是从 Jabber 用户发送到 Jabber 用户的！）

RECV: <iq

from=’[email protected]/balcony’

to=’[email protected]/balcony’

type=’result’>

5. 服务器发送另一个花名单推送，这次是 ask=’subscribe’ 属性，表示订阅的状态未定。

RECV: <iq type=’set’>

<item

ask=’subscribe’

jid=’[email protected]’

name=’romeo’

subscription=’none’/>

</query>

</iq>

6. Romeo 对订阅请求的下一个响应会是什么呢？现在我们假定订阅以 Romeo 接受订阅请求为“结束”的。

RECV: <presence

from=’[email protected]’

to=’[email protected]’

type=’subscribed’/>

7. 服务器再次发送一个花名单推送给客户端，这次 subscription=’to’ ，表示订阅请求被接受了（ Juliet 现在可以订阅到 Romeo 的当前状态了）。

RECV: <iq type=’set’>

<item

jid=’[email protected]’

name=’romeo’

subscription=’to’/>

</query>

</iq>

7.4. Jabber 用户获得花名册

SEND: <iq type=’get’>

</iq>

RECV:<iq from=’[email protected]/balcony’ type=’result’>

<item

jid=’[email protected]’

name=’romeo’

subscription=’both’/>

</query>

</iq>

7.5. Jabber 用户发送一条消息

SEND: <message to’[email protected]’>

<body>Wherefore are thou?</body>

</message>

注意：服务器会根据 Jabber 用户的会话信息加上一个源地址，这样接收者收到消息时，消息中已经包含了源地址。

7.6. Jabber 用户改变当前状态

SEND: <presence>

<status>stepped away…</status>

</presence>

7.7. Jabber 用户登出

登出时很容易的，只需要关闭 <stream> ……

SEND: </stream:stream>

RECV: </stream:stream>

8. 参考文献

本协议参考以下文献

l Jabber 开发指南（http://docs.jabber.org/jpg/）

l Jabber 协议――标准（http://docs.jabber.org/proto/）

l Jabber 协议――草案（http://docs.jabber.org/draft-proto/）

l Romeo and Juliet

( http://tech-two.mit.edu/Shakespeare/Tragedy/romoandjuliet/full.html )

9. 结束语

本文档提供了一个关于 Jabber 的 XML 协议的一个详细的怪数。如果你对本文档有任何问题，请通过 email 或 Jabber 的方式自由地与作者联系（ Peter Saint-Andre ），他的帐号时 [email protected] 。

10. 版权信息

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (http://www.gnu.org/copyleft/fdl.html),

Version 1.1 or any later version published by the Free Software Foundation, with no

Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You may obtain a

copy of the GNU Free Documentation License from the Free Software Foundation by

visiting http://www.fsf.org/ or by writing to:

The Free Software Foundation, Inc.

59 Temple Place - Suite 330

Boston , MA 02111-1307

USA

附录 A 标准错误代码

下面是 Jabber 中错误代码的一些简要描述。 Jabber 服务器在碰到不同的错误条件下生成这些错误代码。一般 Jabber 错误代码以 HTTP 规格的 RFC 2616 （ http://www.ietf.org/rfc/rfc2616.txt ）为基础。但 Jabber 没有使用所有的 HTTP 的错误代码，并且 Jabber 错误代码与 HTTP 错误代码相对应时，通常只有 Jabber 自己的含义。注意本附录只包含 Jabber 服务器生成的错误代码，而不包括服务器端组件如网关发到外部消息系统。

错误代码	描述	注意
302	重定向	尽管 HTTP 规定中包含八种不同代码来表示重定向， Jabber 只用了其中一个（用来代替所有的重定向错误）。不过 Jabber 代码 302 是为以后的功能预留的，目前还没有用到
400	坏请求	Jabber 代码 400 用来通知 Jabber 客户端，一个请求因为其糟糕的语法不能被识别。例如，当一个 Jabber 客户端发送一个的订阅请求给它自己活发送一条没有包含“ to ”属性的消息， Jabber 代码 400 就会产生。
401	未授权的	Jabber 代码 401 用来通知 Jabber 客户端它们提供的是错误的认证信息，如，在登陆一个 Jabber 服务器时使用一个错误的密码，或未知的用户名。
402	所需的费用	Jabber 代码 402 为未来使用进行保留，目前还不用到。
403	禁止	Jabber 代码 403 被 Jabber 服务器用来通知 Jabber 客户端该客户端的请求可以识别，但服务器拒绝执行。目前只用在注册过程中的密码存储失败。
404	没有找到	Jabber 代码 404 用来表明 Jabber 服务器找不到任何与 JabberID 匹配的内容，该 JabberID 是一个 Jabber 客户端发送消息的目的地。如，一个用户打算向一个不存在的 JabberID 发送一条消息。如果接受者的 Jabber 服务器无法到达，将发送一个来自 500 级数的错误代码。
405	不允许的	Jabber 代码 405 用在不允许操作被 ’from’ 地址标识的 JabberID 。例如，它可能产生在，一个非管理员用户试图在服务器上发送一条管理员级别的消息，或者一个用户试图发送一台 Jabber 服务器的时间或版本，或者发送一个不同的 JabberID 的 vCard 。
406	不被接受的	Jabber 代码 406 用于服务器因为某些理由不接受一个包。例如，这个可能发生在，一个 Jabber 客户端试图使用 jabber:iq:private 在服务器上存储信息，但当前的用于存储的名字空间用 ”jabber:” 开头（在 Jabber 里是一个被存的 XML 开头）。另一种可能产生 406 错误的情况是当一个 Jabber 客户端试图用一个空密码注册到一台 Jabber 服务器上。
407	必须注册	Jabber 代码 407 当前不被使用
408	注册超时	当一个 Jabber 客户端不能在服务器准备好的时间内发起一个请求时， Jabber 服务器生成 Jabber 代码 408 。这个代码当前只用于 Jabber 会话管理器使用的零度认证模式中。
409	冲突	略
500	服务器内部错误	当一台 Jabber 服务器遇到一种预期外的条件，该条件阻止服务器处理来自 Jabber 客户端的包，这是将用到 Jabber 代码 500 。现在，唯一会引发 500 错误代码的时间是当一个 Jabber 客户端试图通过服务器认证，而该认证因为某些原因没有被处理（如无法保存密码）。
501	不可执行	当服务器不支持 Jabber 客户端请求的功能，使用 Jabber 代码 501 。例如，该代码只当 Jabber 客户端发送一个认证请求，而该认证请求不包含服务器配置中定义的任何一种认证方式时，服务器发送 Jabber 代码 501 。这个代码还被用于，当一个 Jabber 客户端试图注册一个不允许注册的服务器。
502	远程服务器错误	当因为无法到达远程服务器导致转发一个包失败时，使用 Jabber 代码 502 。该代码发送的特殊例子包括一个远程服务器的连接的失败，无法获取远程服务器的主机名，以及远程服务器错误导致的外部时间过期。
503	服务无法获得	当一个 Jabber 客户端请求一个服务，而 Jabber 服务器通常由于一些临时原因无法提供该服务时，使用 Jabber 代码 503 。例如，一个 Jabber 客户端试图发送一条消息给另一个用户，该用户不在线，但它的服务器不提供离线存储服务，服务器将返回一个 503 错误代码给发送消息的 JabberID 。当为 vcard-temp 和 jabber:iq:private 名字空间设置信息时，出现通过 xdb 进行数据存储的写入错误，也使用该代码。
504	远程服务器超时	Jabber 代码 504 用于下列情况 : 试图连接一台服务器发生超时，错误的服务器名。
510	连接失败	Jabber 代码 510 目前还没有使用。

转自:http://blog.csdn.net/kunp/archive/2004/06/30/30465.aspx

你可能感兴趣的:(Jabber 协议概述(转))

QQ群采集助手，精准引流必备神器 2401_87347160 其他经验分享
功能概述微信群查找与筛选工具是一款专为微信用户设计的辅助工具，它通过关键词搜索功能，帮助用户快速找到相关的微信群，并提供筛选是否需要验证的群组的功能。主要功能关键词搜索：用户可以输入关键词，工具将自动查找包含该关键词的微信群。筛选功能：工具提供筛选机制，用户可以选择是否只显示需要验证或不需要验证的群组。精准引流：通过上述功能，用户可以更精准地找到目标群组，进行有效的引流操作。3.设备需求该工具可以
机器学习与深度学习间关系与区别 ℒℴѵℯ心·动ꦿ໊ོ꫞ 人工智能学习深度学习 python
一、机器学习概述定义机器学习（MachineLearning,ML）是一种通过数据驱动的方法，利用统计学和计算算法来训练模型，使计算机能够从数据中学习并自动进行预测或决策。机器学习通过分析大量数据样本，识别其中的模式和规律，从而对新的数据进行判断。其核心在于通过训练过程，让模型不断优化和提升其预测准确性。主要类型1.监督学习（SupervisedLearning）监督学习是指在训练数据集中包含输入
LocalDateTime 转 String igotyback java 开发语言
importjava.time.LocalDateTime;importjava.time.format.DateTimeFormatter;publicclassMain{publicstaticvoidmain(String[]args){//获取当前时间LocalDateTimenow=LocalDateTime.now();//定义日期格式化器DateTimeFormatterformat
我校举行新老教师师徒结对仪式暨名师专业工作室工作交流活动李蕾1229
为促进我校教师专业发展，发挥骨干教师的引领带头作用，11月6日下午，我校举行新老教师师徒结对仪式暨名师专业工作室工作交流活动。图片发自App会议由教师发展处李蕾主任主持，首先，由范校长宣读新老教师结对名单及双方承担职责。随后，两位新调入教师陈玉萍、莫正杰分别和他们的师傅鲍元美、刘召彬老师签订了师徒结对协议书。图片发自App图片发自App师徒拥抱、握手。有了师傅就有了目标有了方向，相信两位新教师在师
高级编程--XML+socket练习题 masa010 java 开发语言
1.北京华北2114.8万人上海华东2,500万人广州华南1292.68万人成都华西1417万人（1）使用dom4j将信息存入xml中（2）读取信息，并打印控制台（3）添加一个city节点与子节点（4）使用socketTCP协议编写服务端与客户端，客户端输入城市ID，服务器响应相应城市信息（5）使用socketTCP协议编写服务端与客户端，客户端要求用户输入city对象，服务端接收并使用dom4j
直抒《紫罗兰永恒花园外传》雷姆的黑色童话
没看过《紫罗兰永恒花园》的我莫名的看完了《紫罗兰永恒花园外传》，又莫名的被故事中的姐妹之情狠狠地感动了的一把。感动何在：困苦中相依为命的姐妹二人被迫分离，用一个人的自由换取另一个人的幸福。之后，虽相隔不知几许依旧心心念念彼此牵挂。这种深深的姐妹情谊就是令我为之动容的所在。贝拉和泰勒分别影片开始，海天之间一个孩童凭栏眺望，手中拿着折旧的信纸。镜头一转，挑灯伏案的薇尔莉特正在打字机前奋笔疾书。这些片段
PHP环境搭建详细教程好看资源平台前端 php
PHP是一个流行的服务器端脚本语言，广泛用于Web开发。为了使PHP能够在本地或服务器上运行，我们需要搭建一个合适的PHP环境。本教程将结合最新资料，介绍在不同操作系统上搭建PHP开发环境的多种方法，包括Windows、macOS和Linux系统的安装步骤，以及本地和Docker环境的配置。1.PHP环境搭建概述PHP环境的搭建主要分为以下几类：集成开发环境：例如XAMPP、WAMP、MAMP，这
pyecharts——绘制柱形图折线图 2224070247 信息可视化 python java 数据可视化
一、pyecharts概述自2013年6月百度EFE(ExcellentFrontEnd）数据可视化团队研发的ECharts1.0发布到GitHub网站以来，ECharts一直备受业界权威的关注并获得广泛好评，成为目前成熟且流行的数据可视化图表工具，被应用到诸多数据可视化的开发领域。Python作为数据分析领域最受欢迎的语言，也加入ECharts的使用行列，并研发出方便Python开发者使用的数据
【华为OD技术面试真题 - 技术面】- python八股文真题题库（4) 算法大师华为od 面试 python
华为OD面试真题精选专栏：华为OD面试真题精选目录:2024华为OD面试手撕代码真题目录以及八股文真题目录文章目录华为OD面试真题精选**1.Python中的`with`**用途和功能自动资源管理示例：文件操作上下文管理协议示例代码工作流程解析优点2.\_\_new\_\_和**\_\_init\_\_**区别__new____init__区别总结3.**切片（Slicing）操作**基本切片语法
SpringBlade dict-biz/list 接口 SQL 注入漏洞文章永久免费只为良心 oracle 数据库
SpringBladedict-biz/list接口SQL注入漏洞POC:构造请求包查看返回包你的网址/api/blade-system/dict-biz/list?updatexml(1,concat(0x7e,md5(1),0x7e),1)=1漏洞概述在SpringBlade框架中，如果dict-biz/list接口的后台处理逻辑没有正确地对用户输入进行过滤或参数化查询（PreparedSta
Python中深拷贝与浅拷贝的区别 yuxiaoyu.
转自：http://blog.csdn.net/u014745194/article/details/70271868定义：在Python中对象的赋值其实就是对象的引用。当创建一个对象，把它赋值给另一个变量的时候，python并没有拷贝这个对象，只是拷贝了这个对象的引用而已。浅拷贝：拷贝了最外围的对象本身，内部的元素都只是拷贝了一个引用而已。也就是，把对象复制一遍，但是该对象中引用的其他对象我不复
【六】阿伟开始搭建Kafka学习环境能源恒观中间件学习 kafka spring
阿伟开始搭建Kafka学习环境概述上一篇文章阿伟学习了Kafka的核心概念，并且把市面上流行的消息中间件特性进行了梳理和对比，方便大家在学习过程中进行对比学习，最后梳理了一些Kafka使用中经常遇到的Kafka难题以及解决思路，经过上一篇的学习我相信大家对Kafka有了初步的认识，本篇将继续学习Kafka。一、安装和配置学习一项技术首先要搭建一套服务，而Kafka的运行主要需要部署jdk、zook
希望和悲伤都是照亮我们人生的一缕光山月映雪
我开始并不想读《云边有个小卖部》，但看到好几个学生就都在读这本书，为了了解学生的阅读实际，我就拿起这本书翻看起来。读了十几页，发现小说的语言中不时有一些粗俗的字眼，感觉自己读不下去了。小说一开始把云边镇风景写的特别的美好，我错判为脱离现实的鸳鸯蝴蝶派小说，对于人为制造的童话世界的人与物，我真的不太感兴趣，所以就没有再读了。有天在教室闲转，顺手又拿起了这本书看了起来，这次我才真的看进去了。这部小说除
基于Python给出的PDF文档转Markdown文档的方法程序媛了了 python pdf 开发语言
注：网上有很多将Markdown文档转为PDF文档的方法，但是却很少有将PDF文档转为Markdown文档的方法。就算有，比如某些网站声称可以将PDF文档转为Markdown文档，尝试过，不太符合自己的要求，而且无法保证文档没有泄露风险。于是本人为了解决这个问题，借助GPT（能使用GPT镜像或者有条件直接使用GPT的，反正能调用GPT接口就行）生成Python代码来完成这个功能。笔记、代码难免存在
Kafka是如何保证数据的安全性、可靠性和分区的喜欢猪猪 kafka 分布式
Kafka作为一个高性能、可扩展的分布式流处理平台，通过多种机制来确保数据的安全性、可靠性和分区的有效管理。以下是关于Kafka如何保证数据安全性、可靠性和分区的详细解析：一、数据安全性SSL/TLS加密：Kafka支持SSL/TLS协议，通过配置SSL证书和密钥来加密数据传输，确保数据在传输过程中不会被窃取或篡改。这一机制有效防止了中间人攻击，保护了数据的安全性。SASL认证：Kafka支持多种
难念的经轩辕一风
今天中午从公司出来办事，站在马路旁边招手打的。不久来了一辆，路边停下，坐上，一转脸准备告诉师傅去哪的地址，惊呼，姚师傅？啊，咋是你？这也太巧了吧。在上海，出租车少说也有上万辆吧，而且地方这么大，况且在我出来的这个时间点上碰上了，有时候解释不了，就是那么巧。我和姚师傅咋认识的呢？因工作的原因，我要经常去外地出差，家住的离火车站比较远，每次都是打车过去。可能家在郊区的原因，平时门口公路上的出租车并不多
4.C_数据结构_队列荣世蓥数据结构数据结构
概述什么是队列：队列是限定在两端进行插入操作和删除操作的线性表。具有先入先出(FIFO)的特点相关名词：队尾：写入数据的一段队头：读取数据的一段空队：队列中没有数据，队头指针=队尾指针满队：队列中存满了数据，队尾指针+1=队头指针循环队列1、基本内容循环队列是以数组形式构成的队列数据结构。循环队列的结构体如下：typedefintdata_t;//队列数据类型#defineN64//队列容量typ
esp32开发快速入门 8 : MQTT 的快速入门，基于esp32实现MQTT通信 z755924843 ESP32开发快速入门服务器网络运维
MQTT介绍简介MQTT（MessageQueuingTelemetryTransport，消息队列遥测传输协议），是一种基于发布/订阅（publish/subscribe）模式的"轻量级"通讯协议，该协议构建于TCP/IP协议上，由IBM在1999年发布。MQTT最大优点在于，可以以极少的代码和有限的带宽，为连接远程设备提供实时可靠的消息服务。作为一种低开销、低带宽占用的即时通讯协议，使其在物联
python tif转png Python与遥感 python 开发语言
importosfromosgeoimportgdalimportnumpyasnpfromPILimportImage#提取432三波段fromspectralimport*#输入文件夹路径defget_img(dataset_img):width=dataset_img.RasterXSize#获取行列数height=dataset_img.RasterYSizebands=dataset_i
python怎么将png转为tif_png转tif weixin_39977276
发国外的文章要求图片是tif，cmyk色彩空间的。大小尺寸还有要求。比如网上大神多，找到了一段代码，感谢！https://www.jianshu.com/p/ec2af4311f56https://github.com/KevinZc007/image2Tifimportjava.awt.image.BufferedImage;importjava.io.File;importjava.io.Fi
tiff批量转png 诺有缸的高飞鸟 opencv 图像处理 python opencv 图像处理
目录写在前面代码完写在前面1、本文内容tiff批量转png2、平台/环境opencv,python3、转载请注明出处：https://blog.csdn.net/qq_41102371/article/details/132975023代码importnumpyasnpimportcv2importosdeffindAllFile(base):file_list=[]forroot,ds,fsin
基于STM32与Qt的自动平衡机器人：从控制到人机交互的的详细设计流程极客小张 stm32 qt 机器人物联网人机交互毕业设计 c语言
一、项目概述目标和用途本项目旨在开发一款基于STM32控制的自动平衡机器人，结合步进电机和陀螺仪传感器，实现对平衡机器人的精确控制。该机器人可以用于教育、科研、娱乐等多个领域，帮助用户了解自动控制、机器人运动学等相关知识。技术栈关键词STM32单片机步进电机陀螺仪传感器AD采集电路Qt人机界面实时数据监控二、系统架构系统架构设计本项目的系统架构设计包括以下主要组件：控制单元:STM32单片机传感器
基于STM32的汽车仪表显示系统：集成CAN、UART与I2C总线设计流程极客小张 stm32 汽车嵌入式硬件物联网单片机 c语言
一、项目概述项目目标与用途本项目旨在设计和实现一个基于STM32微控制器的汽车仪表显示系统。该系统能够实时显示汽车的速度、转速、油量等关键信息，并通过CAN总线与其他汽车控制单元进行通信。这种仪表显示系统不仅提高了驾驶的安全性和便捷性，还能为汽车提供更智能的用户体验。技术栈关键词微控制器：STM32显示技术：TFTLCD/OLED传感器：速度传感器、温度传感器、油量传感器通信协议：CAN总线、UA
ARMV8体系结构简介：概述简单同学 ARMV8体系结构 ARMV8
1.前言本文主要概括的介绍ARMV8体系结构定义了哪些内容，概括的说：ARM体系结构定义了PE的行为，不会定义具体的实现ARM体系结构也定义了debug体系结构和trace体系结构ARM体系结构采用RISC指令集（1）长度一致的寄存器；（2）load/store架构，数据处理操作只能对寄存器内容进行处理，不会直接对内存的内容进行处理；（3）简单寻址方式，load/store地址来源于寄存器或指令域
WebMagic：强大的Java爬虫框架解析与实战 Aaron_945 Java java 爬虫开发语言
文章目录引言官网链接WebMagic原理概述基础使用1.添加依赖2.编写PageProcessor高级使用1.自定义Pipeline2.分布式抓取优点结论引言在大数据时代，网络爬虫作为数据收集的重要工具，扮演着不可或缺的角色。Java作为一门广泛使用的编程语言，在爬虫开发领域也有其独特的优势。WebMagic是一个开源的Java爬虫框架，它提供了简单灵活的API，支持多线程、分布式抓取，以及丰富的
计算机网络八股总结 Petrichorzncu 八股总结计算机网络笔记
这里写目录标题网络模型划分（五层和七层）及每一层的功能五层网络模型七层网络模型（OSI模型）==三次握手和四次挥手具体过程及原因==三次握手四次挥手TCP/IP协议组成==UDP协议与TCP/IP协议的区别==Http协议相关知识网络地址，子网掩码等相关计算网络模型划分（五层和七层）及每一层的功能五层网络模型应用层：负责处理网络应用程序，如电子邮件、文件传输和网页浏览。主要协议包括HTTP、FTP
《转介绍方法论》学习笔记小可乐的妈妈
一、高效转介绍的流程：价值观---执行----方案一）转介绍发生的背景：1、对象：谁向谁转介绍？全员营销，人人参与。①员工的激励政策、客户的转介绍诱因制作客户画像：a信任；支付能力；意愿度；便利度（根据家长具备四个特征的个数分为四类）B性格分类C职业分类D年龄性别②执行：套路，策略，方法，流程2、诱因：为什么要转介绍？认同信任；多方共赢；传递美好；零风险承诺打动人心，超越期待。选择做教育，就是选择
非对称加密算法原理与应用2——RSA私钥加密文件私语茶馆云部署与开发架构及产品灵感记录 RSA2048 私钥加密
作者：私语茶馆1.相关章节（1）非对称加密算法原理与应用1——秘钥的生成-CSDN博客第一章节讲述的是创建秘钥对，并将公钥和私钥导出为文件格式存储。本章节继续讲如何利用私钥加密内容，包括从密钥库或文件中读取私钥，并用RSA算法加密文件和String。2.私钥加密的概述本文主要基于第一章节的RSA2048bit的非对称加密算法讲述如何利用私钥加密文件。这种加密后的文件，只能由该私钥对应的公钥来解密。
2022-06-29 感恩学习相信小陶
感恩！六点签到相信很多人都有过这样的经验，拼命想的时候答案怎么都想不出来，不去想的时候，答案却自动冒出来了。为什么？这是因为潜意识也会工作，它非常神奇。你要相信，那些百思不得其解的问题早已扎根在你的头脑中，即使你不再刻意去想，潜意识也会自动围着它转。或许有一天，你会突然得到答案。这也是为什么有时我们会有顿悟的感觉。学会等待，也是进行持续思考的一个重要方法。
yolov5＞onnx＞ncnn＞apk 图像处理大大大大大牛啊 opencv实战代码讲解 yolo onnx ncnn 安卓
一.yolov5pt模型转onnx条件：colabnotebookyolov51.安装环境!pipinstallonnx>=1.7.0#forONNXexport!pipinstallcoremltools==4.0#forCoreMLexport!pipinstallonnx-simplifier2.修改common.py在classFocus下面
解读Servlet原理篇二---GenericServlet与HttpServlet 周凡杨 java HttpServlet 源理 GenericService 源码
在上一篇《解读Servlet原理篇一》中提到，要实现javax.servlet.Servlet接口（即写自己的Servlet应用），你可以写一个继承自javax.servlet.GenericServletr的generic Servlet ，也可以写一个继承自java.servlet.http.HttpServlet的HTTP Servlet（这就是为什么我们自定义的Servlet通常是exte
MySQL性能优化 bijian1013 数据库 mysql
性能优化是通过某些有效的方法来提高MySQL的运行速度，减少占用的磁盘空间。性能优化包含很多方面，例如优化查询速度，优化更新速度和优化MySQL服务器等。本文介绍方法的主要有： a.优化查询 b.优化数据库结构
ThreadPool定时重试 dai_lm java ThreadPool thread timer timertask
项目需要当某事件触发时，执行http请求任务，失败时需要有重试机制，并根据失败次数的增加，重试间隔也相应增加，任务可能并发。由于是耗时任务，首先考虑的就是用线程来实现，并且为了节约资源，因而选择线程池。为了解决不定间隔的重试，选择Timer和TimerTask来完成 package threadpool; public class ThreadPoolTest {
Oracle 查看数据库的连接情况周凡杨 sql oracle 连接
首先要说的是，不同版本数据库提供的系统表会有不同，你可以根据数据字典查看该版本数据库所提供的表。 select * from dict where table_name like '%SESSION%'; 就可以查出一些表，然后根据这些表就可以获得会话信息 select sid,serial#,status,username,schemaname,osuser,terminal,ma
类的继承朱辉辉33 java
类的继承可以提高代码的重用行，减少冗余代码；还能提高代码的扩展性。Java继承的关键字是extends 格式:public class 类名（子类）extends 类名（父类）{ } 子类可以继承到父类所有的属性和普通方法，但不能继承构造方法。且子类可以直接使用父类的public和 protected属性，但要使用private属性仍需通过调用。子类的方法可以重写，但必须和父类的返回值类
android 悬浮窗特效肆无忌惮_ android
最近在开发项目的时候需要做一个悬浮层的动画，类似于支付宝掉钱动画。但是区别在于，需求是浮出一个窗口，之后边缩放边位移至屏幕右下角标签处。效果图如下：一开始考虑用自定义View来做。后来发现开线程让其移动很卡，ListView+动画也没法精确定位到目标点。后来想利用Dialog的dismiss动画来完成。自定义一个Dialog后，在styl
hadoop伪分布式搭建林鹤霄 hadoop
要修改4个文件 1: vim hadoop-env.sh 第九行 2: vim core-site.xml <configuration> &n
gdb调试命令 aigo gdb
原文：http://blog.csdn.net/hanchaoman/article/details/5517362 一、GDB常用命令简介 r run 运行.程序还没有运行前使用 c cuntinue
Socket编程的HelloWorld实例 alleni123 socket
public class Client { public static void main(String[] args) { Client c=new Client(); c.receiveMessage(); } public void receiveMessage(){ Socket s=null; BufferedRea
线程同步和异步百合不是茶线程同步异步
多线程和同步 : 如进程、线程同步，可理解为进程或线程A和B一块配合，A执行到一定程度时要依靠B的某个结果，于是停下来，示意B运行；B依言执行，再将结果给A；A再继续操作。所谓同步，就是在发出一个功能调用时，在没有得到结果之前，该调用就不返回，同时其它线程也不能调用这个方法多线程和异步:多线程可以做不同的事情,涉及到线程通知 &
JSP中文乱码分析 bijian1013 java jsp 中文乱码
在JSP的开发过程中，经常出现中文乱码的问题。首先了解一下Java中文问题的由来： Java的内核和class文件是基于unicode的，这使Java程序具有良好的跨平台性，但也带来了一些中文乱码问题的麻烦。原因主要有两方面，
js实现页面跳转重定向的几种方式 bijian1013 JavaScript 重定向
js实现页面跳转重定向有如下几种方式：一.window.location.href <script language="javascript"type="text/javascript"> window.location.href="http://www.baidu.c
【Struts2三】Struts2 Action转发类型 bit1129 struts2
在【Struts2一】 Struts Hello World http://bit1129.iteye.com/blog/2109365中配置了一个简单的Action，配置如下 <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configurat
【HBase十一】Java API操作HBase bit1129 hbase
Admin类的主要方法注释： 1. 创建表 /** * Creates a new table. Synchronous operation. * * @param desc table descriptor for table * @throws IllegalArgumentException if the table name is res
nginx gzip ronin47 nginx gzip
Nginx GZip 压缩 Nginx GZip 模块文档详见：http://wiki.nginx.org/HttpGzipModule 常用配置片段如下： gzip on; gzip_comp_level 2; # 压缩比例，比例越大，压缩时间越长。默认是1 gzip_types text/css text/javascript; # 哪些文件可以被压缩 gzip_disable &q
java-7.微软亚院之编程判断俩个链表是否相交给出俩个单向链表的头指针，比如 h1 ， h2 ，判断这俩个链表是否相交 bylijinnan java
public class LinkListTest { /** * we deal with two main missions: * * A. * 1.we create two joined-List(both have no loop) * 2.whether list1 and list2 join * 3.print the join
Spring源码学习-JdbcTemplate batchUpdate批量操作 bylijinnan java spring
Spring JdbcTemplate的batch操作最后还是利用了JDBC提供的方法，Spring只是做了一下改造和封装 JDBC的batch操作： String sql = "INSERT INTO CUSTOMER " + "(CUST_ID, NAME, AGE) VALUES (?, ?, ?)";
[JWFD开源工作流]大规模拓扑矩阵存储结构最新进展 comsci 工作流
生成和创建类已经完成,构造一个100万个元素的矩阵模型,存储空间只有11M大,请大家参考我在博客园上面的文档"构造下一代工作流存储结构的尝试",更加相信的设计和代码将陆续推出......... 竞争对手的能力也很强.......,我相信..你们一定能够先于我们推出大规模拓扑扫描和分析系统的....
base64编码和url编码 cuityang base64 url
import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import java.io.PrintWriter; import java.io.StringWriter; import java.io.UnsupportedEncodingException;
web应用集群Session保持 dalan_123 session
关于使用 memcached 或redis 存储 session ，以及使用 terracotta 服务器共享。建议使用 redis，不仅仅因为它可以将缓存的内容持久化，还因为它支持的单个对象比较大，而且数据类型丰富，不只是缓存 session，还可以做其他用途，一举几得啊。1、使用 filter 方法存储这种方法比较推荐，因为它的服务器使用范围比较多，不仅限于tomcat ，而且实现的原理比较简
Yii 框架里数据库操作详解-[增加、查询、更新、删除的方法 'AR模式'] dcj3sjt126com 数据库
public function getMinLimit () { $sql = "..."; $result = yii::app()->db->createCo
solr StatsComponent（聚合统计） eksliang solr聚合查询 solr stats
StatsComponent 转载请出自出处：http://eksliang.iteye.com/blog/2169134 http://eksliang.iteye.com/ 一、概述 Solr可以利用StatsComponent 实现数据库的聚合统计查询，也就是min、max、avg、count、sum的功能二、参数
百度一道面试题 greemranqq 位运算百度面试寻找奇数算法 bitmap 算法
那天看朋友提了一个百度面试的题目：怎么找出{1,1,2,3,3,4,4,4,5,5,5,5} 找出出现次数为奇数的数字. 我这里复制的是原话，当然顺序是不一定的，很多拿到题目第一反应就是用map,当然可以解决，但是效率不高。还有人觉得应该用算法xxx,我是没想到用啥算法好...！还有觉得应该先排序... 还有觉
Spring之在开发中使用SpringJDBC ihuning spring
在实际开发中使用SpringJDBC有两种方式： 1. 在Dao中添加属性JdbcTemplate并用Spring注入； JdbcTemplate类被设计成为线程安全的，所以可以在IOC 容器中声明它的单个实例，并将这个实例注入到所有的 DAO 实例中。JdbcTemplate也利用了Java 1.5 的特定(自动装箱，泛型，可变长度
JSON API 1.0 核心开发者自述 | 你所不知道的那些技术细节 justjavac json
2013年5月，Yehuda Katz 完成了JSON API(英文，中文) 技术规范的初稿。事情就发生在 RailsConf 之后，在那次会议上他和 Steve Klabnik 就 JSON 雏形的技术细节相聊甚欢。在沟通单一 Rails 服务器库—— ActiveModel::Serializers 和单一 JavaScript 客户端库——&
网站项目建设流程概述 macroli 工作
一.概念网站项目管理就是根据特定的规范、在预算范围内、按时完成的网站开发任务。二.需求分析项目立项　　我们接到客户的业务咨询，经过双方不断的接洽和了解，并通过基本的可行性讨论够，初步达成制作协议，这时就需要将项目立项。较好的做法是成立一个专门的项目小组，小组成员包括：项目经理，网页设计，程序员，测试员，编辑/文档等必须人员。项目实行项目经理制。客户的需求说明书　　第一步是需
AngularJs 三目运算表达式判断 qiaolevip 每天进步一点点学习永无止境众观千象 AngularJS
事件回顾：由于需要修改同一个模板，里面包含2个不同的内容，第一个里面使用的时间差和第二个里面名称不一样，其他过滤器，内容都大同小异。希望杜绝If这样比较傻的来判断if-show or not，继续追究其源码。 var b = "{{", a = "}}"; this.startSymbol = function(a) {
Spark算子：统计RDD分区中的元素及数量 superlxw1234 spark spark算子 Spark RDD分区元素
关键字：Spark算子、Spark RDD分区、Spark RDD分区元素数量 Spark RDD是被分区的，在生成RDD时候，一般可以指定分区的数量，如果不指定分区数量，当RDD从集合创建时候，则默认为该程序所分配到的资源的CPU核数，如果是从HDFS文件创建，默认为文件的Block数。可以利用RDD的mapPartitionsWithInd
Spring 3.2.x将于2016年12月31日停止支持 wiselyman Spring 3
Spring 团队公布在2016年12月31日停止对Spring Framework 3.2.x（包含tomcat 6.x）的支持。在此之前spring团队将持续发布3.2.x的维护版本。请大家及时准备及时升级到Spring
fis纯前端解决方案fis-pure zccst JavaScript
作者：zccst FIS通过插件扩展可以完美的支持模块化的前端开发方案，我们通过FIS的二次封装能力，封装了一个功能完备的纯前端模块化方案pure。 1，fis-pure的安装 $ fis install -g fis-pure $ pure -v 0.1.4 2，下载demo到本地 git clone https://github.com/hefangshi/f