CN102469136A - 一种聊天会话增加参与者和获取参与者列表的方法及系统 - Google Patents

Abstract

一种聊天会话增加参与者和获取参与者列表的方法及系统，基于电信网络域提供的REST API实现，要在聊天会话增加参与者时，客户端向服务器发送聊天会话增加参与者请求消息，携带使用的动作和资源的信息，以及请求增加到聊天会话中的参与者的信息；服务器收到后，在聊天会话中增加参与者，向客户端返回聊天会话增加参与者响应消息。要获取聊天会话参与者列表时，客户端向服务器发送获取聊天会话参与者列表请求消息，消息中携带使用的动作和资源的信息；服务器收到后，获取相应聊天会话的参与者列表，向客户端返回获取聊天会话参与者列表响应消息。本发明可以解决用户不能调用电信能力来实现聊天会话增加参与者和获取聊天会话参与者列表的问题。

Description

一种聊天会话增加参与者和获取参与者列表的方法及系统

技术领域

本发明涉及聊天会话，尤其涉及一种聊天会话增加参与者和获取参与者列表的方法及系统。

背景技术

面对信息通信产业周期的演进以及消费者模式的变迁大潮，面对互联网的骨灰级创新模式以及新媒体的广泛传播、甚至是IT厂商、内容整合者与消费电子厂商向运营领域的渗透，电信运营商正在采取一种积极的融合、开放的态度，努力尝试开放其电信能力，集思广益，发挥第三方企业与个人的创新能力，打造丰富的增值应用；另一方面，借用这种电信服务的二次分发渠道，促进基本电信服务的销售。尤其是终端与软件厂商在在线应用商店市场烽烟四起之时，运营商必须要利用电信能力(可靠的通信服务；用户数据；情境；认证；计费等)打造一条新的差异化的道路。

1998年Parlay组织成立致力于为电话网络开发API(应用编程接口)。借助这些API，第三方机构可以创建自己的应用。Parlay组织在这方面做了统一的标准化工作，制定了基于CORBA(公共对象资源代理架构)的Parlay/OSA(开放服务架构)API，对各种电信能力的使用进行编程方面的统一工作。另外Parlay/OSA API也获得了ETSI(欧洲电信标准协会)与3GPP(第三代移动通信合作伙伴计划标准组织)共同协助。在3GPP中，Parlay被当成开放服务架构(OSA)的一部分。Parlay X是Parlay、3GPP和OMA(开放移动联盟)颁发的基于SOAP(简单对象访问协议)Web服务的API标准规范。Parlay REST(面向Parlay X的RESTful约束)，是OMA最新颁发的一套API标准规范，旨在为OMA中的Parlay X Web服务规范(子)集指定REST Web服务约束。

在Web 2.0领域，支持AjaX(异步JavaScript脚本和XML可扩展标签语言)技术的API相对应用比较广泛，风格为REST(REpresentational StateTransfer，表象化状态转变)。REST不是一种新技术，也不是一种标准，而是一组设计原则；与基于SOAP的Web服务(如Parlay X)相比，REST API更加轻量级，具有更优良的开发者友好性，便于Web应用的开发和Mashup。因此越来越多的Web服务开始采用REST风格设计和实现。例如，Amazon.com提供接近REST风格的Web服务进行图书查找；雅虎提供的Web服务也是REST风格的(维基百科)。

GSMA(全球移动系统协会)RCS(富通信套件)是基于现有IMS(IP多媒体子系统)网络设施和开发协议搭建出来的提供可互操作的丰富通信功能的业务包，主要包括增强型地址簿、增强型呼叫、增强型融合消息等业务，使用户可以对自己的呈现(如个人图片、留言、推荐链接以及状态)进行更新，也可以在手机的通讯录中实时看到好友的呈现情况，并实现短信、彩信、聊天(即时消息)、文件传输等多种通信需求。RCS是包括运营商、设备商和手机终端厂商共同支持的统一的技术及实现标准，因此它不但容易培养消费者较为一致的使用习惯，而且可以实现不同国家、不同运营商的互联互通。后续阶段，RCS将进一步引入社交网络、开放式REST API应用编程接口、与互联网集成应用商店等内容。RCS REST风格API的目标用户是典型的Web开发商、第三方开发者、业务提供商，通过API可以将电信运营商的RCS业务能力和IMS网络能力开放，更适合Web 2.0Widget轻量级应用与Mashup的开发，迎合Web应用的发展趋势。

目前，电信运营商短信、彩信的业务能力已经可以通过OMA(开放移动联盟)制定的ParlayREST2.0协议标准开放，而即时消息业务能力还没有制定相应的协议标准开放，用户还不能够调用电信能力实现聊天会话增加参与者和获取参与者列表的相关控制。

发明内容

有鉴于此，本发明的一个目的在于提供一种聊天会话增加参与者的方法及系统，以解决用户不能调用电信能力来实现聊天会话增加参与者的问题。

为了解决上述问题，本发明提供了一种聊天会话增加参与者的方法，该方法基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)实现，包括：

客户端向服务器发送聊天会话增加参与者请求消息，携带使用的动作和资源的信息，以及请求增加到聊天会话中的参与者的信息，所述资源用资源统一资源位置符(URL)标示；

所述服务器收到所述聊天会话增加参与者请求消息后，在所述聊天会话中增加所述参与者，向所述客户端返回聊天会话增加参与者响应消息。

