Eclipse Mobicents

Mobicents Eclipse:

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

什么是SIP Servlets？
SIP Servlet 是一个 基于Java 语言的 server-side 组件，就类似于Java Servlet 一样，只不过SIP Servlet 需要运行在 SIP Servlet 容器中。
而且SIP Servlet主要用来处理SIP请求，而Servlet用来处理HTTP请求。
HTTP Servlet 与 SIP Servlet的不同之处：

1. HTTP Servlet 都会有一个context对象，也就是每个Servlet都有一个上下文的概念。而SIP Servlet没有。
2. HTTP Servlet 通常会返回一个HTML 页面或者某种形式的字符串（比如JSON），而SIP请求通常只是起到连接服务器与客户端的作用。
3. SIP 是一个P2P的协议，所以服务器端同样可以向客户端发送SIP请求。
4. SIP Servlet通常只是扮演一个代理的角色，最终的请求（客户端的请求）会发送到另一个已注册的SIP客户端。而HTTP Servlet会返回给客户端一个HTTP response。
5. SIP协议类似于长连接，但是一个无状态的链接，所以它可以返回个客户端多个相互独立的response，而HTTP是一个无状态的协议，一个Request对一个Response。
6. SIP 请求可以是一个异步的请求。这一点取决于上一个特性。

关于SIP Servlet的annotation。
Annotation 描述
@SipServlet 标示这是一个SIP Servlet
@SipListener 标示这个一个Sip Listener
@SipApplication 用来定义一组SIP Servlets
@SipApplicationKey 为一个SIP请求或者一个SIP session分配一个SipApplicationSession
比如：

1. @SipServlet
2. public class MyServlet extends SipServlet{
4. }

@SipServlet public class MyServlet extends SipServlet{ … }

@SipApplication 这个注释一般都用在包上。
比如




1. @SipApplication(name=”MySipApp”)Package com.example.sip;

@SipApplication(name=”MySipApp”)Package com.example.sip;

而@SipApplicationKey这个注释需要使用在方法上，而且这个方法需要满足以下条件：
1. Public method
2. Static method
3. Return a String
4. 方法的参数必须是SipServletRequest 类型
5. 传入的参数不可变
例如：




1. @SipApplication(name=”MySipApp”)
2. Package com.example.sip;
3. public class MySipApp{
4. @SipApplicationKey
5. public static String sessionKey(SipServletRequest request){
6. Return hash(request.getRequestURI()+getDomain(request.getForm()));
7. }
8. }

@SipApplication(name=”MySipApp”) Package com.example.sip; public class MySipApp{ @SipApplicationKey public static String sessionKey(SipServletRequest request){ Return hash(request.getRequestURI()+getDomain(request.getForm())); } }

在一个Sip application中只能有一个SipApplicationKey。
SIP Factory
SIP Factory 是一个Servlet Factory，也就是说所有的SIP请求进入SIP容器后，都要通过SIP Factory来创建一个Servlet实例。所以SIP Factory是整个SIP容器的入口。如果想调用容器中的其他资源，可以通过SIP Factory来调用。而调用的方法包括依赖注入和”查找”两种方式。
看例子：




1. //通过注释来调用
2. @Resource
3. SipFactory sf;
4. //通过查找的方式
5. SipFactory sf=(SipFactory)getServletContext().getAttribute(“javax.servlet.sip.SipFactory”);

//通过注释来调用 @Resource SipFactory sf; //通过查找的方式 SipFactory sf=(SipFactory)getServletContext().getAttribute(“javax.servlet.sip.SipFactory”);

SIP Session
SIP协议是一个无状态协议，所以一个response只能对应一个request（虽然一个request可以对应多个response）。也就是说多个request之间无法共享数据。
但是SIP Session提供了一种比较便捷的方式，用来存储request之间的共享数据。而这种方式非常类似于HTTP servlet中的Session对象。
但是与HTTP Session不同的是，在SIP应用中还有一个SIP ApplicationSession对象，这个东西很强大，它可以关于整个应用的session信息。
除此之外，还有个SipSessionUtil可以使用。使用方法和SIP Factory类似：

1. @Resource
2. SipSessionUtil sessionUtil;
3. //或者
4. SipSessionUtil sessionUtil=(SipSessionUtil)getServletContext().getAttribute(“javax.servlet.sip.SipSessionUtil”);

@Resource SipSessionUtil sessionUtil; //或者 SipSessionUtil sessionUtil=(SipSessionUtil)getServletContext().getAttribute(“javax.servlet.sip.SipSessionUtil”);

SIP Listeners
SIP application Listeners 就是用来监听SIP相关事件的Java Servlet listeners。它需要实现SIPServletListener接口。同时在其类上标注上Annotation用于简化部署。
比如：




1. @SipListener
2. Public class MyListener implements SipServletListener{
3. …..
4. }

@SipListener Public class MyListener implements SipServletListener{ ….. }



Back-to-Back User Agent Applications
一个back-to-back user agent(B2BUA)本身就是一个应用程序，同时它还是一个工具，很类似于代理。用于将一个客户端请求，转发给另一个客户端。而javax.servlet.sip.B2buaHelper就是一个实现这种功能的帮助类。

以上内容翻译自SUN的SIP Servlet Tutorial文档。
下面是我自己写的一个简单的sip程序。


1. package com.ohacker.sip.proxy;
2. import java.io.IOException;
3. import java.util.ArrayList;
4. import javax.servlet.ServletException;
5. import javax.servlet.sip.*;
6. import javax.servlet.sip.Address;
7. /**
8. *
9. * @author O!Hacker
10. */
11. @javax.servlet.sip.annotation.SipServlet
12. public class RegistratorServlet extends javax.servlet.sip.SipServlet {
13. public static ArrayList<Address> CLIENT_LIST=new ArrayList<Address>();
14.
15. @Override
16. protected void doInvite(SipServletRequest req) throws ServletException, IOException {
17. System.err.println("doInvite action: "+ req.getCallId());
18. Proxy proxy=req.getProxy();
19. System.err.println(req.getTo().getURI().toString());
20. proxy.proxyTo(req.getTo().getURI());
21. }
22.
23. @Override
24. protected void doRegister(SipServletRequest req) throws ServletException, IOException {
25. System.err.println("doRegister action: "+ req.getCallId());
26. System.err.println("doRegister action: "+ req.getRequestURI());
27. SipServletResponse resp=null;
28. Address address=req.getTo();
29. if(!RegistratorServlet.CLIENT_LIST.contains(address)){
30. CLIENT_LIST.add(address);
31. }
32. System.err.println(CLIENT_LIST.size());
33. resp=req.createResponse(SipServletResponse.SC_OK);
34. resp.send();
35. }
36. }