CN1433547A

CN1433547A - 会话初始协议小服务程序应用编程接口

Info

Publication number: CN1433547A
Application number: CN00818877.7A
Authority: CN
Inventors: D·阿贾伊
Original assignee: MCI Worldcom Inc
Current assignee: Verizon Business Global LLC
Priority date: 1999-12-08
Filing date: 2000-12-08
Publication date: 2003-07-30
Also published as: AU4714901A; MXPA02005701A; EP1240593A1; CA2395616A1; WO2001046822A1; BR0016237A; JP2003518352A

Abstract

用于会话初始协议(SIP)(16)小服务程序(22，26)的应用程序接口(API)。为了处理与SIP一致的信息，该API公布小服务程序所需要的决定性功能。小服务程序可实现电话服务逻辑，例如呼叫转送，呼叫屏蔽和移动服务。

Description

会话初始协议小服务程序应用编程接口

技术领域

本发明通常涉及电信系统，特别是涉及会话初始协议小服务程序(servlet)应用编程接口。

背景技术

会话初始协议(SIP)是一种在计算系统或者其他适宜的设备中创建、修改、终止通信会话的应用层协议。SIP正式地定义在Handley等等的“SIP：会话初始协议，”Internet Engineering Task Force，RFC2543(1999年8月)。多个参与者可以参与在每一个会话中。会话的例子包括Internet多媒体会议，Internet电话呼叫和多媒体分配会话。会话中的参与者可以通过组播(multicast)、单播(unicast)的一个网格或者通过多址和单址关系的组合来通信。

传统的系统不提供用于开发与SIP相一致的应用程序的便利机制。开发者必须定制开发应用并确保该应用与SIP协议所要求的行为一致。这个困难使得应用开发变得麻烦并阻碍与SIP相一致的新应用的增加，考虑到该应用的自定义特性，保持该应用也是困难的。

发明概述

本发明通过促进SIP小服务程序的使用来处理上述传统系统的限制。用在文章中的“小服务程序”一词指在服务器上运行以提供预期功能的计算机代码的一部分。小服务程序可被认为是服务器端对小应用程序的模拟。在本发明中，小服务程序提供电话服务逻辑。在本发明的一个实施例中，应用编程接口(API)定义为SIP小服务程序。API是可被应用用于要求并执行底层服务的一系列方法。SIP小服务程序API识别接口和对象，其中小服务程序应当是一个完全成熟的SIP小服务程序。API判断什么是SIP小服务程序所需的功能。

按照本发明的一个方面，SIP小服务程序提供在一个数据处理装置中。运行SIP小服务程序来实现电话服务逻辑。作为电话服务逻辑的一部分，SIP小服务程序可以检查，处理或者转发SIP消息，例如SIP请求或者SIP响应。

按照本发明的另一个发明，小服务程序应用于计算环境中。提供一个一个小服务程序管理器来管理小服务程序。符合SIP的通信被接收到。小服务程序管理器决定在小服务程序中选择的一个执行通信，所选择的小服务程序随后执行该通信。

按照本发明的进一步方面，电子装置包括接收SIP信息的接口，该装置还包括执行SIP信息以完成电话服务逻辑的一个小服务程序。

附图说明

本发明的一个示例性的实施例将参考下面的附图进行描述。

附图1描述了一个适于实现本发明的示例性实施例的第一系统的框图。

附图2描述了一个适于实现示例性实施例的第二系统的框图。

附图3是在示例性实施例中执行完成电话服务逻辑通常步骤的流程图。

附图4是在示例性实施例中执行完成呼叫屏蔽步骤的流程图。

附图5是在示例性实施例中执行完成呼叫转发步骤的流程图。

发明详述

