CN102469135B

CN102469135B - 结束文件传输会话和获取文件传输会话信息的方法及系统

Info

Publication number: CN102469135B
Application number: CN201010548231.8A
Authority: CN
Inventors: 邵伟翔
Original assignee: ZTE Corp
Priority date: 2010-11-17
Filing date: 2010-11-17
Publication date: 2015-08-12
Anticipated expiration: 2030-11-17
Also published as: CN102469135A

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)动作，标示所述资源的资源URL包含以下信息中的至少一种：请求结束文件传输会话的参与者的用户标示符和请求结束的文件传输会话的标示符，所述消息中还包含表示结束文件传输的结束参数。

较佳地，

使用的所述动作为HTTP的删除(DELETE)动作，标示所述资源的资源URL包含以下信息中的至少一种：请求结束文件传输会话的参与者的用户标示符、请求结束的文件传输会话的标示符。

较佳地，

所述结束文件传输会话响应消息中包含所述文件传输会话的以下信息中的至少一种：参与者信息、文件传输会话状态、文件传输会话的标示符和文件传输会话的资源URL，其中，所述参与者信息包含以下信息中的至少一种：参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者参与会话的时长、参与者标示符和参与者的资源URL。

较佳地，

客户端发送结束文件传输会话请求消息之前，按以下方式生成所述结束文件传输会话请求消息：

以HTTP的布置(POST)动作为使用的动作，以结束参与者文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求结束文件传输会话的参与者的用户标示符和/或请求结束的文件传输会话的标示符；

根据结束参数的表示“结束”的取值，生成一个结束参数的数据结构，作为消息体；

根据所述消息头和消息体生成所述结束文件传输会话请求消息。

较佳地，

所述服务器结束文件传输会话成功，返回结束文件传输会话响应消息之前，按以下方式生成所述结束文件传输会话响应消息：

根据HTTP表示“无内容(No Content)”的响应符，生成消息头；

根据所述消息头生成结束文件传输会话响应消息。

较佳地，

以HTTP的删除(DELETE)动作为使用的动作，以参与者文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求结束文件传输会话的参与者的用户标示符和/或请求结束的文件传输会话的标示符；

根据所述消息头生成结束文件传输会话请求消息。

较佳地，

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

对结束的文件传输会话的每一个参与者，根据该参与者的参与者信息生成一个文件传输会话参与者信息的数据结构；并根据生成的所有文件传输会话参与者信息的数据结构，以及所述文件传输会话的文件传输会话状态和资源URL中的至少一种，生成一个文件传输会话信息的数据结构，作为消息体；

根据所述消息头和消息体生成结束文件传输会话响应消息。

相应地，本发明提供的结束文件传输会话的系统中，客户端与服务器基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)交互，该系统包括：

客户端中的消息生成装置，用于生成结束文件传输会话请求消息；

客户端中的消息发送装置，用于向服务器发送所述结束文件传输会话请求消息；

服务器中的消息接收和处理装置，用于在收到结束文件传输会话请求消息后进行解析和处理，结束文件传输会话；

服务器中的消息生成装置，用于生成结束文件传输会话响应消息；

服务器中的消息发送装置，用于向所述客户端返回结束文件传输会话响应消息。

较佳地，

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

消息头生成子装置，用于以HTTP的布置(POST)动作为使用的动作，以结束参与者文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求结束文件传输会话的参与者的用户标示符和/或请求结束的文件传输会话的标示符；

消息体生成子装置，用于根据结束参数的表示“结束”的取值，生成一个结束参数的数据结构，作为消息体；

消息生成子装置，用于根据所述消息头和消息体生成所述结束文件传输会话请求消息；

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

消息头生成子装置，用于根据HTTP表示“无内容(No Content)”的响应符，生成消息头；

消息生成子装置，用于根据所述消息头生成结束文件传输会话响应消息。

较佳地，

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

消息头生成子装置，用于以HTTP的删除(DELETE)动作为使用的动作，以参与者文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求结束文件传输会话的参与者的用户标示符和/或请求结束的文件传输会话的标示符；

消息生成子装置，用于根据所述消息头生成结束文件传输会话请求消息；

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

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