较佳地

所述动作为超文本转换协议(HTTP)的布置(POST)动作或设定(PUT)动作，标示所述资源的资源URL包含源端参与者用户标示符和聊天会话标示符中的至少一个。

较佳地

所述聊天会话增加参与者请求消息中包含请求增加到所述聊天会话中的所述参与者的以下信息中的至少一种：参与者地址、参与者姓名、参与者状态和参与者的资源URL。

较佳地

所述聊天会话增加参与者响应消息中包含增加到所述聊天会话中的所述参与者的以下信息中的至少一种：参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者标示符、参与者的资源URL、重新加入聊天会话的参与者的MSRP客户端路径信息、重新加入聊天会话的参与者的MSRP服务器路径信息。

较佳地

所述客户端发送聊天会话增加参与者请求消息之前，源端参与者请求将新的参与者加入聊天会话，所述客户端按以下方式生成所述聊天会话增加参与者请求消息：

以HTTP的布置(POST)动作或设定(PUT)动作为使用的动作，以聊天会话所有参与者为使用的资源，生成消息头，其中，标示所述资源的资源URL中包含所述源端参与者的用户标示符和/或所述聊天会话的聊天会话标示符；

根据所述新的参与者的参与者地址和/或参与者姓名，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者请求消息。

较佳地

所述聊天会话中增加所述参与者成功时，所述服务器返回聊天会话增加参与者响应消息之前，按以下方式生成所述聊天会话增加参与者响应消息：

根据源端参与者用户标示符、聊天会话标示符和所述新的参与者的参与者标示符，生成所述新的参与者的资源URL，在HTTP表示“已建立(Created)”的响应符后添加该资源URL表示的位置(Location)信息，生成消息头；

根据所述新的参与者的参与者地址、参与者姓名、参与者状态、参与者标示符和参与者的资源URL中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者响应消息。

较佳地

所述客户端发送聊天会话增加参与者请求消息之前，源端参与者请求重新加入此前退出的聊天会话，所述客户端按以下方式生成所述聊天会话增加参与者请求消息：

使用HTTP的布置(POST)动作或设定(PUT)动作和创建的聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的HTTP URL中包含所述源端参与者的用户标示符和/或所述聊天会话的聊天会话标示符；

根据所述源端参与者的参与者地址、参与者姓名和MSRP客户端路径信息中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者请求消息。

较佳地

所述聊天会话中增加所述参与者成功时，所述服务器返回聊天会话增加参与者响应消息之前，按以下方式生成所述聊天会话增加参与者响应消息：

根据所述源端参与者的用户标示符和参与者标示符，及所述聊天会话的聊天会话标示符，生成所述源端参与者的资源URL，在HTTP表示“已建立”的响应符后添加该资源URL表示的位置(Location)信息，生成消息头；

根据所述源端参与者的参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者标示符、参与者的资源URL、参与者的MSRP客户端路径信息和参与者的MSRP服务器路径信息中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者响应消息。

相应地，本发明还提供了一种聊天会话增加参与者的系统，服务器和客户端基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)交互，该系统包括：

客户端中的消息生成装置，用于生成聊天会话增加参与者请求消息；

客户端中的消息发送装置，用于向服务器发送所述聊天会话增加参与者请求消息；

服务器中的消息接收和处理装置，用于在收到聊天会话增加参与者请求消息后进行解析和处理，在所述聊天会话中增加所述参与者；

服务器中的消息生成装置，用于生成聊天会话增加参与者响应消息；

服务器中的消息发送装置，用于向所述客户端返回所述聊天会话增加参与者响应消息。

较佳地

所述客户端中的消息生成装置又包括：

消息头生成子装置，用于使用HTTP的布置(POST)动作或PUT动作和创建的聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的HTTPURL中包含请求将新的参与者加入聊天会话的源端参与者的用户标示符和/或所述聊天会话的聊天会话标示符；

消息体生成子装置，用于根据所述新的参与者的参与者地址和/或参与者姓名，生成聊天会话参与者信息的数据结构，作为消息体；

消息生成子装置，用于根据所述消息头和消息体生成聊天会话增加参与者请求消息；

所述服务器中的消息生成装置又包括：

消息头生成子装置，用于根据源端参与者用户标示符、聊天会话标示符和所述新的参与者的参与者标示符，生成所述新的参与者的资源URL，在HTTP表示“已建立(Created)”的响应符后添加该资源URL表示的位置(Location)信息，生成消息头；

消息体生成子装置，用于根据所述新的参与者的参与者地址、参与者姓名、参与者状态、参与者标示符和参与者的资源URL中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

消息生成子装置，用于根据所述消息头和消息体生成聊天会话增加参与者响应消息。

基于上述方案，Web开发商、第三方开发者或业务提供商等用户可以通过客户端，使用REST API访问调用电信运营商网络域中的电信能力，对服务器进行聊天会话增加参与者的相关控制。

本发明的另一个目的在于提供一种获取聊天会话参与者列表的方法及系统，以解决用户不能调用电信能力获取聊天会话参与者列表的问题。

为了解决上述问题，本发明提供了一种获取聊天会话参与者列表的方法，该方法基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)实现，包括：

客户端向服务器发送获取聊天会话参与者列表请求消息，消息中携带使用的动作和资源的信息，所述资源用资源统一资源位置符(URL)标示；