示例性实施例提出了用于SIP小服务程序的应用编程接口(API)。开发者可使用API开发提供定制行为的SIP小服务程序。SIP小服务程序提供在SIP小服务程序API中提出的方法的实施。SIP小服务程序确保使用者可以在工作时(on the fly)动态的扩展服务器的功能。SIP小服务程序可检查信息，改变信息首部的值，转发信息并通常处理信息来实现电话服务逻辑，例如SIP小服务程序可被用于实现呼叫转发，呼叫屏蔽和移动服务。本领域的技术人员可知SIP小服务程序也可被用于实现传统的电话逻辑。

示例性实施例的SIP小服务程序可被写成程序语音，例如来自SunMicrosystems公司的Java编程语言。本领域的技术人员可知小服务程序也可被写成其它适当的编程语音。

SIP(也就是说，会话伴随“呼叫”的传递)请求信息并响应信息。这是两种用于SIP中的专用类型信息。响应信息响应于请求信息。例如，当第一个用户希望与第二个用户进行会话，第一个用户向第二个用户发送INVITE请求。第二个用户接收到INVITE请求并以一个响应信息来响应，该信息指示第二个用户是否参与到该会话中。

附图1描述了一个适于执行本发明示例性实施例的第一个系统10的框图。一个用户使用可以通过SIP通信的用户装置12。用户装置12可以是一个计算机系统，一个蜂窝电话，一个智能寻呼机，一个个人数字助理(PDA)或者更通常的，可以是任何可以参与到SIP会话中的电子装置。第二个用户也可使用用户装置14，它可以是任何类型的可以参与SIP会话的部件(如上面所列出的)。

在附图1中，使用SIP代理服务器16。SIP代理服务器是一个中间程序，为了对其它客户的行为作出响应，它既是一个服务器又是一个客户。SIP代理服务器16可用在专用的服务器计算机系统中也可用于共享的计算机系统中。请求可由SIP代理服务器处理或者在编译之后传递给其它服务器。SIP代理服务器16解释请求并且如果必须的话，在转发该请求之前重写该请求。一些小服务程序22可被安置SIP代理服务器16上来实现电话服务逻辑。小服务程序管理器20也被安置在SIP代理服务器16上。小服务程序管理器20负责接收信息并判断小服务程序22中的哪一个处理该信息。

附图1中所示的系统10也包括一个用户代理服务器18。用户代理服务器18是一个当接收到SIP请求时联系用户设备14的用户的服务器应用。另外，用户代理服务器18代表用户服务器14的用户返回一个响应。响应接收拒绝或者转发该请求。用户代理服务器18也可结合小服务程序管理器24和小服务程序26。

附图2表示实现本发明示例性实施例的一个替代系统28。系统28包括用户装置30和32。系统28不同于系统10在于系统28使用转发服务器34而不是代理服务器16。转发服务器34是接收SIP请求，映射在SIP请求中提出的地址到一个新地址，并且将该地址返回给用户的一个服务器。与SIP服务器不同，转发服务器34不产生它自己的SIP请求，与用户代理服务器18相反，转发服务器34不接受呼叫。SIP转发服务器34与小服务程序管理器36和小服务程序38结合。

在讨论由示例性实施例提供的SIP小服务程序API的细节之前，最好概括的回顾一下小服务程序是怎样被使用的。附图3提供一个使用小服务程序所执行的步骤的总流程图。通常，小服务程序提供在服务器中的一个上(附图3中所示的步骤40)。小服务程序单独运行或者与其它小服务程序联合来实现嗲哈服务逻辑(附图3中所示的步骤42)。电话服务逻辑可以包括任何实现在电话系统中的多种不同类型的呼叫处理方式。

附图4是表示实现呼叫屏蔽步骤的流程图。开始，服务器接收INVITE请求(也就是说一个“请求”)来启动一个会话(附图4中所述的步骤44)。INVITE请求包括确认希望发起会话(也就是说“呼叫”)的呼叫者信息。呼叫者信息由小服务程序注解(附图4中所述的步骤46)。基于呼叫者信息，小服务程序判断是否屏蔽改呼叫并且怎样屏蔽该呼叫(附图4中所述的步骤48)。小服务程序访问可以识别屏蔽该呼叫的正确途径的数据库或者其它信息源。例如，该数据库中的信息可以通知小服务程序该呼叫是被封装的并转发给一个操作者，直接发送给语音邮件平台或放置在队列中。

