Duwamish代码分析篇

 

 

1 ，读取配置文件类－ SystemFramework/ApplicationConfiguration.cs

ApplicationConfiguration 类用来读取 web.config 文件中自定义 section 的配置信息，初始化一些基本设置。

ApplicationConfiguration 类实现 IconfigurationSectionHandler 接口，并需要实现 [C#]

object Create(

   object parent,

   object configContext,

   XmlNode section

) 方法，以分析配置节的 XML 。返回的对象被添加到配置集合中，并通过 GetConfig 访问。

 

 

部分代码片断解释：

（ 1 ） Code Snippet 1 – ApplicationConfiguration. OnApplicationStart() 方法

public static void OnApplicationStart(String myAppPath)

{

    appRoot = myAppPath;

    System.Configuration.ConfigurationSettings.GetConfig("ApplicationConfiguration");

    System.Configuration.ConfigurationSettings.GetConfig("DuwamishConfiguration");

    System.Configuration.ConfigurationSettings.GetConfig("SourceViewer");      

}

ConfigurationSettings 类还提供了一个公共方法 ConfigurationSettings.GetConfig() 用于返回用户定义的配置节的配置设置，传入的参数 section name ，如 "ApplicationConfiguration" ，表示要读取的配置节。

 

NameValueCollection nv=new NameValueCollection();

// 实例化 NameValueCollection 类对象

nv=(NameValueCollection)ConfigurationSettings.GetConfig("ApplicationConfiguration ");

// 返回用户定义的配置节的设置

return nv["SystemFramework.Tracing.Enabled"].ToString();

// 返回特定键值，如 SystemFramework.Tracing.Enabled

 

不过， ConfigurationSettings.GetConfig() 方法在调用时，自动调用 Create() 方法，可以看到 ApplicationConfiguration.Create() 方法正是用来读取指定 section 的配置，并初始化设置参数。

 

Global.asax 的 Application_OnStart 事件处理程序向 SystemFramework 的 ApplicationConfiguration 类 OnApplicationStart 方法发出调用，正是上述的代码片断。

 

（ 2 ） Code Snippet 2 － Global.asax 中 Application_OnStart() 方法

void Application_OnStart()

{

    ApplicationConfiguration.OnApplicationStart(Context.Server.MapPath( Context.Request.ApplicationPath ));

    string configPath = Path.Combine(Context.Server.MapPath( Context.Request.ApplicationPath ),"remotingclient.cfg");

    if(File.Exists(configPath))

        RemotingConfiguration.Configure(configPath);

}

该方法肩负二大任务：（ 1 ）调用 ApplicationConfiguration.OnApplicationStart() 方法，并传入 application 的根目录（ Root Directory ）。（ 2 ）检测 Client 端的 remoting 配置文件是否存在（其实是 web server 端），如果存在，则读取并初始化 remoting 配置信息，如配置通道 Channel 等等，详见 《 Duwamish 部署方案篇 》 。

 

2 ，读取 web.config 中 Duwamish 相关的一些配置－ Common/DuwamishConfiguration.cs

Common/DuwamishConfiguration.cs 也实现 IconfigurationSectionHandler 接口，与 SystemFramework/ApplicationConfiguration.cs 类相似。

 

DuwamishConfiguration 配置节包括如下一些配置信息：

Database connection string （ Database 连接串） Duwamish.DataAccess.ConnectionString ，是否允许页面缓存 Duwamish.Web.EnablePageCache ，页面缓存过期时间 Duwamish.Web.PageCacheExpiresInSeconds ，是否允许 SSL 连接 Duwamish.Web.EnableSsl 等等。

 

如上所述，调用 DuwamishConfiguration Class 是由 SystemFramework/ApplicationConfiguration.cs 的 OnApplicationStart() 方法完成的：

System.Configuration.ConfigurationSettings.GetConfig("DuwamishConfiguration");

 

看看页面缓存配置在 web page 中如何使用的（ web/book.aspx.cs 文件为例）：

//

// If everything succeeded, then enable page caching as indicated

// by the current application configuration.

//

if ( DuwamishConfiguration.EnablePageCache )

{

    //Enable Page Caching...

    Response.Cache.SetExpires ( DateTime.Now.AddSeconds(DuwamishConfiguration.PageCacheExpiresInSeconds));

    Response.Cache.SetCacheability(HttpCacheability.Public);

}

在 Page_Load 事件中最后判断是否允许页面缓存。

 

3 ，验证数据合法性类－ SystemFramework/ApplicationAssert.cs

SystemFramework/ApplicationAssert.cs Class 用来进行错误检测，并调用 SystemFramework/ApplicationLog.cs Class 记录错误日志。

 

学习其中的部分代码片断：

（ 1 ） Code Snippet 1 – Check Method

[ConditionalAttribute("DEBUG")]

public static void Check(bool condition, String errorText, int lineNumber)

{

    if ( !condition )

    {

        String detailMessage = String.Empty;

        StringBuilder strBuilder;

        GenerateStackTrace(lineNumber, out detailMessage);

        strBuilder = new StringBuilder();

        strBuilder.Append("Assert: ").Append("/r/n").Append(errorText).Append("/r/n").Append(detailMessage);

        ApplicationLog.WriteWarning(strBuilder.ToString());

        System.Diagnostics.Debug.Fail(errorText, detailMessage);

    }

}

 

[ConditionalAttribute("DEBUG")] 定义 Check() 方法为 conditional method ，如果预处理符号（ preprocessor symbol ）没有定义， compiler 不仅忽略该方法，而且忽略对该方法的调用，和 #if DEBUG / #else / #endif 有些类似。

 

该方法用来判断条件 condition 是否为 true ，如果为 false ，则调用 SystemFramework/ApplicationLog.WriteWarning() 方法记录错误日志。

 

（ 2 ） Code Snippet 2 – CheckCondition Method

public static void CheckCondition(bool condition, String errorText, int lineNumber)

{

    //Test the condition

    if ( !condition )

    {

        //Assert and throw if the condition is not met

        String detailMessage;

        GenerateStackTrace(lineNumber, out detailMessage);

        Debug.Fail(errorText, detailMessage);

 

        throw new ApplicationException(errorText);

    }

}

 

该方法一般用来在进行前置条件判断，如 condition 为 false ，则抛出 exception 。

 

4 ， log 日志类－ SystemFramework/ApplicationLog.cs

ApplicationLog 类实现 Duwamish 7.0 中的记录和跟踪。 Web.Config 文件中的配置设置确定是输出到 EventLog 文件、跟踪日志文件还是两者。下面是 Web.Config 文件中的 <ApplicationConfiguration> 节，它指定 EventLog 设置：

 

<ApplicationConfiguration>

    <!-- Event log settings -->

    <add key="SystemFramework.EventLog.Enabled" value="True" />

    <add key="SystemFramework.EventLog.Machine" value="." />

    <add key="SystemFramework.EventLog.SourceName" value="Duwamish7" />

   

    <add key="SystemFramework.EventLog.LogLevel" value="1" />

    <!-- Use the standard TraceLevel values:

             0 = Off

             1 = Error

             2 = Warning

             3 = Info

             4 = Verbose -->

Web.Config 文件的同一节还指定跟踪配置。 Duwamish 7.0 跟踪日志的默认位置是： [ 安装 Visual Studio .NET 的驱动器号 ]:/Program Files/Microsoft Visual Studio .NET 2003/Enterprise Samples/Duwamish 7.0 CS/Web/DuwamishTrace.txt

 

在实际的应用系统开发中，用来提供 Log 功能的类应该比这个 ApplicationLog 类要好，这样就不去分析了，如 Microsoft Exception Management Application Block 就不错。

 

5 ， Web.config 配置文件－使用 Web.congfig 文件存储 application 设置

Duwamish 7.0 通过使用 Forms 身份验证来实现安全性。 Forms 身份验证将未经授权的用户重定向到 Web 窗体，该窗体提示用户输入其电子邮件地址和密码。

 

（ 1 ）配置 Forms 身份验证

Web.config 文件中的设置配置 Forms 身份验证。对于 Duwamish 7.0 ， Web.Config 文件按如下所述指定 Forms 身份验证的使用：

    <authentication mode="Forms">

      <forms name=".ADUAUTH" loginUrl="secure/logon.aspx" protection="All">

      </forms>

    </authentication>

    <authorization>

      <allow users="*" />

    </authorization>

 

authentication 元素只能在计算机、站点或应用程序级别声明。如果试图在配置文件中的子目录或页级别上进行声明，则将产生分析器错误信息。

 

如上所示， Web.Config 将 .ADUAUTH 指定为身份验证 Cookie 的名称。当用户请求受限资源时，公共语言运行库将未经授权的用户重定向到在上面的 Web.Config 设置中指定的 Login.aspx 。 protection="All" 设置指定应用程序使用数据验证和加密来保护 Cookie 。若要进一步限制资源， Duwamish 7.0 会将安全资源放置到名为 secure 的子文件夹中并使用额外的 Web.Config 文件（在 secure 文件夹），在该文件中指定只有经过身份验证的用户才可访问该子文件夹的内容。

    <authorization>

      <deny users="?" />

      <allow users="*" />

    </authorization>

 

<deny users="?" /> 标记指定拒绝对所有匿名用户的访问。 <allow users="*" /> 标签允许访问所有已验证身份的用户。

 

经过 secure/logon.aspx 认证通过的请求，重新定向最初的 URL 。

// 将已验证身份的用户重定向回最初请求的 URL 。

FormsAuthentication.RedirectFromLoginPage("*", false);

 

（ 2 ）用户定义的配置节

 <configSections>

    <section name="ApplicationConfiguration" type="Duwamish7.SystemFramework.ApplicationConfiguration, Duwamish7.SystemFramework" />

    <section name="DuwamishConfiguration" type="Duwamish7.Common.DuwamishConfiguration, Duwamish7.Common" />

    <section name="SourceViewer" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />

 </configSections>

 

section 元素包含配置节声明， name 指定配置节的名称， type 指定从配置文件中读取节的配置节处理程序类的名称。配置节处理程序 ( 即实现 IConfigurationSectionHandler 接口的类 ) 读取设置。

 

上面定义了 3 个配置节处理程序： Duwamish7.SystemFramework.ApplicationConfiguration

Duwamish7.Common.DuwamishConfiguration

System.Configuration.NameValueSectionHandler

 

前面两个配置节处理程序是由 application 提供的，后面的 System.Configuration.NameValueSectionHandler 是 .Net Framework 提供的，该类也实现了 IconfigurationSectionHandler 接口，用来提供配置节中的名称 / 值对配置信息。

 

 

6 ， web/PageBase.cs 基类

最后谈谈 web/PageBase.cs 基类吧，所有 Duwamish 7.0 中的所有 web 页都继承名为 PageBase 的基类，该类实现 Duwamish 7.0 应用程序的 ASP.Net 页中使用的常见属性和方法，这种设计方法值得推荐。

 

Code Snippet 分析：

/// <summary>

///     Handles errors that may be encountered when displaying this page.

///     <param name="e">An EventArgs that contains the event data.</param>

/// </summary>

protected override void OnError(EventArgs e)

{

    ApplicationLog.WriteError(ApplicationLog.FormatException(Server.GetLastError(), UNHANDLED_EXCEPTION));

    base.OnError(e);

}

重载 OnError 方法，使 application 遭遇到未处理错误的时候，自动调用 ApplicationLog.WriteError() 来记录错误日志。

 

另外，觉得 Duwamish 的 password 处理有些特别，是以 byte 形式存放在 Database 中，避免明文的方式，以提高安全性（将在《 Duwamish 密码分析篇 》进行中分析）。