消息体生成子装置，用于对结束的文件传输会话的每一个参与者，根据该参与者的参与者信息生成一个文件传输会话参与者信息的数据结构；并根据生成的所有文件传输会话参与者信息的数据结构，以及所述文件传输会话的文件传输会话状态和资源URL中的至少一种，生成一个文件传输会话信息的数据结构，作为消息体；

消息生成子装置，用于根据所述消息头和消息体生成结束文件传输会话响应消息。

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

有鉴于此，本发明的另一个目的在于提供一种获取文件传输会话信息的方法及系统，以解决用户不能调用电信能力获取文件传输会话信息的问题。

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

客户端向服务器发送获取文件传输会话信息请求消息，携带使用的动作和资源的信息，所述资源用统一资源位置符(URL)标示；

所述服务器收到所述获取文件传输会话信息请求消息后，获取请求的文件传输会话的信息，向所述客户端返回获取文件传输会话信息响应消息。

较佳地，

使用的所述动作为超文本转换协议(HTTP)的获取(GET)动作，标示所述资源的资源URL包含以下信息中的至少一种：请求获取文件传输会话信息的参与者的用户标示符和所述文件传输会话的标示符。

较佳地，

所述获取文件传输会话信息响应消息中包含以下文件传输会话信息中的至少一种：参与者信息、文件传输会话状态、文件传输标示符、文件选择器、文件部署、文件传输会话的标示符和文件传输会话的资源URL。

较佳地，

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

较佳地，

客户端发送获取文件传输会话信息请求消息之前，按以下方式生成所述获取文件传输会话信息请求消息：

以HTTP的获取(GET)动作为使用的动作，以所述文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求获取文件传输会话信息的源端参与者的用户标示符和/或所述文件传输会话的标示符；

根据所述消息头生成获取文件传输会话信息请求消息。

较佳地，

所述服务器获取文件传输会话信息成功时，返回获取文件传输会话信息响应消息之前，按以下方式生成获取文件传输会话信息响应消息：

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

对所述文件传输会话的每一个参与者，根据该参与者的参与者信息，生成一个文件传输会话参与者信息的数据结构；并根据生成的所有文件传输会话参与者信息的数据结构，以及所述文件传输会话的文件传输会话状态、文件传输标示符、文件选择器、文件部署和资源URL信息中的至少一种，生成一个文件传输会话信息的数据结构，作为消息体；

根据所述消息头和消息体生成获取文件传输会话信息响应消息。

相应地，本发明提供的获取文件传输会话信息的系统中，客户端与服务器基于电信网络域提供的表象化状态转变(REST)应用编程接口(API)交互，该系统包括：

客户端中的消息生成装置，用于生成获取文件传输会话信息请求消息；

客户端中的消息发送装置，用于向服务器发送所述获取文件传输会话信息请求消息；

服务器中的消息接收和处理装置，用于在收到获取文件传输会话信息请求消息后进行解析和处理，获取文件传输会话的信息；

服务器中的消息生成装置，用于生成获取文件传输会话信息响应消息；

服务器中的消息发送装置，用于向所述客户端返回获取文件传输会话信息响应消息。

较佳地，

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

消息头生成子装置，用于以HTTP的获取(GET)动作为使用的动作，以所述文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求获取文件传输会话信息的源端参与者的用户标示符和所述文件传输会话的标示符；

消息生成子装置，用于根据所述消息头生成获取文件传输会话信息请求消息；

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

消息本生成子装置，用于对所述文件传输会话的每一个参与者，根据该参与者的参与者信息，生成一个文件传输会话参与者信息的数据结构；并根据生成的所有文件传输会话参与者信息的数据结构，以及所述文件传输会话的文件传输会话状态、文件传输标示符、文件选择器、文件部署和资源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版本，FileTransfer表示文件传输，Originating表示源端，OriginatingID表示源端参与者用户标示符，如采用源端参与者地址。

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

数据结构类型Type：FileTransferSessionInformation文件传输会话信息

其中，文件选择器表示一组文件传输会话描述的文件属性，用于选择指定的文件，包括文件名、文件类型、文件大小、哈希加密码等；文件部署表示建议接收文件方对该文件的处理方式，可以是立即显示使用“render”，或者保存为附件“attachment”。文件传输会话的资源URL中可包含源端参与者的用户标示符{OriginatingID}和文件传输会话的标示符(FileTransferSessionId)。