附图5是一个描述实现呼叫转发执行步骤的流程图。开始，一个小服务程序接收INVITE请求(附图5中的步骤50)。小服务程序访问一个数据库或另一个信息源以获得呼叫处理信息。在此例中，呼叫处理信息识别要转发的呼叫。同样，小服务程序注释必须被转发的呼叫(附图5中的步骤52)。INVITE请求随后被转发给适当的目的地(附图5中的步骤56)。

当呼叫者希望进行一个SIP呼叫，呼叫者首先定位一个服务器并向该服务器发送SIP请求。最普通的请求是INVITE请求。SIP请求可被转发或者触发一系列由代理所要求的新的SIP。使用者可以用SIP服务器注册它们的位置。用户定位于主机并可通过SIP URLs(统一资源定位符)来识别。SIP URLs采用用户@主机名的形式，其中用户部分是用户的名字或电话号码，主机部分可以是域名或者数字网络地址。

如上所述，每一个SIP信息可以是一个请求也可是一个呼叫。这些信息使用在RFC822.D.Crocker，“Standard For The Format Of ARPAInternet Text Message”中提出的通常的信息形式，请求注解822，Internet Engineering Task Force，1982年8月。通常的信息格式包括一个开始行，一个或多个标题字段，包括标题字段末尾的一个空行以及可选的信息主体。

示例性实施例定义一个Sip小服务程序抽象基本对象类作为Sip小服务程序API的主要抽象。此抽象基本类扩展实现小服务程序接口的普通服务对象类。Sip小服务程序类定义处理所有SIP请求的默认方法。此方法多路分解每个请求并负责在小服务程序的适当时机调用适当方法。Sip小服务程序抽象基本类定义执行SIP请求的特殊类型的传统方法。这些方法被处理SIP请求的服务方法(也就是说小服务程序管理器)自动调用。Sip小服务程序对象类的对象支持两个组：javax.servlet和servlet.sip。javax.servlet组是一个由Palo Alto California的Sun Microsystems公司定义的一个组。“组”由功能性组成对象类。“类”是数据和操作该数据方法的集合。每个组组成一定数量的接口。一个“接口”类似于一个抽象基本类并提供方法和属性的签名，其中为了支持该接口，方法和属性必须由对象来实现。

servlet.sip组定义如下。

The servlet.sip package is defined as follows.

interface SipServletRequest

interface SipServletResponse

interface SipSession

interface SipBindingListener

class SipScrvlet

class URI

class SessionDescription

class MediaDescription

class SipUtils

如上所示，sevlet.sip组包括4个接口：SipSevlet请求接口，SipSevlet响应接口，Sip会话接口及SipBinding收听者接口。这些接口将在下面详细介绍。另外，sevlet.sip组规定5个对象类：Sip小服务程序对象类，URL对象类，会话描述对象类，媒体描述对象类和SipUtils对象类。Sip小服务程序对象类在前面已经描述。URL对象类是一个封装关于SIP统一资源定位符信息的对象。会话描述对象类保存关于特殊会话的属性和方法，媒体描述对象类保存在一个SIP调用期间可被服务器支持的媒体的有关属性和方法。最后，SipUtils对象类是一个包括一定数量实用程序的对象。

Sip小服务程序请求接口更正式的定义如下。

public String getAuthType()；
public String getCallId()；
public long getDateHeader(String name)；
public String getHeader(String name)；
public Enumeration getHeaderNames()；
public int getIntHeader(String name)；
public String getMethod()；
public String getPathInfo()；
public String getPathTranslated()；
public String getQucryString()；
public String getRemoteUser()；
public String getRequestedSessionID()；
public String getRequestURI()；
public String getServletPath()；
public SipSession getSession(boolcan create)；
public SipSession getSession().
public boolcan isRequestedSessionIdValid()；

