SIP Servlet 概述及范例

原创 2006年06月14日 15:20:00
SIP Servlets规范(JSR116, Java Community Process), 提供了一系列的Java API和一个基于容器(Container)/应用服务器(Application Server)的开发模型, 用于提高服务器端SIP应用的开发效率.
 
SIP Servlets同样基于Java Servlet架构, 其API归属于javax.servlet.sip包, 和javax.servlet.http同样扩展自javax.servlet. 不同的是, HTTP Servlets通过Servlet架构实现了HTTP协议, 而SIP Servlet实现了SIP协议.

通过SIP Servlets, 开发人员可以非常简单的开发出复杂的SIP应用程序, 就像HTTP servlets在WEB应用开发中起到的作用一样.
 
一组SIP Servlets连同资源和部署描述文件打包后部署并运行在一个容器或SIP应用服务器上的. 容器提供了例如会话状态管理, 事务管理, 重发, 网络连接, 消息调度, 线程管理, 资源管理, 应用程序管理等服务. 应用程序中只需包含高级的消息处理和业务逻辑, 开发人员不再需要在协议本身上投入过多精力, 这使SIP服务的开发成为一件轻而易举的事情.

下面对HTTP serlvet和SIP servlet做了一点比较:

  HTTP SIP
Servlet class HttpServlet SipServlet
Session               HttpSession SipSession
Application package war sar
Deployment Descriptor web.xml sip.xml

SIP serlvets继承自javax.servlet.sip.SipServlet, 这个类同HttpServlet一样, 继承自javax.servlet.GenericServlet. SipServlet通过重写的service(ServletRequest request,
ServletResponse response)方法来处理不同的SIP消息.

由于SIP协议是异步的, 所以service方法每次调用时, 其两个参数中只有一个是有效的, 而另一个是null, 例如, 如果收到的SIP消息是一个request, 那么第一个request参数有效, 而response参数为null, 反之亦然.
SipSerlvet中service方法的默认实现是把SIP消息交给不同的子方法处理. 对请求来说, 是doXXX()方法, 对响应来说是doXXXResponse()方法. 例如, doInvite(SipServletRequest request)方法处理INVITE请求, doSuccessResponse(SipServletResponse response) 处理所有的2XX响应. 通常, 通过重写SipSerlvet类的这些doXXX(), doXXXResponse()方法, 来实现SIP应用的业务逻辑.

创建响应:
在doXXX(SipServletRequest request)中, 可以通过调用javax.servlet.sip.SipServletRequest类的createResponse()方法来创建一个响应, 随后, 调用这个响应的send()方法,将其发送出去.

