我们从启动程序的部分开始分析吧。
启动的入口是 Main 函数,这个函数仅仅存在于 CassiniWebServer ,而 CassiniWebServer 继承自 Form 类,但是我们看到,该类并没有实现代码(仅仅是提供一个入口)。在 Main 函数中,仅仅有两行代码:
[STAThread]
public static int Main(String[] args) {
Application.Run(new CassiniForm(args));
return 0;
}
静态方法 Application.Run 在当前线程环境( STAThread )下启动一个 CassiniForm 的实例,启动消息循环,并且使窗体可见。
从 MSDN 上我们了解到:
Application 类具有用于启动和停止应用程序和线程以及处理 Windows 消息的方法。调用 Run 以启动当前线程上的应用程序消息循环,并可以选择使某窗体可见。调用 Exit 或 ExitThread 来停止消息循环。当您的程序在某个循环中时,调用 DoEvents 来处理消息。调用 AddMessageFilter 以向应用程序消息泵添加消息筛选器来监视 Windows 消息。 IMessageFilter 使您可以阻止引发某事件或在调用某事件处理程序前执行特殊操作。
既然分析到了 CassiniForm ,我们来看看这个继承自 Form 的类。
阅读代码我们看到:
除了一些 GUI 元素支持成员变量外,还有几个成员私有变量:
private static String _appPath; // 用于存储 asp.net 启动的应用程序物理路径
private static String _portString; //web server 监听端口号
private static String _virtRoot; // 应用程序的虚拟目录
private Cassini.Server _server; // the web server 源代码中的注释
CassiniForm 的构造函数也没有什么特别,我们看到有一个关键的 Start() ,从名字我们大致可以猜到是 web server 启动过程。仔细来看看:
private void Start()
{
_appPath = appDirTextBox.Text;
if (_appPath.Length == 0 || !Directory.Exists(_appPath)) {
ShowError("Invalid Application Directory");
appDirTextBox.SelectAll();
appDirTextBox.Focus();
return;
}
_portString = portTextBox.Text;
int portNumber = -1;
try {
portNumber = Int32.Parse(_portString);
}
catch {
}
if (portNumber <= 0) {
ShowError("Invalid Port");
portTextBox.SelectAll();
portTextBox.Focus();
return;
}
_virtRoot = vrootTextBox.Text;
if (_virtRoot.Length == 0 || !_virtRoot.StartsWith("/")) {
ShowError("Invalid Virtual Root");
vrootTextBox.SelectAll();
vrootTextBox.Focus();
return;
}
// 以上一大段都是检验参数,看看用户输入的参数是否符合要求。从这里我们也已看看软件的容错性多么重要,国外的程序员大都很重视,值得我借鉴。关键的实现在于下面的两行代码
try {
_server = new Cassini.Server(portNumber, _virtRoot, _appPath);
_server.Start();
}
// 我们可以知道在此,我们先生 new 一个 Cassini.Server 然后调用 Start 过程。出错了就报告错误。源代码中并没有 catch(Exception e) 的语句,是我为了察看错误提示信息加上去的。通过这样做,我知道编译后的程序如何执行。
catch (Exception e){
MessageBox.Show(e.ToString());
ShowError(
"Cassini Managed Web Server failed to start listening on port " + portNumber + ".\r\n" +
"Possible conflict with another Web Server on the same port.");
portTextBox.SelectAll();
portTextBox.Focus();
return;
}
startButton.Enabled = false;
appDirTextBox.Enabled = false;
portTextBox.Enabled = false;
vrootTextBox.Enabled = false;
browseLabel.Visible = true;
browseLink.Text = GetLinkText();
browseLink.Visible = true;
browseLink.Focus();
}
CassiniForm 精华差不多了。顺藤摸瓜,我们来看看 Cassini.Server 。这个类实际上就是我们整个 Cassini 的主要类。
Cassini.Server 的主要数据成员有:
private int _port; // 端口,大概是 web server 的端口
private String _virtualPath; // 虚拟目录,也就是应用程序执行的虚拟路径
private String _physicalPath; // 物理路径
private String _installPath; //
private WaitCallback _restartCallback; // 用于重新启动 host 的回调函数
private Host _host; //asp.net 应用程序的真正宿主,从名字看 J
构造函数最后调用中有:
_restartCallback = new WaitCallback(RestartCallback); // 指定一个回调函数供 Restart 时候使用。 RestartCallback 主要动作就是 CreateHost() 和 Start() ,但是需要注意是采用线程调度方式
_installPath = GetInstallPathAndConfigureAspNetIfNeeded();// 这个函数搜索注册表获取 aspnet_isapi.dll 的路径。该 dll 执行 asp.net 的基本框架功能(当然是在建立 asp.net 应用程序之后)。
CreateHost();
Start() 很简单,就是判断 hots 是否存在,并且启动 host ,看来关于 cassini.server 类重点是看看 CreateHost 是怎么回事。
private void CreateHost() {
_host = (Host)ApplicationHost.CreateApplicationHost(typeof(Host), _virtualPath, _physicalPath);
_host.Configure(this, _port, _virtualPath, _physicalPath, _installPath);
}
原来是调用 ApplicationHost 的唯一方法 CreateApplicationHost 建立一个执行 asp.net 的 appDomain 环境。
其中的 Host 是一个要在新应用程序域中创建的由用户提供的类的名称。此处是一个自定义的 cassini.Host ,是用来承载 asp.net 应用程序的。