Converged Http Sessions in SailFin

HttpSessionßàSipSession

（1）HttpSessionàSipSession的方法：

  import javax.servlet.sip.ConvergedHttpSession;

  import javax.servlet.sip.SipApplicationSession;

  import javax.servlet.sip.SipSession;



  ConvergedHttpSession chs = (ConvergedHttpSession) httpReq.getSession();

  SipApplicationSession sas = chs.getApplicationSession();

  Iterator sipSessions = sas.getSessions("SIP");


（2）HttpSessionßSipSession的方法：

目前，还没有找到明确讲解SipSessionàHttpSession的理论方法或示例代码。是不是可以这样：如果已知某SipApplicationSession是converged的，则执行以下代码找到HTTP Session。

个人想法。

  SipSession ss = sipReq.getSession();

  SipApplicationSession sas = ss.getApplicationSession();

  Iterator httpSessions = sas.getSessions("HTTP");


   
    use case

举例的聚合应用包含一个HTTP Servlet（ClickToDialServlet）和一个SIP Servlet（CallServlet），下面主要针对HTTP Servlet进行说明，因为它与ConvergedHttpSession的使用相关。

ClickToDialServlet允许初始化和结束一个SIP呼叫。示例代码如下：



@Resource(mappedName = "sip/convergedapp")

  private SipFactory sipFactory;



  public class ClickToDialServlet extends HttpServlet {



      public void doGet(HttpServletRequest httpReq, HttpServletResponse httpRes)

            throws ServletException, IOException {



          // 初始化或结束一个SIP呼叫，取决于请求参数"action"的值

          String action = httpReq.getParameter("action");

          if (action.equals("call")) {

              initiateSipCall(httpReq, httpRes);

          } else if (action.equals("bye")) {

              terminateSipCall(httpReq, httpRes);

          } else {

              throw new ServletException("Invalid action");

          }

      }



      [...]

  }



/**

   * 初始化一个SIP call

   */

  private void initiateSipCall(HttpServletRequest httpReq, HttpServletResponse httpRes) throws ServletException, IOException {



      // 由一个HTTP请求生成一个新的ConvergedHttpSession

      ConvergedHttpSession chs = (ConvergedHttpSession) httpReq.getSession();



      // 由ConvergedHttpSession生成一个新的SipApplicationSession，并将二者关联起来。

      SipApplicationSession sas = chs.getApplicationSession();



      // 生成SIP URI

      String localIp = InetAddress.getLocalHost().getAddress().toString();

      Address fromAddr = sipFactory.createAddress("sip:foo@" + localIp + ":" + System.getProperty("SIP_PORT"));

      Address toAddr = sipFactory.createAddress("sip:bar@" + httpReq.getParameter("remoteIp") + ":" + httpReq.getParameter("remotePort"));



      // 生成SIP INVITE请求，此处请求是与SipApplicationSession相关的。

      SipServletRequest sipReq = sipFactory.createRequest(sas, "INVITE", fromAddr, toAddr);



      // 由SIP请求生成一个SipSession

      SipSession sipSession = sipReq.getSession();



      // 所有与新的SipSession相关的请求和响应都将交由聚合应用的CallServlet来处理

      sipSession.setHandler("CallServlet");



      // 将SipSession的id作为一个session属性"CallId"存储到SipApplicationSession中，从而保证稍后可以找到SipSession，结束呼叫。

      sas.setAttribute("CallId", sipSession.getId());



      // 发送请求

      sipReq.send();



      // 返回一个用于结束呼叫的web form

      PrintWriter out = httpRes.getWriter();

      out.println("<form action=\"ClickToDialServlet\" method=\"GET\">");

      out.println("<input type=\"hidden\" name=\"action\" value=\"bye\"/>");

      out.println("<input type=\"submit\" value=\"Terminate call\"/>");

      out.println("</form>");

  }



  /**

   * 结束一个SIP call.

   */

  private void terminateSipCall(HttpServletRequest httpReq, HttpServletResponse httpRes) throws ServletException, IOException {



      // 维护ConvergedHttpSession，根据与请求一起发送的JSESSIONID cookie进行识别

      ConvergedHttpSession chs = (ConvergedHttpSession) httpReq.getSession(false);



      // 得到SipApplicationSession

      SipApplicationSession sas = chs.getApplicationSession();



      // 得到"CallId"属性对应的SipSession

      SipSession sipSession = sas.getSipSession((String) sas.getAttribute("CallId"));



      // 发送BYE请求结束呼叫

      sipSession.createRequest("BYE").send();

  }



参考：http://blogs.sun.com/jluehe/entry/converged_http_sessions_in_sailfin