创建请求:
在一个SIP Servlet中创建一个请求有两种方式, SipSession类的createRequest()方法用于在已经建立的一个会话中创建请求, 创建的请求属于这个已经存在的SipSession. 另一种方法是
javax.servlet.sip.SipFactory类的createRequest()方法. SipFactory是SIP Servlet API中提供的一个工厂接口, 用于创建Request, Address, URI, Applicaiton session对象, 它的具体实现是由容器提供的, 在SIP Servlet中, 只需要通过ServletContext类的getAttribute("javax.servlet.sip.SipFactory”) 就可以获得一个SipFactory实例。
 
 
下面是一个具体的例子:
这个例子是一简单的"Echo"应用, 它接收Windows Messenger发送的Instant Message消息, 再将收到的消息发送回Windows Messenger。
 
package blog.sample.sipservlet;
import java.io.IOException;
import java.util.HashMap;
import javax.servlet.*;
import javax.servlet.sip.*;

/**
* EchoServlet provides a simple example of a SIP servlet.
* EchoServlet echoes instant messages sent by Windows Messenger.
*/
public class EchoServlet extends SipServlet {

  /**
  * _address keeps the mapping between sign-in name and actual contact address.
  */
  protected HashMap _addresses = new HashMap();
 
  /**
  * Invoked for SIP INVITE requests, which are sent by Windows Messenger
  * to establish a chat session.
  */
  protected void doInvite(SipServletRequest req)
      throws IOException, ServletException {
    // we accept invitation for a new session by returning 200 OK response
    req.createResponse(SipServletResponse.SC_OK).send();
  }

  /**
  * Invoked for SIP REGISTER requests, which are sent by Windows Messenger
  * for sign-in and sign-off.
  */
  protected void doRegister(SipServletRequest req)
      throws IOException, ServletException {
    String aor = req.getFrom().getURI().toString().toLowerCase();
    synchronized (_addresses) {
    // the non-zero value of Expires header indicates a sign-in.
      if (req.getExpires() != 0) {
      // keep the name/address mapping
      _addresses.put(aor, req.getAddressHeader("Contact").getURI());
      }
      // the zero value of Expires header indicates a sign-off.
      else {
      // remove the name/address mapping
      _addresses.remove(aor);
      }
    }
    // we accept the sign-in or sign-off by returning 200 OK response
    req.createResponse(SipServletResponse.SC_OK).send();
  }

  /**
  * Invoked for SIP MESSAGE requests, which are sent by Windows Messenger
  * for instant messages.
  */
  protected void doMessage(SipServletRequest req)
      throws IOException, ServletException {
    SipURI uri = null;
    synchronized (_addresses) {
    // get the previous registered address for the sender
      uri = (SipURI) _addresses.get(req.getFrom().getURI().toString().toLowerCase());
    }
    if (uri == null) {
      // reject the message if it is not from a registered user
      req.createResponse(SipServletResponse.SC_FORBIDDEN).send();
      return;
    }
    // we accept the instant message by returning 200 OK response.
    req.createResponse(SipServletResponse.SC_OK).send();
    // create an echo SIP MESSAGE request with the same content
    SipServletRequest echo = req.getSession().createRequest("MESSAGE");
    String charset = req.getCharacterEncoding();
    if (charset != null) {
      echo.setCharacterEncoding(charset);
    }
    echo.setRequestURI(uri);
    echo.setContent(req.getContent(), req.getContentType());
    // send the echo MESSAGE request back to Windows Messenger
    echo.send();
  }

  /**
  * Invoked for SIP 2xx class responses.
  */
  protected void doSuccessResponse(SipServletResponse resp)
      throws IOException, ServletException {
    // print out when the echo message was accepted.
    if (resp.getMethod().equalsIgnoreCase("MESSAGE")) {
      System.out.println("/"" + resp.getRequest().getContent()
        + "/" was accepted: " + resp.getStatus());
    }
  }
 
  /**
  * Invoked for SIP 4xx-6xx class responses
  */
  protected void doErrorResponse(SipServletResponse resp)
      throws IOException, ServletException {
    // print out when the echo message was rejected/
    if (resp.getMethod().equalsIgnoreCase("MESSAGE")) {
      System.out.println("/"" + resp.getRequest().getContent()
        + "/" was rejected: " + resp.getStatus());
    }
  }

  /**
  * Invoked for SIP BYE requests, which are sent by Windows Messenger
  * to terminate a  chat session/
  */
  protected void doBye(SipServletRequest req)
      throws IOException, ServletException {
    // accept session termination by returning 200 OK response.
    req.createResponse(SipServletResponse.SC_OK).send();
  }
}
 
EchoServlet的呼叫流程如图:
Message flow between Windows Messenger and EchoServlet
编译EchoServlet需要servlet.jar和sipservlet.jar这两个jar文件在classpath中. sipservlet.jar可以在JSR116的发布包中找到.
 
和HTTP Servlet应用一样, SIP Servlet应用同样需要一个部署描述文件-sip.xml. 下面是一个sip.xml的例子:
 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sip-app
PUBLIC "-//Java Community Process//DTD SIP Application 1.0//EN"
"
http://www.jcp.org/dtd/sip-app_1_0.dtd">

<sip-app>
  <display-name>SIP Servlet Sample</display-name>
  <servlet>
    <servlet-name>echo</servlet-name>
    <servlet-class>com.micromethod.sample.EchoServlet</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>echo</servlet-name>
    <pattern>
      <or>
        <equal><var>request.method</var><value>REGISTER</value></equal>
        <equal><var>request.method</var><value>INVITE</value></equal>
      </or>
    </pattern>
  </servlet-mapping>
</sip-app>
 
明显和web.xml不同的就是用and, or, not, equal, exists, contains, subdomain-of这一系列标签代替了url-pattern. 通过这些标签的组合嵌套,形成了一个条件表达式,表明相应的servlet可以处理哪些SIP消息.
 
上面的sip.xml就表明了EchoServlet可以处理REGISTER和INVITE请求. 注意的是, 请求的类型指的是创建会话的请求, 会话后续请求不再做这种条件判断,例如INVITE创建会话后,会话内的ACK, CANCEL, MESSAGE, BYE等消息会直接被判定为由接收INVITE请求的servlet处理。
 
为了方便部署, 需要将EchoServlet和sip.xml放入一个部署包中. 和HTTP Servlet应用类似, SIP Servlet应用使用SIP application archive (SAR). SAR文件其实就是JAR文件, 它的内部目录结构和WAR文件相同:
.../WEB-INF
   |-- classes
   | |-- blog
   |   |-- sample
   |     |-- sipservlet
   |       |-- EchoServlet.class
   |-- sip.xml
 
在上级目录执行jar cv0f echo.sar创建sar文件.
 
最后需要做的就是部署echo.sar, 目前提供SIP应用服务器免费下载的的似乎只有BEA和Micromethod, BEA的Weblogic SIP Server是基于它的Web Server实现的, 和J2EE结合比较紧密, 但相应配置运行较为复杂, Micromethod的SIPMethod Application Server相比之下是一个轻量级的产品, 配置部署运行都比较简洁,同时还提供一个方便开发SIP应用的Application Creation Environment和一些基于SIP Servlet技术的完整SIP基础应用,如Proxy Server, Presence Server等, 因此, 比较适合学习和开发使用. 可以从http://www.micromethod.comhttp://cn.micromethod.com下载.
 
本文中使用的就是Micromethod的SIPMethod Application Server, 下载安装后,将echo.sar拷贝到SIPMethod AS的sipapps目录, 最好把sipapps目录下其它的sar文件都删除,以免EchoServlet的servlet-mapping和其它应用中的servlet冲突. 接下来, 执行SIPMethod的bin目录下的startup.bat运行服务器, 在服务器启动过程中,echo.sar就会被解开.
 
通常情况下, 运行SIPMethod AS甚至不需要额外配置, 使用它的默认配置就可以运行, 高级的配置方式可以参考它的user-guide. 常见的问题是端口冲突, SIPMethod AS默认需要占用TCP5060, TCP8080, TCP47492, UDP5060这四个端口.
 
当SIPMethod Application Server启动完成后, 就可以用Windows Messenger看效果了.
 
Windows Messenger的需要5.0或更高, 低于这个版本的WM没有SIP功能.
 
运行Windows Messenger, 依照下面的步骤进行配置:
1. 打开"Options"对话框 Tools->Options;
2. 点击"Options"对话框中的"Account"标签;
3. 选中"My contacts include users of a SIP Communications Service"复选框;
4. 在"Sign-in name"编辑框中输入一个SIP URI, 例如
kyle@micromethod.com;
Configure SIP account in Windows Messenger
5. 点击"Advanced..."按钮打开"SIP Communications Service Connection Configuration"对话框;
6. 选中"Configure settings"单选按钮;
7. 在"Server name or IP address"编辑框中输入运行SIPMethod AS的机器IP地址, 例如192.168.0.101, 或192.168.0.101:5060, 5060是SIPMethod 默认的SIP监听端口;
8. 选择使用的传输协议, 通常是TCP或UDP, TLS需要服务器进行额外配置.
Configure SIP connection in Windows Messenger
配置完成后, 就可以登陆Windows Messenger了, 使用的登陆名就是刚才输入的SIP URI, 例如kyle@micromethod.com.
 
确保SIPMethod Applicaiton Server是运行的.
 
接下来选择"Actions->Send an Instant Message…"菜单项, 打开"Send an Instant Message"对话框, 选中对话框的Other标签, 在编辑框中输入echo@micromethod.com, 点击OK. (实际上在这个输入echo或是其它任何字符都可以, 因为我们在servlet-mapping中并没有对request.to或request.uri进行任何限制).
start a SIP chat session in Windows Messenger
 
在打开的Instant message窗口中, 就可以和EchoServlet对话了.
Chatting with EchoServlet in Windows Messenger
 
 
版权声明:本文为博主原创文章,未经博主允许不得转载。

相关文章推荐

SIP Servlet入门教程及例子

作为一个SIP Servlet Tutorial,这个文档主要描述了在JavaEE平台下如何开发基于SIP协议的应用服务。当然这个教程也包含了如何将JavaEE技术与SIP应用程序集成。这个教程主要涉...

SIP Servlet开发环境配置

看着标题挺大,着实因为本人的文采太差,不知道如何去加这个标题,所以就这么随便一写。其实我这篇文章是有所指和所限的,他就是限制在由Mobicents和Apache两位老大所出的mss-x.x.x-apa...

SipServlet入门例子

SipServlet使得开发Sip程序大大简化,且其HttpServlet的同根性使得对Sip协议不是很熟悉的人也能够很快上手.下面给出一个简单的例子:/* *  wgb *  创建于 2007-1-...

SIP协议浅析(RFC3261)

首先,和所有的blog写法一样,总得大致介绍一下SIP协议到底能干什么吧。否则到最后连自己都不知道他是干什么的了(当然这是不可能的了)     SIP是一个应用层的控制协议,可以用来建立、修改和终止多...

SIP Servlet 概述及范例

SIP Servlets规范(JSR116,Java Community Process), 提供了一系列的Java API和一个基于容器(Container)/应用服务器(Application S...

SIP Servlet 编程模型

http://www.oracle.com/technetwork/cn/topics/entarch/sip-programming-model2-087741-zhs.html SI...

SIP Servlet板块开篇语

SIP Servlet类似于我们最常见的Http Servlet,通俗理解就是Sip Servlet是解析SIP协议的驻守在容器中的一个模块,就像Http Servlet是驻守在容器中解析Http一样...

SIP Servlet开发实例讲解

这篇博文的开发实例是必须基于前面一篇“SIP Servlet开发环境配置”,如果没有正确配置SIP Servlet开发环境的,请参考“SIP Servlet开发环境配置”篇。       首先,我们基...

eclipse mobicents 插件安装

http://mobicents.googlecode.com/svn/downloads/sip-servlets-eclipse-update-site

基于RTP的多媒体通信的监控/发布的设计与实现

基于RTP的多媒体通信的监控/发布的设计与实现  为实现对多媒体通信的监听,首先要能够捕获到媒体流的数据包,并剔除掉无效的信息,保留有用的信息,然后根据通信协议对有效信息做进一步的解析。  1 协议原...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:深度学习:神经网络中的前向传播和反向传播算法推导
举报原因:
原因补充:

(最多只允许输入30个字)