所述服务器收到所述获取聊天会话参与者列表请求消息后，获取相应聊天会话的参与者列表，向客户端返回获取聊天会话参与者列表响应消息。

较佳地

使用的所述动作为超文本转换协议(HTTP)的获取(GET)动作，标示所述资源的HTTP URL中包含源端参与者用户标示符和聊天会话标示符中的至少一个。

较佳地

所述获取聊天会话参与者列表响应消息中携带以下信息中的至少一种：一个或多个聊天会话参与者的信息，以及聊天会话所有参与者的资源URL。

较佳地

所述聊天会话参与者的信息包含以下信息中的至少一种：参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者的资源URL、参与者标示符、参与者的消息会话转播协议(MSRP)客户端路径信息和参与者的MSRP服务器路径信息，其中，参与者的MSRP客户端路径信息和MSRP服务器路径信息只有源端参与者才具有。

较佳地

客户端发送获取聊天会话参与者列表请求消息之前，按以下方式生成所述获取聊天会话参与者列表请求消息：

使用HTTP的获取(GET)动作和聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的HTTP URL中包含发起请求的源端参与者的用户标示符和/或源端参与者参与的聊天会话的标示符；

根据所述消息头生成获取聊天会话参与者列表请求消息。

较佳地

所述服务器获取所述聊天会话的参与者列表成功时，按以下方式生成返回的所述获取聊天会话参与者列表响应消息：

根据HTTP表示“成功”的响应符生成消息头；

对聊天会话的每一个参与者，根据该聊天会话参与者的信息生成一个聊天会话参与者信息的数据结构；并根据生成的所有聊天会话参与者信息的数据结构，以及标示所述资源的HTTP URL，生成一个聊天会话参与者列表信息的数据结构，作为消息体；

根据所述消息头和消息体生成获取聊天会话参与者列表响应消息。

相应地，本发明还提供了一种获取聊天会话参与者列表的系统，客户端和服务器基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)交互，该系统包括：

客户端中的消息生成装置，用于生成获取聊天会话参与者列表请求消息；

客户端中的消息发送装置，用于向服务器发送所述获取聊天会话参与者列表请求消息；

服务器中的消息接收和处理装置，用于在收到所述获取聊天会话参与者列表请求消息后进行解析和处理，获取相应聊天会话的信息；

服务器中的消息生成装置，用于生成获取聊天会话参与者列表响应消息；

服务器中的消息发送装置，用于向所述客户端返回所述获取聊天会话参与者列表响应消息。

较佳地

所述客户端中的消息生成装置又包括：

消息头生成子装置，用于使用HTTP的获取(GET)动作和聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的资源URL中包含发起请求的源端参与者的用户标示符及源端参与者参与的聊天会话的标示符；

消息生成子装置，用于根据所述消息头生成获取聊天会话参与者列表请求消息；

所述服务器中的消息生成装置又包括：

消息头生成子装置，用于根据HTTP表示“成功”的响应符生成消息头；

消息体生成子装置，用于对聊天会话的每一个参与者，根据该聊天会话参与者的信息生成一个聊天会话参与者信息的数据结构；并根据生成的所有聊天会话参与者信息的数据结构，以及标示所述资源的资源URL，生成一个聊天会话参与者列表信息的数据结构，作为消息体；

根据所述消息头和消息体生成获取聊天会话参与者列表响应消息。

基于上述方案，Web开发商、第三方开发者或业务提供商等用户可以通过客户端，使用REST API访问调用电信网络域中的电信能力，对服务器进行获取聊天会话参与者列表的相关控制。

附图说明

图1为本发明实施例开放电信能力接口的系统结构的示意图；

图2为本发明实施例一聊天会话增加参与者的方法的流程图；

图3为本发明实施例二聊天会话增加参与者的方法的流程图；

图4为本发明实施例三获取聊天会话参与者列表的方法的流程图；

图5为本发明实施例客户端和服务器之间实现聊天会话增加参与者、获取参与者列表的操作示意图。

具体实施方式

为使本发明的目的、技术方案和优点更加清楚明白，下文中将结合附图对本发明的实施例进行详细说明。需要说明的是，在不冲突的情况下，本申请中的实施例及实施例中的特征可以相互任意组合。

实施例一

图1示出了本实施例开放即时消息业务电信能力接口的系统结构。如图所示，电信网络域包含IMS核心网和业务层，业务层包含短信业务服务器、彩信业务服务器、即时消息业务服务器(如RCS即时消息业务引擎)以及其他业务服务器等各种业务网络设备，但是，本发明用于即时消息业务的服务器也可以同时用于其他多种业务，并不局限于专用的服务器。这些服务器向Web开发商、第三方开发者、业务提供商等提供开放的REST API，Web开发商、第三方开发者、业务提供商等用户的客户端可以使用REST API访问电信网络域，调用电信网络域的RCS业务能力和IMS网络能力，实现电信业务的Web 2.0Widget轻量级应用与Mashup的开发。

本实施例中，Web开发商、第三方开发者、业务提供商等用户开发的应用程序可以通过客户端，使用本实施例提供的REST API对服务器进行聊天会话增加参与者的相关控制。客户端可以位于业务提供商的网络设备中，也可以位于终端用户设备如移动终端、固定终端等中。本发明适用的用户也不限于上述类型，可以是基于互联网服务、WEB服务的任何有控制权限的即时消息参与者。

本实施例中REST API使用的资源、动作和数据结构的相关定义如下：

