[LCS]深入了解SipSnoop—事件篇

write by PanQi@Ultrapower 

摘要：SipSnoop用于监听Response和Request的SIP消息，是LCS2005自带的一款非常酷的应用程序，虽不及Ethereal强大，但也足以满足一般监听，本文将对其核心方法进行分析。

l         知识点：

       [MSPL] 内置变量 sipRequest ： sipRequest 变量包含了当前从 Live Communications Server 到应用程序的 SIP 请求消息。

       [MSPL] 内置变量 sipResponse ： sipResponse 变量包含了当前从 Live Communications Server 到应用程序的 SIP 响应消息。

       [MSPL] Dispatch 方法： Dispatch 方法为应用程序的内部的事件处理者（ event handler ）分配一个事件。如果成功转发到指定的方法则返回真，否则返回否。

      

       [Microsoft.Rtc.Sip] RequestReceivedEventArgs ： RequestReceivedEventArgs 类定义应用程序上关于到达的 SIP 请求信息。当一个请求成功的被 MSPL 消息过滤器分配时，一个包含 RequestReceivedEventArgs 对象签名的事件将被分配到指定的方法。

 

 

l         深入了解 SipSnoop

1          提出问题：

1.1         判断消息类型，针对不同消息类型分配不同的事件供给应用程序处理。

1.2         应用程序截获并处理通过 LCS 的全部 Response 、 Request 消息。

2          分析问题：

2.1         判断 SIP 消息类型是通过 MSPL 的内置变量 sipRequest 、 sipResponse 来完成。然后用 MSPL 的 Dispatch 方法分配不同的事件给托管代码来进行下一步处理。

2.2         托管代码应用程序在处理 MSPL 分配的事件里实例化 Response 类和 Resquest 类，通过这两个对象可获取通过 LCS 的全部请求、响应消息。

3          解决方案：

SIP 共有六种请求方法，分别是： INVITE （邀请） ;ACK （确认） ;OPTIONS （可选项） ;BYE （再见） ;CANCEL （取消） ;REGISTER （注册）； SipSnoop 的核心事件 RequestHandler 和 ResponseHandler 中，结合哈希表统计了通过 LCS 的 SIP 请求数量。下面针对这两个事件进行详细分析。

3.1         截获并统计 Request 消息：

3.1.1   MSPL 分配的事件，触发 RequestHandler 事件处理者，该事件处理者有一个 RequestReceivedEventArgs 对象签名，通过这个对象签名的 Request 属性截获当前通过 LCS 的 Request 消息。代码如下：

public   void  RequestHandler( object  sender, RequestReceivedEventArgs e)
{
    Request request = e.Request;
…

 

3.1.2   获取到通过 LCS 的 SIP 请求消息后进行请求方式的判断，针对不同请求方式进行不同的处理，目的就是统计计数；对 Request 消息，针对 INVITE 、 ACK 进行了单独处理计数，其它方式采用 Other 方法计数。

如果是 INVITE 的请求方式，说明该会话是首次建立，需要新建一个会话（ Session ）实例，并将会话的 States( 状态 ) 属性赋值为 Initializing ，接下来，锁定哈希表 sessionStateTable 的 SyncRoot 属性，确保线程安全，然后为哈希表 sessionStateTable 的 callIdHeader.Value 赋值。代码如下：

if  (request.StandardMethod  ==  Request.StandardMethodType.Invite)
{      
 
/**////extract the call-id and create session state
Header callIdHeader = request.AllHeaders.FindFirst("Call-ID");
 
    if (callIdHeader != null)
    {
        Session newSession = new Session();
        newSession.State = Session.States.Initializing;
                                          
        lock (sessionStateTable.SyncRoot)
        {
            sessionStateTable[callIdHeader.Value] = newSession;
        }
    }
}  

如果请求方式为 ACK ，说明是确认请求，在报头中获取 Call-ID ，依靠得到的 Call-ID ，在哈希表 sessionStateTable 中寻找匹配的 session ，然后进行装箱转换成 Session 对象，接下来针对 Session 对象进行判断，如果该对象不为空的话会话状态赋值为 Established ，说明会话连接已确定，执行 Update 方法， 以原子操作的形式递增指定变量 totalSessions 和 activeSessions 的值并存储结果。代码如下：

 

else   if  (request.StandardMethod  ==  Request.StandardMethodType.Ack)
{
 
                                   /**////extract the call-id and update session state, ignore errors
                                   Header callIdHeader = request.AllHeaders.FindFirst("Call-ID");
 
                                   if (callIdHeader != null)
                                   {
                                          Session session = sessionStateTable[callIdHeader.Value] as Session;
                                          if (session != null)
                                          {
                                                 session.State = Session.States.Established;
                                                 statistics.Update(true /**//* new session */);
                                          }
       }
}

Update 方法中递增指定变量的代码如下：

 

public   void  Update( bool  sessionEstablished)
                             {
                                   if (sessionEstablished)
                                   {
                                          Interlocked.Increment(ref totalSessions);
                                          Interlocked.Increment(ref activeSessions);
                                   }
                                   else
                                   {
                                          Interlocked.Decrement(ref activeSessions);
                                   }
}

如果在 Request 消息中有 INVITE 和 ACK 之外的请求方式，均采用一种方法计数，实现代码如下：

statistics.Update(request.StandardMethod);

 

3.1.3   获取完请求方式后，获取请求消息报头中的发送方和接受方，将其 Update 到哈希表 userTable 中，代码如下：

Header fromHeader  =  request.AllHeaders.FindFirst( " From " ); 
Header toHeader  =  request.AllHeaders.FindFirst( " To " ); 
  
statistics.Update(UriParser.GetUserAtHost(fromHeader.Value)); 
statistics.Update(UriParser.GetUserAtHost(toHeader.Value)); 

Update方法：

public   void  Update( string  user) 
{ 
    if  (user != null) 
    { 
        lock (userTable.SyncRoot) 
        { 
            userTable[user] = user; 
        } 
    } 
}  

 

至此，实现 Request 消息的获取及统计功能。

 

3.2         截获并统计 Response 消息：

在 SipSnoop 中 Response 消息统计中针对请求方式 Bye 进行 HashTable 的 Remove 操作，其它请求方式不采用哈希表，只计数；代码实现过程与 Request 类似，不再赘述。

 

 

 

write by PanQi@Ultrapower 

2005-6-9