[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)
if (request.StandardMethod == Request.StandardMethodType.Invite)

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

[align=left] [/align]

else if (request.StandardMethod == Request.StandardMethodType.Ack)
public void Update(bool sessionEstablished)
statistics.Update(request.StandardMethod);

[align=left] [/align]
[align=left]3.1.3 获取完请求方式后，获取请求消息报头中的发送方和接受方，将其Update到哈希表userTable中，代码如下： [/align]
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;
}
}
}

[align=left] [/align]

至此，实现Request消息的获取及统计功能。
[align=left] [/align]
3.2 截获并统计Response消息：
在SipSnoop中Response消息统计中针对请求方式Bye进行HashTable的Remove操作，其它请求方式不采用哈希表，只计数；代码实现过程与Request类似，不再赘述。

write by PanQi@Ultrapower
2005-6-9