Sip小服务程序请求接口定义一个对象来向一个小服务程序提供客户请求信息。GetAuthType方法从一个请求的标题获取认证类型信息。SIP支持若干不同认证选项。GetCallId方法从请求标题获取调用ID。调用ID是一个调用的唯一标识。GetDateHeader方法从请求获取一个日期标题域。GetHeader方法获取一个指定为方法一个参数的标题。GetHeaderNames方法从一个给定的请求获取标题的名字。GetIntHeader方法获取一个整型标题。GetMethod方法获取一个方法。GetPathInfo方法获取一个SIP URL或其它路径信息。GetPathTranslated方法获取已被翻译的路径的路径信息的有关参数。GetQueryString方法获取一个查询串，getRemoteUser方法获取关于远程用户(也就是说，调用者)的信息。GetRequestedSessionID方法从请求获取一个会话ID。GetReques tURL获取一个请求URL，get小服务程序Path方法获取对于小服务程序的一个路径。GetSession方法返回一个存在的会话或返回一个值表示一个会话仍未建立并新建一个会话。IsRequestedSessionIdValid方法返回一个布尔值表示一个会话ID是否有效。

Sip小服务程序Response接口扩展javax.servlet组的小服务程序Response接口。SipservletResponse接口由如下定义。

public static final int SC_TRYING；
public static final int SC_RINGING；
public static final int SC_CALL_BEGIN_FORWARDED；
public static final int SC_CALL_QUEUED；
public static final int SC_OK；
public stattc final int SC_MULTIPLE_CHOICES；
public static final int SC_MOVED_PERMANENTLY；
public static final int SC_MOVED_TEMPORARILY；
public static final int SC_SEE_OTHER；
public static final int SC_USE_PROXY；
public static final int SC_ALTERNATIVE_SERVICE；
public static final int SC_BAD_REQUEST；
public static final int SC_UNAUTIIORIZED；
public static final int SC_PAYMENT_REQUIRED；
public static final int SC_BAD_FORBIDDEN；
				
				<dp n="d7"/>
public static final int SC_NOT_FOUND；
public static final int SC_METHOD_NOT_ALLOWED；
public static final int SC_PROXY_AUTHENTICATION_REQUIRED；
public static final int SC_REQUEST_TIMEOUT；
public static final int SC_CCONFLICT；
public static final int SC_GONE；
public static final int SC_LENGTH_REQUIRED；
public static final int SC_REQUEST_URI_TOO_LARGE；
public static final int SC_REQUEST_ENTITY_TOO_LONG；
public static final int SC_UNSUPPORTED_MEDIA_TYPE；
public static final int SC_BAD_EXTENSION；
public static final int SC_TEMPORARLY_UNABAILABLE；
public static final int SC_CALL_LEG_DNE；
public static final int SC_LOOP_DETECTED；
public static final int SC_TOO_MANY_HOPS；
public static final int SC_ADDRESS_INCOMPLETE；
public static final int SC_AMBIGUOUS；
public static final int SC_BUSY_HERE；  
public static final int SC_SERVER_INTERNAL_ERROR；
Public static final int SC_NOT_IMPLEMENTED；
public static final int SC_BAD_GATBWAY；
public static final int SC_SERVICE_NAVAILABLE；  
public static final int SC_GATEWAY_TIMEOUT；
public static final int SC_VERSION_NOT_SUPPORTED；
public static final int SC_BUSY_EVERYWHERE；
public static final int SC_DECLINE；
public static final int SC_DOES_NOT_EXTT_ANYWHERE；
public static final int SC_NOT_ACCEPTABLE；
public boolean containsHeader(String name)；
Public void sendError(int sc，String mesg)throws IOException；
public void sendError(int sc)throws IOException；
public void sendRedireet(String location)throws IOException；
public void setDateHeader(String name，long date)；
				
				<dp n="d8"/>