数据结构类型Type：FileTransferParticipantInformation文件传输会话参与者信息

其中，文件传输会话参与者(包括源端、终端)的资源URL可以包含文件传输会话的资源URL和参与者标示符(participantId)。

数据结构类型Type：TerminationParameters结束参数

Element参数元素	Type类型	Optional是否可选
			Termination结束	xsd：boolean布尔值	N否

枚举Enumeration：FileTransferSessionStatus文件传输会话状态

Enumeration枚举值	Description描述
		FileTransferOngoing	The FileTransfer is built and used会话已建立并使用中
FileTransferTerminated	The FileTransfer is terminated会话已结束
		FileTransferRequesting	The FileTransfer is requesting会话(邀请)请求进行中

枚举Enumeration：FileTransferParticipantStatus文件传输会话参与者状态

图2为本实施例基于REST API结束文件传输会话的流程图，包括以下步骤：

步骤S201：客户端向服务器发送结束文件传输会话请求消息(POST)，携带使用的动作和资源的信息，所述资源用资源URL标示；

本实施例的结束文件传输会话请求消息中，消息头中包括使用的动作和资源，消息体中包括结束参数的数据结构。

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

以HTTP的布置(POST)动作为使用的动作，以结束参与者(如源端参与者)文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求结束文件传输会话的参与者的用户标示符和请求结束的文件传输会话的标示符中的至少一个；

采用本实施例的方式结束文件传输会话，服务器会继续保留该会话的信息。各实施例涉及的几个消息中的消息体，也可以采用XML外的其他专用格式如Java脚本对象符号(JSON)。

下面用一个示例来说明一下生成的结束文件传输会话请求消息。

假定源端参与者请求结束文件传输会话，源端参与者为用户MaxMuster(SIP：user1example.com)，相应的文件传输会话标示符为{FileTransferSessionId1}。

以下为结束文件传输会话请求消息内容的示例及说明：

POST

http://{serverRoot}/{apiVersion}/FileTransfer/Originating/SIP：userlexample.com/FileTransferSessions/{Fil

eTransferSessionIdl}/terminate HTTP/1.1\\动作+结束文件传输会话的资源URL

Content-Type：application/xml

Accept：application/xml

Host：example.com：80

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

<FileTransfer:terminationParameters xmlns:FileTransfer＝″urn:oma:xml:rest:FileTransfer:1″>

<Termination>true</Termination>\\结束参数数据结构，取值表示“结束”

</FileTransfer:terminationParameters>POST

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

步骤S202：所述服务器收到结束文件传输会话请求消息后，结束文件传输会话，向所述客户端返回结束文件传输会话响应消息。

结束文件传输会话响应消息中，消息头包括HTTP的响应符，可以不携带消息体。

服务器结束文件传输会话成功时，可以通过以下方式来生成该消息：

根据HTTP表示“无内容(No Content)”的响应符，生成消息头；

根据所述消息头生成结束文件传输会话响应消息。

以下为结束文件传输会话成功时，结束文件传输会话响应消息内容的示例和说明：

HTTP/1.1204No Content

Date：Mon，28 Jun 2010 17:51:59 GMT

实施例二

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

图3为本实施例基于REST API结束文件传输会话的流程图，包括以下步骤：

步骤S301：客户端向服务器发送结束文件传输会话请求消息(DELETE)，携带使用的动作和资源的信息，所述资源用资源URL标示；

本实施例的结束文件传输会话请求消息中，消息头中包括使用的动作和资源，可以不携带消息体。

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

以HTTP的删除(DELETE)动作为使用的动作，以参与者(如源端参与者)文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求结束文件传输会话的源端参与者的用户标示符和请求结束的文件传输会话的标示符中的至少一个；

根据所述消息头生成结束文件传输会话请求消息。

假定源端参与者为用户Max Muster(SIP：userlexample.com)，该用户请求结束文件传输会话，相应的文件传输会话标示符为{FileTransferSessionId1}。

以下为结束文件传输会话请求消息内容的示例及说明：

DELETE

http://{serverRoot}/{apiVersion}/FileTransfer/Originating/SIP：user2example.com/FileTransferSessions/{Fil