资源统一资源位置符链接中，serverRoot表示服务器路径信息，apiVersion表示API版本，Chat表示聊天，Originating表示源端，OriginatingID表示源端参与者(请求发起方)用户标示符(如可以是源端参与者地址)。

上述REST API使用的数据结构类型定义如下：

数据结构类型Type：ChatParticipantList聊天会话参与者列表信息

其中，聊天会话所有参与者的资源URL可以包含源端参与者的用户标示符和聊天会话标示符的至少一种。

数据结构类型Type：ChatParticipantInformation聊天会话参与者信息

其中，聊天会话参与者的资源URL可以包含源端参与者的用户标示符、聊天会话标示符和参与者标示符中的至少一种。

枚举Enumeration：ChatParticipantStatus聊天会话参与者状态

枚举Enumeration：ChatParticipantTerminationCause聊天会话参与者结束原因

图2为本实施例基于REST API实现聊天会话增加参与者的流程图，本实施例中，源端参与者请求将新的参与者加入聊天会话。包括以下步骤：

步骤S201：客户端向服务器发送聊天会话增加参与者请求消息，携带使用的动作和资源的信息，及新的参与者的信息，所述资源用资源URL标示；

本实施例的聊天会话增加参与者请求消息中，消息头中包括使用的动作和资源，消息体中包括聊天会话参与者信息的数据结构。

客户端可以通过以下方式生成该消息：

以HTTP的布置(POST)动作或设定(PUT)为使用的动作，以聊天会话所有参与者为使用的资源，生成消息头，其中，标示所述资源的资源URL中包含所述源端参与者的用户标示符和所述聊天会话的聊天会话标示符中的至少一个；

按照XML格式，根据所述新的参与者的信息，如参与者地址和/或参与者姓名，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者请求消息。

各实施例涉及的几个消息中的消息体，也可以采用XML外的其他专用格式如Java脚本对象符号(JSON)。

下面用一个示例来说明一下生成的聊天会话增加参与者请求消息。

假定源端参与者为用户Max Muster(SIP:user1example.com)，群组聊天会话为{chatSessionId6}，该用户请求增加新的参与者，新的参与者为John E.Xample(SIP:user4example.com)。

以下为聊天会话增加参与者请求消息内容的示例及说明：

POST

http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user1example.com/chatSessions/{chatSessionId6}/p

articipants HTTP/1.1\\动作+资源URL

Content-Type：application/xml

Accept：application/xml

Content-Length：1234

Host：example.com:80

<？xml version＝″1.0″encoding＝″UTF-8″？>

<chat:ChatParticipantInformation xmlns:chat＝″urn:oma:xml:rest:chat:1″>\\聊天会话参与者信息数据结构

的开始

<participantAddress>SIP:user4example.com</participantAddress>

<participantName>John E.Xample</participantName>

<clientCorrelator>224567</clientCorrelator>

</chat:ChatParticipantInformation>\\聊天会话参与者信息数据结构的结束

在本申请给出的若干消息内容的示例中，对REST API中定义的动作、资源、数据结构和部分信息作了说明，其他内容如数据结构中定义的信息，消息头中的其他内容等，请参照上文和Web中的规定。

步骤S202：服务器收到聊天会话增加参与者请求消息后，在所述聊天会话中加入新的参与者，向客户端返回聊天会话增加参与者响应消息。

聊天会话增加参与者响应消息中，消息头包括HTTP的响应符，消息体中携带聊天会话参与者信息的数据结构。

聊天会话增加新的参与者成功时，服务器可以通过以下方式来生成该消息：

根据源端参与者用户标示符、聊天会话标示符和所述新的参与者的参与者标示符，生成所述新的参与者的资源URL，在HTTP表示“已建立(Created)”的响应符后添加该资源URL表示的位置(Location)信息，生成消息头；

按照XML格式，根据所述新的参与者的信息，如参与者地址、参与者姓名、参与者状态和参与者的资源URL(包含参与者标示符)中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者响应消息。

以下为聊天会话增加参与者成功时，聊天会话增加参与者响应消息内容的示例和说明：

假定，聊天会话增加参与者成功，增加的聊天会话参与者为用户John E.Xample(SIP:user4example.com)，状态为聊天会话参与者初始化，参与者标示符为{participantId4}

HTTP/1.1201Created

Content-Type：application/xml

Location：http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user1example.com/

chatSessions/{chatSessionId6}/participants/{participantId4}\\动作+增加的资源URL

Content-Length：1234

Date：Mon，28Jun 201017:51:59GMT

<？xml version＝″1.0″encoding＝″UTF-8″？>

<chat:ChatParticipantInformation xmlns:chat＝″urn:oma:xml:rest:chat:1″>\\聊天会话参与者信息数据结构

的开始

<participantAddress>SIP:user4example.com</participantAddress>

<participantName>John E.Xample</participantName>

<participantStatus>ChatParticipantInitial</participantStatus>

<clientCorrelator>224567</clientCorrelator>

<resourceURL>

http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user1example.com/chatSessions/{chatSessionId6}/p

articipants/{participantId4}\\增加的参与者的资源URL

</resourceURL>

</chat:ChatParticipantInformation>\\聊天会话参与者信息数据结构的结束

实施例二

本实施例是基于电信网络域提供的REST API实现聊天会话增加参与者的另一实施例，所基于的系统与实施例一相同，资源、动作和数据结构的相关定义请参照实施例一中的说明。

