• .NET PetShop和Duwamish简单介绍
• 结构简述
• Duwamish数据访问剖析
• .NET PetShop数据访问剖析
• 分析总结

Duwamish 7.0 支持两种多计算机部署方案。非分布式部署方案在一台 Web 主机上部署 Web 层、业务外观、业务规则和数据访问层，但可以在群集间复制该 Web 主机以达到负载平衡。分布式方案在单独的服务器上部署特定的组件。例如，业务外观、业务规则和数据访问层可能位于独立于 Web 主机的服务器上。在实际部署中数据库服务器通常位于单独的计算机上。

1, 非分布式部署方案

在一台 Web 主机上部署 Web 层、业务外观、业务规则和数据访问层，然后通过软件（如Application Center 2000）或硬件来实现网络场（Web Farm）内各个Web Server的负载平衡。

在本机默认安装Duwamish 7.0时，是采用非分布式部署方案。

2, 分布式部署方案

使用 .NET Framework 远程处理技术将应用程序分布到多台计算机中。简单而言，就是IIS Web Server和Application Server分离，其中Web层（包括SystemFramework和Common项目）部署在IIS Web上，BusinessFacde/BusinessRules/DataAccess层（包括SystemFramework和Common项目）一起部署在Application Server上。

Duwamish 7.0 使用 HTTP/二进制而不是 HTTP/SOAP。使用 HTTP 的决定基于要通过端口 80 上的防火墙的要求。使用二进制而不是 SOAP 的决定基于性能上的考虑。对于大的数据块，二进制的性能优于 SOAP。因此，如果要传递大的数据块（例如，数组、数据集或数据表），则使用二进制格式化程序。如果要传递小的数据块，则选择使用 SOAP 还是二进制格式化程序是无关紧要的。传递整数时两者的性能都很好。

3, 如何将Duwamish 7.0部署为基于.Net Remoting的分布式系统

下面采用Microsoft提供的Deploytool工具自动进行（其实手工也很方便）：

C:\Program Files\Microsoft Visual Studio .NET 2003\Enterprise Samples\Duwamish 7.0 CS>deploytool deploy RemoteMachine=localhost path="C:\Program Files\Microsoft Visual Studio .NET 2003\Enterprise Samples\Duwamish 7.0 CS\Duwamish7_Remote" 

在command line窗口输入上述命令行代码。

[10/29/2004 6:43:43 AM] Creating directory C:\Program Files\Microsoft Visual Studio .NET 2003\Enterprise Samples\Duwamish 7.0 CS\Duwamish7_Remote on W1MIS38

[10/29/2004 6:43:43 AM] Stopping all internet services on W1MIS38

[10/29/2004 6:43:59 AM] Deploying Duwamish7 Business Facade on W1MIS38

[10/29/2004 6:43:59 AM] Creating web site on W1MIS38

[10/29/2004 6:44:00 AM] Generating remoting configuration files

[10/29/2004 6:44:00 AM] Starting all internet services on W1MIS38

[10/29/2004 6:44:02 AM] Starting Default Web Site on W1MIS38

[10/29/2004 6:44:02 AM] Deployment successful

运行结果：

（1）在IIS创建中创建Web Application（Duwamish7_Facade），本地路径为：C:\Program Files\Microsoft Visual Studio .NET 2003\Enterprise Samples\Duwamish 7.0 CS\Duwamish7_Remote\web 作为Remote Server端，Bin目录下是BusinessFacde/BusinessRules/DataAccess层（包括SystemFramework和Common项目）DLL文件。

其中web.config文件中包含所有Remote Objects的配置，如

<wellknown mode="Singleton" type="Duwamish7.BusinessFacade.ProductSystem, Duwamish7.BusinessFacade" objectUri="ProductSystem.rem" />

（2）Web层创建remotingclient.cfg配置文件，对Application Server而言，Web层相当与Client端。

remotingclient.cfg配置文件中包含formatter的设置（binary ），选择二进制格式化程序来序列化消息，注意是出于性能的考虑。

（3）Web application加载remotingclient.cfg配置文件

Web application在global.asax文件包括如下代码，在Application_OnStart事件中加载Retmoting配置文件。

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);

}

其中前面代码ApplicationConfiguration.OnApplicationStart()是调用Duwamish7.SystemFramework.ApplicaitonConfiguration的OnApplicationStart()方法，用来初始化application root和读取web.config中的配置信息（将在《Duwamish代码分析篇》中进行具体分析）。

Duwamish是Microsoft提供一个企业级的分布式系统架构，如果开发企业级的分布式系统，可以模仿这种架构，如果是开发一些简单的系统，则完全可以简化。