eTransferSessionIdl}HTTP/1.1

Accept：application/xml

Host：example.com：80

步骤S302：所述服务器收到结束文件传输会话请求消息后，结束文件传输会话，向所述客户端返回结束文件传输会话响应消息。

结束文件传输会话响应消息中，消息头包括HTTP的响应符，消息体中包括文件传输会话信息的数据结构。

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

按照XML格式，对结束的文件传输会话的每一个参与者，根据该参与者的信息如参与者地址、参与者名称、参与者状态、参与者启动时间、参与者参与会话的时长和参与者的资源URL等信息中的至少一种，生成一个文件传输会话参与者信息的数据结构；

按照XML格式，根据生成的所有文件传输会话参与者信息的数据结构，以及所述文件传输会话的文件传输会话状态和资源URL等信息中的至少一种，生成一个文件传输会话信息的数据结构，作为消息体；

根据所述消息头和消息体生成结束文件传输会话响应消息。

以下为结束文件传输会话成功时结束文件传输会话响应消息内容的示例和说明：

假定文件传输会话标示符为{FileTransferSessionId1}，文件传输会话的状态为会话已结束；用户Max Muster(SIP：user1example.com)和Peter E.Xample(SIP：user2example.com)的状态为文件传输会话参与者已终止。

HTTP/1.1200OK

Content-Type：application/xml

Content-Length：1234

Date：Mon，28 Jun 2010 17:51:59 GMT

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

<FileTransfer:FileTransferSessionInformation xmlns:FileTransfer＝″urn:oma:xml:rest:FileTransfer:1″>\\文件

传输会话信息数据结构的开始

<participant>\\文件传输会话参与者信息(源端)数据结构的开始

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

<participantName>MaxMuster</participantName>

<participantStatus>FileTransferParticipantTerminated</participantStatus>

eTransferSessionId1}/participants/{participantId1}\\源端参与者的资源URL

</resourceURL>

</participant>\\文件传输会话参与者信息(源端)数据结构的结束

<participant>\\文件传输会话参与者信息(终端)数据结构的开始

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

<participantName>PeterE.Xample</participantName>

<participantStatus>FileTransferParticipantTerminated</participantStatus>

eTransferSessionId1}/participants/{participantId2}\\终端参与者的资源URL

</resourceURL>

</participant>\\文件传输会话参与者信息(终端)数据结构的结束

<FileTransferSessionStatus>FileTransferTerminated</FileTransferSessionStatus>\\文件传输会话状态

<clientCorrelator>104567</clientCorrelator>\\客户端相关标签

<resourceURL>http://{serverRoot}/{apiVersion}/FileTransfer/Originating/SIP:user2example.com/FileTrans

ferSessions/{FileTransferSessionId1}</resourceURL>\\结束的文件传输会话的资源URL

</FileTransfer:FileTransferSessionInformation>\\文件传输会话信息数据结构的结束

实施例三

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

图4为本实施例基于REST API获取文件传输会话信息的流程图，包括以下步骤：

步骤S401：客户端向服务器发送获取文件传输会话信息请求消息，携带使用的动作和资源的信息，所述资源用资源统一资源位置符(URL)标示；

获取文件传输会话信息请求消息的消息头包括使用的动作和资源，可以不携带消息体。

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

以HTTP的获取(GET)动作为使用的动作，以所述文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求获取文件传输会话信息的源端参与者的用户标示符和所述文件传输会话的标示符；

根据所述消息头生成获取文件传输会话信息请求消息。

下面用一个示例来说明一下生成的获取文件传输会话信息请求消息。

假定源端参与者为用户Max Muster(SIP：user1example.com)，该请求为获取该用户的文件传输会话{FileTransferSessionId1}。

以下为获取文件传输会话信息请求消息内容的示例及说明：

GET http://{serverRoot}/{apiVersion}/FileTransfer/Originating/SIP：user1example.com/FileTransferSessions/{FileTransferSessionIdl}HTTP/1.1\\动作+资源的资源URL

Accept：application/xml

Host：example.com：80

步骤S402：所述服务器收到所述获取文件传输会话信息请求消息后，获取请求的文件传输会话的信息，向所述客户端返回获取文件传输会话信息响应消息。