与实施例一不同的是，本实施例的增加参与者请求，是退出群组聊天会话的用户请求重新加入群组聊天会话，相应流程包括以下步骤：

步骤S301：客户端向服务器发送聊天会话增加参与者请求消息，携带使用的动作和资源的信息，及请求重新加入群组聊天会话的源端参与者的信息，所述资源用资源URL标示；

本实施例的聊天会话增加参与者请求消息中，消息头中包括使用的动作和资源，消息体中包括聊天会话参与者信息的数据结构。

客户端可以通过以下方式生成该消息：

使用HTTP的布置(POST)动作和创建的聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的资源URL中包含所述源端参与者的用户标示符和所述聊天会话的聊天会话标示符中的至少一个；

按照XML格式，根据所述源端参与者的信息，如参与者地址、参与者姓名和MSRP客户端路径信息中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者请求消息。

下面用一个示例来说明一下本实施例生成的聊天会话增加参与者请求消息。

假定源端参与者为John E.Xample(SIP:user4example.com)，群组聊天会话标示符为{chatSessionId6}，该用户请求重新加入群组聊天会话。

以下为聊天会话增加参与者请求消息内容的示例及说明：

POST

http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user4example.com/chatSessions/{chatSessionId6}/p

articipants HTTP/1.1\\动作+资源URL

Content-Type：application/xml

Accept：application/xml

Content-Length：1234

Host：example.com:80

<？xml version＝″1.0″encodina＝″UTF-8″？>

<chat:ChatParticipantInformation xmlns:chat＝″urnoma:xml:rest:chat:1″>\\聊天会话参与者信息数据结构

的开始

    <participantAddress>SIP:user4example.com</participantAddress>

    <participantName>John E.Xample</participantName>

    <MSRPClientPath>msrp://John E.Xample.example.com:

8999/45678ae923wzd；tcp</MSRPClientPath>

<clientCorrelator>224567</clientCorrelator>

</chat:ChatParticipantInformation>\\聊天会话参与者信息数据结构的结束

步骤302：服务器收到聊天会话增加参与者请求消息后，将源端参与者重新加入群组聊天会话，向客户端返回聊天会话增加参与者响应消息。

聊天会话增加参与者响应消息中，消息头包括HTTP的响应符，消息体中携带聊天会话参与者信息的数据结构。

重新加入群组聊天会话时，服务器可以通过以下方式来生成该消息：

根据所述源端参与者的用户标示符和参与者标示符，及所述聊天会话的聊天会话标示符，生成所述源端参与者的资源URL，在HTTP表示“已建立”的响应符后添加该资源URL表示的位置(Location)信息，生成消息头；

按照XML格式，根据所述源端参与者的信息，如参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者的资源URL(包含参与者标示符)、参与者的MSRP客户端路径信息和参与者的MSRP服务器路径信息中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者响应消息。

以下为重新加入群组聊天会话时，聊天会话增加参与者响应消息内容的示例和说明：

假定，重新加入群组聊天会话成功，重新加入的用户John E.Xample(SIP:user4example.com)的状态为聊天会话参与者初始化，参与者标示符为{participantId4}。

    HTTP/1.1201Created

    Content-Type：application/xml

    Location：

http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user4example.com/chatSessions/{chatSessionId6}/p

articipants/{participantId4}\\重新加入的源端参与者的资源URL

    Content-Length：1234

    Date：Mon，28Jun 201017:51:59GMT

    <？xml version＝″1.0″encoding＝″UTF-8″？>

    <chat:ChatParticipantInformation xmlns:chat＝″urn:oma:xml:rest:chat:1″>\\聊天会话参与者信息数据结构

    的开始

    <participantAddress>SIP:user4example.com</participantAddress>

    <participantName>John E.Xample</participantName>

    <participantStatus>ChatParticipantConnected</participantStatus>

    <startTime>2010-06-28T17:51:51</startTime>

    <MSRPClientPath>msrp://John E.Xample.example.com:

8999/45678ae923wzd；tcp</MSRPClientPath>

    <MSRPServerPath>msrp://Server.example.com:4000/yVwZuKlFWkt9；tcp></MSRPServerPath>

    <clientCorrelator>224567</clientCorrelator>

    <resourceURL>

http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user4example.com/chatSessions/{chatSessionId6}/p

articipants/{participantId4}\\重新加入的源端参与者的资源URL

</resourceURL>

</chat:ChatParticipantInformation>\\聊天会话参与者信息数据结构的结束

实施例三

本实施例涉及基于电信网络域提供的REST API获取聊天会话参与者列表的相关控制。所基于的系统与实施例一相同，资源、动作和数据结构的相关定义请参照实施例一中的说明。

图4为本实施例基于REST API获取聊天会话参与者列表的流程图，源端参与者发送获取聊天会话参与者列表请求，请求获取自己参与的聊天会话的参与者列表。该流程包括以下步骤：

步骤S401：客户端向服务器发送获取聊天会话参与者列表请求消息，消息中携带使用的动作和资源的信息，所述资源用资源URL标示；

获取聊天会话参与者列表请求消息的消息头包括使用的动作和资源，可以不携带消息体。

客户端可以通过以下方式来生成该消息：

使用HTTP的获取(GET)动作和聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的HTTP URL中包含发起请求的源端参与者的用户标示符及源端参与者参与的聊天会话的标示符；