public void setHeader(String name，String value)；
public void setIntHcadcr(String name，int value)；
public void setStatus(int sc)；
public void setStatus(int sc，String sm)；

如上述列出，接口包括若干常量(也就是说，静态最终变量)。这些常量与定义在SIP规范中的状态码一致。

SipservletResponse接口还包括若干方法。ContainsHeader方法返回一个布尔值表示响应是否包括一个标题。MultiplesendError方法被定义于产生错误告警。输入参数可只包括一个状态码或以串的格式包括一个状态码与一个信息。SendRedirect方法产生一个要转发的例外并表示一个响应被转发至何处。SetDateHeader方法建立一个用于日期标题的值，setHeader方法建立一个用于特殊命名标题的值。SetIntHeader方法设置一个用于整型标题的值。SetStatus方法设置一个状态码并可包括一串表示状态信息的附加参数。

SipSession接口包括下列方法。public long getCreationTime()；public String getId()；public long getLastAccesscdTime()；public int getMaxInactiveInterval()；public Object getValue(String name)；public String[]getValueNames()；public void invalidate()；public boolean isNew()；public void putValue(String name，Object value)；public void removeValue(String name)；public void setMaxInactiveInterval(int interval)；

GetCreation Time方法返回一个会话的建立时间。建立时间信息从会话描述对象中获取。GetId方法然后一个会话ID。GetLastAccessedTime方法返回最近被访问会话的有关信息。GetMaxInactiveInterval方法返回会话激活的最大周期时间。GetValue方法返回一个给定命名属性的值。GetValue names方法返回在会话描述对象中值的名字。Invalidate方法表示会话，isNew方法返回一个布尔值表示会话是否以最新的方式建立。PutValue方法为一个给定属性建立一个值。RemoveValue方法删除一个值，setMaxInactiveInterval方法为非活动间隔属性建立一个值。