服务器获取文件传输会话信息成功时，获取文件传输会话信息响应消息的消息头包括HTTP的响应符，消息体中包括获取的文件传输会话信息的数据结构。可以通过以下方式来生成：

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

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

按照XML格式，根据生成的所有文件传输会话参与者信息的数据结构，以及所述文件传输会话的文件传输会话状态、文件传输标示符、文件选择器、文件部署和资源URL信息中的至少一种，生成一个文件传输会话信息的数据结构，作为消息体；

假定，用户Max Muster(SIP：user1example.com)获取文件传输会话信息成功，文件传输会话标示符为{FileTransferSessionId1}，文件传输会话的状态为会话已建立并使用中；用户Max Muster(SIP：user1example.com)的状态为文件传输会话参与者已连接，标示符为{participantId1}；用户Peter E.Xample(SIP：user2example.com)的状态为文件传输会话参与者已连接，标示符为{participantId2}。用户Max Muster本人的MSRP路径信息返回。

以下为获取文件传输会话信息成功时，获取文件传输会话信息响应消息内容的示例，其中的文件传输会话信息的数据结构与上文相似，不再说明：

HTTP/1.1200OK

Content-Type：application/xml

Content-Length：1234

Date：Mon，28 Jun 2010 17:51:59 GMT

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

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

<participantName>Max Muster</participantName>

<participantStatus>FileTransferParticipantConnected</participantStatus>

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

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

eTransferSessionIdl}/participants/{participantIdl}

</participant>

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

<participantName>Peter E.Xample</participantName>

<participantStatus>FileTransferParticipantConnected</participantStatus>

http://{serverRoot}/{apiVersion}/FileTransfer/Originating/SIP：user1example.com/FileTransferSessions/{Fil

eTransferSessionIdl}/participants/{participantId2}

</resourceURL>

</participant>

<FileTransferSessionStatus>FileTransferOngoing</FileTransferSessionStatus>

<file-transfer-id>Q6LMoGymJdh0IKIgD6wD0jkcfgva4xvE</file-transfer-id>

<File-Selector>name：″My cool picture.jpg″type：image/jpeg size：4092

hash：sha-1：72：24：5F：E8：65：3D：DA：F3：71：36：2F：86：D4：71：91：3E：E4：A2：CE：2E</File-Selector>

<flle-disposition>attachment</file-disposition>

<resourceURL>http://{serverRoot}/{apiVersion}/FileTransfer/Originating/SIP：user1example.com/FileTrans

ferSessions/{FileTransferSessionIdl}</resourceURL>

</FileTransfer:FileTransferSessionInformation>

图5为综合上述实施例的，客户端和服务器之间结束文件传输会话、获取文件传输会话信息的操作示意图。

文件传输会话建立成功，文件传输会话进行中；

之后，客户端请求获取文件传输会话信息，包括以下步骤：

客户端生成获取文件传输会话信息请求消息；

客户端向服务器发送所述获取文件传输会话信息请求消息；

服务器在收到获取文件传输会话信息请求消息后进行解析和处理，获取文件传输会话的信息；

服务器生成获取文件传输会话信息响应消息；

服务器向所述客户端返回获取文件传输会话信息响应消息。

之后，客户端请求结束文件传输会话，包括以下步骤：

客户端生成结束文件传输会话请求消息；

客户端向服务器发送结束文件传输会话请求消息；

服务器在收到结束文件传输会话请求消息后进行解析和处理，结束相应的文件传输会话；

服务器生成结束文件传输会话响应消息；

服务器向所述客户端返回结束文件传输会话响应消息。

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

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

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

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

Claims

1.一种结束文件传输会话的方法，该方法基于电信网络域提供的表象化状态转变REST应用编程接口API实现，包括：

客户端向服务器发送结束文件传输会话请求消息，携带使用的动作和资源的信息，所述资源用统一资源位置符URL标示；

所述服务器收到结束文件传输会话请求消息后，结束文件传输会话，向所述客户端返回结束文件传输会话响应消息；

其中，使用的动作为超文本转换协议HTTP的删除DELETE动作，标示所述资源的资源URL包含以下信息中的至少一种：请求结束文件传输会话的参与者的用户标示符、请求结束的文件传输会话的标示符；以及