根据所述消息头生成获取聊天会话参与者列表请求消息。

下面用一个示例来说明一下生成的获取聊天会话参与者列表请求消息。

假定源端参与者为用户Max Muster(SIP:user1example.com)，聊天会话为{chatSessionId1}，该请求为获取聊天会话参与者列表。。

以下为获取聊天会话参与者列表请求消息内容的示例及说明：

GET

http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user1example.com/chatSessions/{chatSessionId1}/p

arhcipants HTTP/1.1

Accept：application/xml

Host：example.com:80

步骤S402：服务器收到获取聊天会话参与者列表请求消息后，获取所述聊天会话的参与者列表，向客户端返回获取聊天会话参与者列表响应消息。

获取聊天会话参与者列表成功时，获取聊天会话参与者列表响应消息的消息头包括HTTP的响应符，消息体中包括聊天会话参与者列表信息的数据结构。可以通过以下方式来生成：

根据HTTP表示“成功”的响应符生成消息头；

按照XML格式，对聊天会话的每一个参与者，根据该聊天会话参与者的信息如参与者地址、参与者名称、参与者状态、参与者启动时间和参与者的资源URL中的至少一种，生成一个聊天会话参与者信息的数据结构；对于源端参与者，上述参与者的信息还可以包括源端参与者的MSRP客户端路径信息和MSRP服务器路径信息；

按照XML格式，根据生成的所有聊天会话参与者信息的数据结构，以及上述聊天会话所有参与者的资源URL，生成一个聊天会话参与者列表信息的数据结构，作为消息体；

根据所述消息头和消息体生成获取聊天会话参与者列表响应消息。

假定，用户Max Muster(SIP:user1example.com)获取聊天会话参与者列表成功，有2个聊天会话参与者。聊天会话标示符为{chatSessionId1}，聊天会话的状态为会话已建立并使用中，用户Max Muster(SIP:user1example.com)的状态为聊天会话参与者已连接，标示符为{participantId1}；用户Peter E.Xample(SIP:user2example.com)的状态为聊天会话参与者已连接，标示符为{participantId2}。

以下为获取聊天会话参与者列表成功时，获取聊天会话参与者列表响应消息内容的示例：

HTTP/1.1200OK

Content-Type：application/xml

Content-Length：1234

Date：Mon，28Jun 201017:51:59GMT

<？xml version＝″1.0″encoding＝″UTF-8″？>

<chat:ChatParticipantList xmlns:chat＝″urn:oma:xml:rest:chat:1″>\\聊天会话参与者列表信息数据结构的

开始

<participant>\\聊天会话参与者(源端)信息数据结构的开始

    <participantAddress>SIP:user1example.com</participantAddress>

    <participantName>Max Muster</participantName>

    <participantStatus>ChatParticipantConnected</participantStatus>

    <startTime>2010-06-28T17:50:51</startTime>

    <MSRPClientPath>msrp://Max Muster.example.com:7777/iau39soe2843z；tcp</MSRPClientPath>

    <MSRPServerPath>msrp://Server.example.com:4000/amFDknQZ7OIi；tcp</MSRPServerPath>

    <resourceURL>

http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user1example.com/chatSessions/{chatSessionId1}/p

articipants/{participantId1}\\聊天会话参与者(源端)的资源URL

</resourceURL>

</participant>\\聊天会话参与者(源端)信息数据结构的结束

<participant>\\聊天会话参与者(终端)信息数据结构的开始

    <participantAddress>SIP:user2example.com</participantAddress>

    <participantName>Peter E.Xample</participantName>

    <participantStatus>ChatParticipantConnected</participantStatus>

    <startTime>2010-06-28T17:50:51</startTime>

    <resourceURL>

http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user1example.com/chatSessions/{chatSessionId1}/p

articipants/{participantId2}\\聊天会话参与者(终端)的资源URL

</resourceURL>

</participant>\\聊天会话参与者(终端)信息数据结构的结束

<resourceURL>http://{serverRoot}/{apiVersion}/Chat/Originating/SIP:user1example.com/chatSessions/{ch

atSessionId1}/participants</resourceURL>

</chat:ChatParticipantList>\\聊天会话参与者列表信息数据结构的结束

图5为综合上述实施例的，客户端和服务器之间实现聊天会话增加参与者、获取聊天会话参与者列表的操作示意图。

聊天会话建立成功，聊天会话进行中；之后，源端参与者通过客户端请求增加聊天会话参与者，可以是请求增加新的参与者，或者是请求重新加入群组聊天会话，包括以下步骤：

客户端生成聊天会话增加参与者请求消息；

客户端向服务器发送聊天会话增加参与者请求消息；

服务器在收到聊天会话增加参与者请求消息后进行解析和处理，如为聊天会话增加参与者；

服务器生成聊天会话增加参与者响应消息；

服务器向所述客户端返回聊天会话增加参与者响应消息。

聊天会话建立成功，聊天会话进行中；之后，用户通过客户端请求获取聊天会话参与者列表，包括以下步骤：

客户端生成获取聊天会话参与者列表请求消息；

客户端向服务器发送所述获取聊天会话参与者列表请求消息；

服务器在收到获取聊天会话参与者列表请求消息后进行解析和处理，如获取相关的聊天会话的信息；

服务器生成获取聊天会话参与者列表响应消息；

服务器向所述客户端返回获取聊天会话参与者列表响应消息。