以前也学习过Duwamish范例，只是发现不同时间，不同经历，有不同的体会。正如卢彦所说的一样：通过研究Duwamish示例，高手能够领悟到.Net应用架构的设计思想，低手能够学习到.Net的编程技巧，实在是老少皆宜。

因此，这里再次学习并体验一次Duwamish范例。

1，Duwamish 7.0 结构分为四个逻辑层（FROM MSDN）：

Web 层 － Presentation

Web 层为客户端提供对应用程序的访问。这一层是作为 Duwamish.sln 解决方案文件中的 Web 项目实现的。Web 层由 ASP.NET Web 窗体和代码隐藏文件组成。Web 窗体只是用 HTML 提供用户操作，而代码隐藏文件实现各种控件的事件处理。

业务外观层 － Business Facade

业务外观层为 Web 层提供处理帐户、类别浏览和购书的界面。这一层是作为 Duwamish.sln 解决方案文件中的 BusinessFacade 项目实现的。业务外观层用作隔离层，它将用户界面与各种业务功能的实现隔离开来。除了低级系统和支持功能之外，对数据库服务器的所有调用都是通过此程序集进行的。

业务规则层 － Business Rules

业务规则层是作为 Duwamish.sln 解决方案文件中的 BusinessRules 项目实现的，它包含各种业务规则和逻辑的实现。业务规则完成如客户帐户和书籍订单的验证这样的任务。

数据访问层 － Data Access

数据访问层为业务规则层提供数据服务。这一层是作为 Duwamish.sln 解决方案文件中的 DataAccess 项目实现的。

除了上述四个逻辑层外，Duwamish 7.0 还包含封装在 Duwamish.sln 解决方案文件中的 Common 项目内的共享函数。“通用”(Common) 层包含用于在各层间传递信息的数据集。Common 项目还包含 Duwamish.sln 解决方案文件中的 SystemFramework 项目内的应用程序配置和跟踪类。

2，各个逻辑层之间的关系图（FROM MSDN）及其调用Sequeance图示例：

下面是Categories.aspx web页面获取Category的Description的整个调用过程。

（1）实例化ProductSystem对象

（2）调用ProductSystem的GetCategories()方法

（3）检测参数的合法性

（4）创建Categories::DataAccess对象实例

（5）返回上述对象

（6）调用Categories::DataAccess对象的GetCategories()方法

（7）创建CategoryData::Common对象实例

（8）返回上述对象

（9）返回CategoryData::Common对象实例，该实例中已经包含了需要的数据

（10）返回CategoryData::Common对象实例给web/Client端

（11）检测数据的合法性

（12）读取并显示结果：Category的Description

SystemFramework项目包含一些application需要的配置参数，ApplicationLog日志类和ApplicationAssert参数校验类。SystemFramework项目为所有其他的项目所引用。

Common项目包含了用于在各层间传递信息的数据集，如上述的CategoryData继承System.Data.DataSet，既不是所谓的typed DataSet，也不是一般的DataSet，不过简单实用，这是基于.Net Remoting开发分布式系统用来tier与tier之间交互数据的一种方法。Common项目也被其他的项目引用，SystemFramework项目除外。

BusinessFacade项目中所有的Classes继承MarshalByRefObject class，显然是让准备将BusinessFacade tier部署为Remote Objects。不过，实际上默认这里并没有将其部署为Remote Objects，Web层仍然调用本地对象（《Duwamish部署方案篇》将分析这个问题）。

3，Summary

在开发基于.Net Framework企业级分布式系统时，上述架构值得推荐，但也并非完美无暇，实际上存在一些值得改进的地方。显然，不可能一个范例适合所有的实际情况么，要求太苛刻了。其实，Enterprise Samples中的另外一个范例Fitch and Mather 7.0，其架构和Duwamish就有些不同了。

如果是开发本地的系统，就不要模仿Duwamish架构（看看上面获取Category的Description调用过程就知道了，太费劲。），如Business Facade和Business Rules中Classes应采用fine-grained interface设计，层与层之间的交互参数也不必全部采用DataSet，适当的时候采用setter/getter就可以了，这样不仅可以提高开发效率，而且有助于提高performance, maintainability and reusability。

（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密码分析篇》进行中分析）。

继续前面的2篇POST《Duwamish架构分析篇》和《Duwamish部署方案篇》，这里在代码层次上分析Duwamish  7.0范例，主要目的是解析Duwamish范例中值得推荐的编码风格和提炼出可以重用的代码或Class。

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()方法记录错误日志。