所述结束文件传输会话响应消息中包含所述文件传输会话信息的以下信息中的至少一种：参与者信息、文件传输会话状态、文件传输会话的标示符、文件传输会话的资源URL、文件选择器、文件部署和回调指针，其中，所述参与者信息包含以下信息中的至少一种：参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者参与会话的时长、参与者标示符、参与者的资源URL、消息会话转播协议MSRP客户端路径信息和MSRP服务器路径信息；

其中，客户端发送结束文件传输会话请求消息之前，按以下方式生成所述结束文件传输会话请求消息：

以HTTP的删除DELETE动作为使用的动作，以参与者文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求结束文件传输会话的参与者的用户标示符和/或请求结束的文件传输会话的标示符；

根据所述消息头生成结束文件传输会话请求消息。

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

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

根据所述消息头和消息体生成结束文件传输会话响应消息。

3.一种获取文件传输会话信息的方法，该方法基于电信网络域提供的表象化状态转变REST应用编程接口API实现，包括：

客户端向服务器发送获取文件传输会话信息请求消息，携带使用的动作和资源的信息，所述资源用统一资源位置符URL标示；

所述服务器收到所述获取文件传输会话信息请求消息后，获取请求的文件传输会话的信息，向所述客户端返回获取文件传输会话信息响应消息；

其中，使用的动作为超文本转换协议HTTP的获取GET动作，标示所述资源的资源URL包含以下信息中的至少一种：请求获取文件传输会话信息的参与者的用户标示符和所述文件传输会话的标示符；

所述获取文件传输会话信息响应消息中包含以下文件传输会话信息中的至少一种：参与者信息、文件传输会话状态、文件传输标示符、文件选择器、文件部署、文件传输会话的标示符和文件传输会话的资源URL；所述参与者信息包含以下信息中的至少一种：参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者的资源URL、参与者的标示符、源端参与者的消息会话转播协议MSRP客户端路径信息、源端参与者的MSRP服务器路径信息；

其中，客户端发送获取文件传输会话信息请求消息之前，按以下方式生成所述获取文件传输会话信息请求消息：

以HTTP的获取GET动作为使用的动作，以所述文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求获取文件传输会话信息的源端参与者的用户标示符和/或所述文件传输会话的标示符；

根据所述消息头生成获取文件传输会话信息请求消息。

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

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

5.一种结束文件传输会话的系统，客户端与服务器基于电信网络域提供的表象化状态转变REST应用编程接口API交互，该系统包括：

客户端中的消息生成装置，用于生成携带使用的动作和资源信息的结束文件传输会话请求消息，所述资源用统一资源位置符URL标示；

服务器中的消息发送装置，用于向所述客户端返回结束文件传输会话响应消息；

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

消息头生成子装置，用于以HTTP的删除DELETE动作为使用的动作，以参与者文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求结束文件传输会话的参与者的用户标示符和/或请求结束的文件传输会话的标示符；

消息生成子装置，用于根据所述消息头生成结束文件传输会话请求消息。

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

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

7.一种获取文件传输会话信息的系统，客户端与服务器基于电信网络域提供的表象化状态转变REST应用编程接口API交互，该系统包括：

服务器中的消息发送装置，用于向所述客户端返回获取文件传输会话信息响应消息；

其中，所述获取文件传输会话信息响应消息中包含以下文件传输会话信息中的至少一种：参与者信息、文件传输会话状态、文件传输标示符、文件选择器、文件部署、文件传输会话的标示符和文件传输会话的资源URL；所述参与者信息包含以下信息中的至少一种：参与者地址、参与者姓名、参与者状态、参与者启动时间、参与者的资源URL、参与者的标示符、源端参与者的消息会话转播协议MSRP客户端路径信息、源端参与者的MSRP服务器路径信息；

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

消息头生成子装置，用于以HTTP的获取GET动作为使用的动作，以所述文件传输会话为使用的资源，生成消息头，标示所述资源的资源URL包含请求获取文件传输会话信息的源端参与者的用户标示符和所述文件传输会话的标示符；

消息生成子装置，用于根据所述消息头生成获取文件传输会话信息请求消息。

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

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