上述各个消息的内容和生成方法请参见上文中的描述，不再重复。

上述方案中，具体说明了聊天会话增加参与者和获取聊天会话参与者列表的开放电信能力接口，各个消息的内容即可以满足即时消息业务的需要，又可以适用于现有的开放电信能力的相关规范如OMA中的相关规范、IEFT即时消息协议等。大大方便了Web开发商、第三方开发者或业务提供商等以REST风格的API灵活地对服务器进行聊天会话增加参与者、获取聊天会话参与者列表的相关控制。

本领域普通技术人员可以理解上述方法中的全部或部分步骤可通过程序来指令相关硬件完成，所述程序可以存储于计算机可读存储介质中，如只读存储器、磁盘或光盘等。可选地，上述实施例的全部或部分步骤也可以使用一个或多个集成电路来实现，相应地，上述实施例中的各模块/单元可以采用硬件的形式实现，也可以采用软件功能模块的形式实现。本发明不限制于任何特定形式的硬件和软件的结合。

以上所述仅为本发明的优选实施例而已，并不用于限制本发明，对于本领域的技术人员来说，本发明可以有各种更改和变化。凡在本发明的精神和原则之内，所作的任何修改、等同替换、改进等，均应包含在本发明的保护范围之内。

Claims (18)

1.一种聊天会话增加参与者的方法，该方法基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)实现，包括：

客户端向服务器发送聊天会话增加参与者请求消息，携带使用的动作和资源的信息，以及请求增加到聊天会话中的参与者的信息，所述资源用资源统一资源位置符(URL)标示；

所述服务器收到所述聊天会话增加参与者请求消息后，在所述聊天会话中增加所述参与者，向所述客户端返回聊天会话增加参与者响应消息。

2.根据权利要求1所述的方法，其特征在于：

所述动作为超文本转换协议(HTTP)的布置(POST)动作或设定(PUT)动作，标示所述资源的资源URL包含源端参与者用户标示符和聊天会话标示符中的至少一个。

3.根据权利要求1或2所述的方法，其特征在于：

所述聊天会话增加参与者请求消息中包含请求增加到所述聊天会话中的所述参与者的以下信息中的至少一种：参与者地址、参与者姓名、参与者状态和参与者的资源URL。

4.根据权利要求1或2所述的方法，其特征在于：

所述聊天会话增加参与者响应消息中包含增加到所述聊天会话中的所述参与者的以下信息中的至少一种：参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者标示符、参与者的资源URL、重新加入聊天会话的参与者的MSRP客户端路径信息、重新加入聊天会话的参与者的MSRP服务器路径信息。

5.根据权利要求1所述的方法，其特征在于：

所述客户端发送聊天会话增加参与者请求消息之前，源端参与者请求将新的参与者加入聊天会话，所述客户端按以下方式生成所述聊天会话增加参与者请求消息：

以HTTP的布置(POST)动作或设定(PUT)动作为使用的动作，以聊天会话所有参与者为使用的资源，生成消息头，其中，标示所述资源的资源URL中包含所述源端参与者的用户标示符和/或所述聊天会话的聊天会话标示符；

根据所述新的参与者的参与者地址和/或参与者姓名，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者请求消息。

6.根据权利要求1或5所述的方法，其特征在于：

所述聊天会话中增加所述参与者成功时，所述服务器返回聊天会话增加参与者响应消息之前，按以下方式生成所述聊天会话增加参与者响应消息：

根据源端参与者用户标示符、聊天会话标示符和所述新的参与者的参与者标示符，生成所述新的参与者的资源URL，在HTTP表示“已建立(Created)”的响应符后添加该资源URL表示的位置(Location)信息，生成消息头；

根据所述新的参与者的参与者地址、参与者姓名、参与者状态、参与者标示符和参与者的资源URL中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者响应消息。

7.根据权利要求1所述的方法，其特征在于：

所述客户端发送聊天会话增加参与者请求消息之前，源端参与者请求重新加入此前退出的聊天会话，所述客户端按以下方式生成所述聊天会话增加参与者请求消息：

使用HTTP的布置(POST)动作或设定(PUT)动作和创建的聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的HTTP URL中包含所述源端参与者的用户标示符和/或所述聊天会话的聊天会话标示符；

根据所述源端参与者的参与者地址、参与者姓名和MSRP客户端路径信息中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者请求消息。

8.根据权利要求1或7所述的方法，其特征在于：

所述聊天会话中增加所述参与者成功时，所述服务器返回聊天会话增加参与者响应消息之前，按以下方式生成所述聊天会话增加参与者响应消息：

根据所述源端参与者的用户标示符和参与者标示符，及所述聊天会话的聊天会话标示符，生成所述源端参与者的资源URL，在HTTP表示“已建立”的响应符后添加该资源URL表示的位置(Location)信息，生成消息头；

根据所述源端参与者的参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者标示符、参与者的资源URL、参与者的MSRP客户端路径信息和参与者的MSRP服务器路径信息中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

根据所述消息头和消息体生成聊天会话增加参与者响应消息。

9.一种获取聊天会话参与者列表的方法，该方法基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)实现，包括：

客户端向服务器发送获取聊天会话参与者列表请求消息，消息中携带使用的动作和资源的信息，所述资源用资源统一资源位置符(URL)标示；

所述服务器收到所述获取聊天会话参与者列表请求消息后，获取相应聊天会话的参与者列表，向客户端返回获取聊天会话参与者列表响应消息。