SipSessionBindingListener接口形式上按如下定义。public void valueBound(SipSessionBindingEvent event)；public void valueUnbound(SipSessionBindingEvent event.

SipSessionBindingListener接口扩展javax.serlet包的EventListener接口。该接口主要使一个对象被一个会话绑定和去绑定时被通知到。

如上所述，小应用程序SIP包带有多个对象。该SIP小应用程序对象更正式地定义如下：

  public SipServlet()；
  protected void doInvite(SipServletRequest req，SipServletResponse resp)

　　throws ServletException，IOException；
  protected long getLastModified(SipServletRequest req)；
  protected void doAck(SipServletRequest req，SipServletResponse resp)

　　throws ServletException，IOException；
  protected void do Bye(SipServletRequest req，SipServletResponse resp)

　　throws ServletException，IOException；
  protected void doCancel(SipServletRequest req，SipServlctResponse resp)
  throws ServletException，IOException；
protected void do Register(SipServletRequest req，SipServletResponse resp)
  throws ServletException，IOException；
protected void doOptions(SipServletRequest req，SipServletResponse resp)
  throws ServletException，IOException；
protected void service(SipServletRequest req，SipServletResponse resp)
  throws ServletException，IOException；
public void service(ServletRequest req，ServletResponse resp)
  throws ServletException，IOException；

此对象具有若干用于处理各类请求的方法。例如，doInvite方法用于处理INVITE请求。Similar方法也被提供用于ACK，BYE，CANCEL，REGISTER和OPTIONS请求。如上所述服务请求提供一个默认服务。

MediaDescription对象由如下定义：public class MediaDescriptionprotected String name；protected String address；protected String title；protected String connectionInfo；protected String bandwidthInfo；protected String encriptionKey；protected String duration；protected String mediaAttributes；public MediaDeseription()；

它包括用于媒体的名字，地址和标题属性。另外，连接信息和带宽信息包含于此。加密密钥可被包含在mediadescription对象中，并且表明包括在媒体中的持续时间的持续时间信息也包含在内。媒体属性可被包含在这里。

SessionDescription对象类由如下定义。protected String version；protected String owner；protected String name；protected String sessionInfoprotected String URI；protected String email；protected String phone；protected String connectionInfo；protected String bandwidthInfo；protected Vector sessionAttrib；protected String duration；protected String schedule；public SessionDescription()；

Session description对象保存一个特定会话的有关描述信息。其属性包括版本属性，所有人属性和名字属性。其属性还可包含会话信息和一个URL电子邮件信息及可被存储为属性的电话信息。连接信息和带宽信息可被包含为属性。持续时间和时间表信息可作为属性被包含进去并且会话属性的一个矢量也可被包含于此。

虽然本发明参考一个示例性实施例已被描述，但本领域的技术人员将意识到所进行的各种形式和细节的变化并不背离所附权利要求中定义的预期范围。

Claims

1.在一个数据处理设备中，一种方法，包括步骤：

提供一个会话初始化协议(SIP)小服务程序；并

运行SIP小服务程序实现电话服务逻辑。

2.权利要求1的方法，其中数据处理设备是一个SIP服务器。

3.权利要求1的方法，其中作为电话服务逻辑的一部分，SIP小服务程序检查一个SIP信息。

4.权利要求1的方法，其中，作为电话服务逻辑的一部分，SIP小服务程序处理一个SIP邀请。

5.权利要求1的方法，其中，作为电话服务逻辑的一部分，SIP小服务程序处理SIP请求。

6.权利要求1的方法，其中，作为电话服务逻辑的一部分，SIP小服务程序处理SIP响应。

7.权利要求1的方法，其中，数据处理设备是支持Internet协议(IP)网络的一部分。

8.权利要求1的方法，其中，数据处理设备是Internet的一部分。

9.权利要求1的方法，其中，电话服务逻辑是呼叫转发逻辑。

10.权利要求1的方法，其中，电话服务逻辑是呼叫屏蔽逻辑。

11.在计算环境中，一种方法，包括步骤：

提供小服务程序；

提供一个用于管理小服务程序的小服务程序管理器

接收一个与会话初始化协议一致的消息；

使用小服务程序管理器，决定小服务程序中所选的一个用于处理消息；以及

使用选择的小服务程序处理消息。

12.权利要求11的方法，其中处理消息的步骤包括给一个目的地转发消息。

13.权利要求11的方法，其中处理消息的步骤包括更改消息。

14.权利要求11的方法，其中处理消息的步骤包括处理SIP请求。

15.权利要求11的方法，其中处理消息的步骤包括处理SIP响应。

16.一种带有由处理装置执行一个包括以下步骤的方法的指令的媒体：

提供一个会话初始化协议(SIP)小服务程序；并且

运行SIP小服务程序以实现电话服务逻辑。

17.权利要求16的媒体，其中，作为电话服务逻辑的一部分，SIP小服务程序检查一个SIP消息。

18.权利要求16的媒体，其中，作为电话服务逻辑的一部分，SIP小服务程序处理一个SIP请求。

19.权利要求16的媒体，其中，电话服务逻辑是呼叫转发逻辑。

20.权利要求16的媒体，其中，电话服务逻辑是呼叫屏蔽逻辑。

21.一种电子装置，包括：

一个用于接收会话初始化协议(SIP)信息的接口；及

一个用于处理SIP信息以实现电话服务逻辑的小服务程序。

22.权利要求21的装置，其中，该装置是一个计算机系统。

23.权利要求21的装置，还包括用于提供附加电话服务逻辑的附加小服务程序。

24.权利要求21的装置，其中该装置接收附加SIP信息并且其中该装置还包括用于处理附加SIP信息的附加小服务程序。

25.权利要求24的装置，其中该装置还包括一个小服务程序管理器，用于对每个附加SIP信息，决定小服务程序中的哪个来处理信息。