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应用程序, 就像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, 反之亦然.
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实例。
创建响应:
在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实例。