10.根据权利要求9所述的方法，其特征在于：

使用的所述动作为超文本转换协议(HTTP)的获取(GET)动作，标示所述资源的HTTP URL中包含源端参与者用户标示符和聊天会话标示符中的至少一个。

11.根据权利要求9所述的方法，其特征在于：

所述获取聊天会话参与者列表响应消息中携带以下信息中的至少一种：一个或多个聊天会话参与者的信息，以及聊天会话所有参与者的资源URL。

12.根据权利要求11所述的方法，其特征在于：

所述聊天会话参与者的信息包含以下信息中的至少一种：参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者的资源URL、参与者标示符、参与者的消息会话转播协议(MSRP)客户端路径信息和参与者的MSRP服务器路径信息，其中，参与者的MSRP客户端路径信息和MSRP服务器路径信息只有源端参与者才具有。

13.根据权利要求9或12所述的方法，其特征在于：

客户端发送获取聊天会话参与者列表请求消息之前，按以下方式生成所述获取聊天会话参与者列表请求消息：

使用HTTP的获取(GET)动作和聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的HTTP URL中包含发起请求的源端参与者的用户标示符和/或源端参与者参与的聊天会话的标示符；

根据所述消息头生成获取聊天会话参与者列表请求消息。

14.根据权利要求13所述的方法，其特征在于：

所述服务器获取所述聊天会话的参与者列表成功时，按以下方式生成返回的所述获取聊天会话参与者列表响应消息：

根据HTTP表示“成功”的响应符生成消息头；

对聊天会话的每一个参与者，根据该聊天会话参与者的信息生成一个聊天会话参与者信息的数据结构；并根据生成的所有聊天会话参与者信息的数据结构，以及标示所述资源的HTTP URL，生成一个聊天会话参与者列表信息的数据结构，作为消息体；

根据所述消息头和消息体生成获取聊天会话参与者列表响应消息。

15.一种聊天会话增加参与者的系统，服务器和客户端基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)交互，该系统包括：

客户端中的消息生成装置，用于生成聊天会话增加参与者请求消息；

客户端中的消息发送装置，用于向服务器发送所述聊天会话增加参与者请求消息；

服务器中的消息接收和处理装置，用于在收到聊天会话增加参与者请求消息后进行解析和处理，在所述聊天会话中增加所述参与者；

服务器中的消息生成装置，用于生成聊天会话增加参与者响应消息；

服务器中的消息发送装置，用于向所述客户端返回所述聊天会话增加参与者响应消息。

16.如权利要求15所述的系统，其特征在于：

所述客户端中的消息生成装置又包括：

消息头生成子装置，用于使用HTTP的布置(POST)动作或PUT动作和创建的聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的HTTPURL中包含请求将新的参与者加入聊天会话的源端参与者的用户标示符和/或所述聊天会话的聊天会话标示符；

消息体生成子装置，用于根据所述新的参与者的参与者地址和/或参与者姓名，生成聊天会话参与者信息的数据结构，作为消息体；

消息生成子装置，用于根据所述消息头和消息体生成聊天会话增加参与者请求消息；

所述服务器中的消息生成装置又包括：

消息头生成子装置，用于根据源端参与者用户标示符、聊天会话标示符和所述新的参与者的参与者标示符，生成所述新的参与者的资源URL，在HTTP表示“已建立(Created)”的响应符后添加该资源URL表示的位置(Location)信息，生成消息头；

消息体生成子装置，用于根据所述新的参与者的参与者地址、参与者姓名、参与者状态、参与者标示符和参与者的资源URL中的至少一个，生成聊天会话参与者信息的数据结构，作为消息体；

消息生成子装置，用于根据所述消息头和消息体生成聊天会话增加参与者响应消息。

17.一种获取聊天会话参与者列表的系统，客户端和服务器基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)交互，该系统包括：

客户端中的消息生成装置，用于生成获取聊天会话参与者列表请求消息；

客户端中的消息发送装置，用于向服务器发送所述获取聊天会话参与者列表请求消息；

服务器中的消息接收和处理装置，用于在收到所述获取聊天会话参与者列表请求消息后进行解析和处理，获取相应聊天会话的信息；

服务器中的消息生成装置，用于生成获取聊天会话参与者列表响应消息；

服务器中的消息发送装置，用于向所述客户端返回所述获取聊天会话参与者列表响应消息。

18.如权利要求17所述的系统，其特征在于：

所述客户端中的消息生成装置又包括：

消息头生成子装置，用于使用HTTP的获取(GET)动作和聊天会话所有参与者的资源，生成消息头，其中，标示所述资源的资源URL中包含发起请求的源端参与者的用户标示符及源端参与者参与的聊天会话的标示符；

消息生成子装置，用于根据所述消息头生成获取聊天会话参与者列表请求消息；

所述服务器中的消息生成装置又包括：

消息头生成子装置，用于根据HTTP表示“成功”的响应符生成消息头；

消息体生成子装置，用于对聊天会话的每一个参与者，根据该聊天会话参与者的信息生成一个聊天会话参与者信息的数据结构；并根据生成的所有聊天会话参与者信息的数据结构，以及标示所述资源的资源URL，生成一个聊天会话参与者列表信息的数据结构，作为消息体；

根据所述消息头和消息体生成获取聊天会话参与者列表响应消息。

Images