在ASP.NET 2.0中操作數(shù)據(jù)之六十：創(chuàng)建一個自定義的Database-Driven Site Map Provider

導(dǎo)言：

　　ASP.NET 2.0的網(wǎng)站地圖(site map)功能允許頁面開發(fā)者在一些持久介質(zhì)(persistent medium),比如一個XML文件里，自己定義一個web程序的site map.一旦定義了之后，我們可以通過System.Web命名空間的SiteMap class類或某個Web導(dǎo)航控件，比如SiteMapPath, Menu, 或TreeView來對其進(jìn)行訪問。site map系統(tǒng)使用的是provider model模式，所以可以創(chuàng)建不同的site map，并將其應(yīng)用到一個web應(yīng)用程序。ASP.NET 2.0默認(rèn)的site map provider，其結(jié)構(gòu)為一個XML文件。在教程《Master Pages and Site Navigation》里我們創(chuàng)建了一個Web.sitemap文件，它就包含了這種結(jié)構(gòu)，并且在教程的每一個新部分里我們都要更新其XML.

　　當(dāng)site map的結(jié)構(gòu)是靜態(tài)的時候，默認(rèn)的這種基于XML(XML-based)的site map provider工作正常，就像本系列教程一樣。但是在很多時候我們需要動態(tài)的site map.如圖1的site map，每個種類以及屬于該種類的產(chǎn)品在網(wǎng)站的結(jié)構(gòu)里做層次狀體系分布。在該site map里，當(dāng)訪問根目錄的web頁面時，將列出所有的種類；再訪問某個具體的種類的根目錄時，將列出屬于該種類的所有產(chǎn)品；再訪問某個具體的產(chǎn)品時將列出該產(chǎn)品的詳細(xì)信息。

圖1：Categories 和 Products構(gòu)成了Site Map的層次結(jié)構(gòu)

　　這種基于category 和product的結(jié)構(gòu)可以通過"硬編碼"的方式添加到Web.sitemap文件.每當(dāng)對category 或 product進(jìn)行添加、刪除、重命名等操作時，都需要對該文件進(jìn)行更新。很自然的，如果其結(jié)構(gòu)是通過數(shù)據(jù)庫，或更理想地，是從業(yè)務(wù)邏輯層來獲取的，那么對site map的維護(hù)是很簡單的。那樣的話，只要對products 和 categories進(jìn)行添加、刪除、重命名時，site map會自動的更新以反應(yīng)這些變化。

　　由于ASP.NET 2.0的site map是建立在provider模式的基礎(chǔ)上的，因此我們可以創(chuàng)建一個自定義的site map provider，從數(shù)據(jù)庫或某個層來獲取數(shù)據(jù).在本文，我們創(chuàng)建的provider將從業(yè)務(wù)邏輯層獲取數(shù)據(jù)。讓我們開始吧！

　　注意：本文創(chuàng)建的用戶定制site map provider僅僅依賴于系統(tǒng)的層及其數(shù)據(jù)模式(data model)。Jeff Prosise的文章《Storing Site Maps in SQL Server》(http://msdn.microsoft.com/msdnmag/issues/05/06/WickedCode/)
和《The SQL Site Map Provider You've Been Waiting For》
(http://msdn.microsoft.com/msdnmag/issues/06/02/wickedcode/default.aspx)
考察了將site map數(shù)據(jù)存儲在SQL Server的方法。

第一步：創(chuàng)建用戶定制Site Map Provider頁面

在創(chuàng)建用戶定制Site Map Provider之前，先添加本章將用到的ASP.NET頁面。首先添加一個名為SiteMapProvider的文件夾；然后在文件夾里添加如下所示的頁面確保采用母版Site.master：

Default.aspx
ProductsByCategory.aspx
ProductDetails.aspx

同樣，在App_Code文件夾里添加CustomProviders

圖2：添加相關(guān)的ASP.NET頁面.

由于這部分只有一篇文章，沒有必要使Default.aspx頁面列出本部分的文章；我們將在Default.aspx里用一個GridView控件來列出categories，在第二步里探討.

然后，更新Web.sitemap使其包含對Default.aspx頁面的引用。特別的，在“Caching” siteMapNode>后面添加以下代碼：

siteMapNode
 title="Customizing the Site Map" url="~/SiteMapProvider/Default.aspx"
 description="Learn how to create a custom provider that retrieves the site map from the Northwind database." />

完成Web.sitemap的更新后，花點時間在瀏覽器里登錄頁面，在左面的菜單里包含了本教程的條目。

圖3：Site Map現(xiàn)在包含了本章的條目

　　本教程主要考察如何創(chuàng)建一個用戶自定義的site map provider，及對設(shè)置web應(yīng)用程序進(jìn)行包含該site map provider.具體來講，它返回的網(wǎng)站地圖(site map)不僅包含了根節(jié)點，而且包含每個種類節(jié)點和產(chǎn)品節(jié)點，就像圖1顯示的那樣?？偟膩碚f，網(wǎng)站地圖里的每一個節(jié)點都對應(yīng)一個具體的URL.就我們的網(wǎng)站地圖而言，根節(jié)點的URL為~/SiteMapProvider/Default.aspx，它列出了所有產(chǎn)品和種類；每個種類節(jié)點對應(yīng)的URL 為~/SiteMapProvider/ProductsByCategory.aspx?CategoryID=categoryID,它根據(jù)指定的categoryID列出該種類的所有產(chǎn)品；最后，每個產(chǎn)品對應(yīng)的URL為~/SiteMapProvider/ProductDetails.aspx?ProductID=productID, 它根據(jù)指定的productID值,列出該產(chǎn)品的詳細(xì)信息。

　　首先，讓我們創(chuàng)建Default.aspx, ProductsByCategory.aspx和ProductDetails.aspx頁面。我們將分別在第二、三、四步創(chuàng)建這些頁面.因為本文的重點是site map providers，并且這種主/從頁面在前面的教程里已經(jīng)討論過了，我們在第2到第4步將一筆帶過，如果你對這種主/從頁面頁面不是很了解的話，請參考前面的教程之9《Master/Detail Filtering Across Two Pages》.

第二步：將Categories顯示出來

　　打開文件夾SiteMapProvider里的Default.aspx頁面，在設(shè)計模式里從工具箱拖一個 GridView控件到頁面，設(shè)置其ID為Categories.從其智能標(biāo)簽里，將其綁定到一個名為CategoriesDataSource的ObjectDataSource，設(shè)置其使用CategoriesBLL類的 GetCategories方法。因為該GridView控件只是顯示categories而不修改數(shù)據(jù)，因此在UPDATE, INSERT和 DELETE標(biāo)簽里選“(None)”.

圖4：設(shè)置ObjectDataSource使用GetCategories方法返回Categories

圖5：在UPDATE, INSERT和DELETE標(biāo)簽里選“(None)”

　　設(shè)置完成后，Visual Studio會自動的添加CategoryID, CategoryName, Description, NumberOfProducts 和 BrochurePath這些綁定列(BoundField),修改GridView，使其只包含CategoryName 和 Description兩列，且將CategoryName綁定列的HeaderText屬性改為“Category”.

　　然后，添加一個HyperLinkField，將其放在最左邊，設(shè)其DataNavigateUrlFields屬性為 CategoryID；DataNavigateUrlFormatString 屬性為 ~/SiteMapProvider/ProductsByCategory.aspx?CategoryID={0}；再將Text屬性設(shè)置為“View Products”.

圖6：為GridView添加一個HyperLinkField

創(chuàng)建完ObjectDataSource并定制GridView控件的列后，這2個控件的聲明代碼看起來應(yīng)該和下面的差不多：

asp:GridView ID="Categories" runat="server" AutoGenerateColumns="False"
 DataKeyNames="CategoryID" DataSourceID="CategoriesDataSource"
 EnableViewState="False">
 Columns>
 asp:HyperLinkField DataNavigateUrlFields="CategoryID"
  DataNavigateUrlFormatString=
  "~/SiteMapProvider/ProductsByCategory.aspx?CategoryID={0}"
  Text="View Products" />
 asp:BoundField DataField="CategoryName" HeaderText="Category"
  SortExpression="CategoryName" />
 asp:BoundField DataField="Description" HeaderText="Description"
  SortExpression="Description" />
 /Columns>
/asp:GridView>

asp:ObjectDataSource ID="CategoriesDataSource" runat="server"
 OldValuesParameterFormatString="original_{0}" SelectMethod="GetCategories"
 TypeName="CategoriesBLL">/asp:ObjectDataSource>

圖7顯示的是在瀏覽器里查看的Default.aspx頁面，點某個類的“View Products”鏈接，將會轉(zhuǎn)到ProductsByCategory.aspx?CategoryID=categoryID頁面，該頁面我們將在第三步新建。

圖7：每個類都有一個“View Products”鏈接

第三步：顯示指定類的所有產(chǎn)品

　　打開ProductsByCategory.aspx頁面并添加一個GridView控件，設(shè)其ID為ProductsByCategory.從其智能標(biāo)簽，將其綁定到一個名為ProductsByCategoryDataSource的ObjectDataSource；設(shè)置它使用ProductsBLL類的 GetProductsByCategoryID(categoryID)方法；在UPDATE, INSERT,和 DELETE標(biāo)簽里選擇“(None)”.

圖8：使用ProductsBLL類的GetProductsByCategoryID(categoryID)方法

　　設(shè)置向?qū)У淖詈笠徊绞侵付╟ategoryID的參數(shù)來源，因為此信息是通過查詢字符串(querystring field)CategoryID來傳遞的，因此在參數(shù)來源里選QueryString，在QueryStringField里輸入“CategoryID”；如圖9所示，點Finish完成設(shè)置.

圖9：為參數(shù)categoryID指定CategoryID Querystring Field

　　完成設(shè)置后，Visual Studio將為GridView添加相應(yīng)的綁定列以及CheckBo列；將除ProductName, UnitPrice, SupplierName外的列刪除掉。將這3個列的HeaderText屬性分別設(shè)置為“Product”, “Price”, and “Supplier”, 將UnitPrice列格式化為貨幣形式.

　　然后，添加一個HyperLinkField列，并將其放在最左邊；設(shè)其Text屬性為“View Details”，設(shè)其DataNavigateUrlFields屬性為ProductID；其DataNavigateUrlFormatString屬性為 ~/SiteMapProvider/ProductDetails.aspx?ProductID={0}.

圖10：添加一個“View Details” HyperLinkField，以鏈接到ProductDetails.aspx

完成后，GridView和 ObjectDataSource的聲明代碼為:

asp:GridView ID="ProductsByCategory" runat="server" AutoGenerateColumns="False"
 DataKeyNames="ProductID" DataSourceID="ProductsByCategoryDataSource"
 EnableViewState="False">
 Columns>
 asp:HyperLinkField DataNavigateUrlFields="ProductID"
  DataNavigateUrlFormatString=
  "~/SiteMapProvider/ProductDetails.aspx?ProductID={0}"
  Text="View Details" />
 asp:BoundField DataField="ProductName" HeaderText="Product"
  SortExpression="ProductName" />
 asp:BoundField DataField="UnitPrice" DataFormatString="{0:c}"
  HeaderText="Price" HtmlEncode="False"
  SortExpression="UnitPrice" />
 asp:BoundField DataField="SupplierName" HeaderText="Supplier"
  ReadOnly="True" SortExpression="SupplierName" />
 /Columns>
/asp:GridView>

asp:ObjectDataSource ID="ProductsByCategoryDataSource" runat="server"
 OldValuesParameterFormatString="original_{0}"
 SelectMethod="GetProductsByCategoryID" TypeName="ProductsBLL">
 SelectParameters>
 asp:QueryStringParameter Name="categoryID"
  QueryStringField="CategoryID" Type="Int32" />
 /SelectParameters>
/asp:ObjectDataSource>

　　返回來登錄Default.aspx頁面，點Beverages(飲料)的“View Products”鏈接，這將轉(zhuǎn)到ProductsByCategory.aspx?CategoryID=1頁面，顯示飲料類的所有產(chǎn)品的names, prices, 和 suppliers信息(見圖11)。盡管改進(jìn)該頁面吧，添加一個鏈接以方便用戶返回上一頁(Default.aspx) .還可以添加一個DetailsView 或 FormView控件來顯示該種類的名稱和描述。

圖11：顯示Beverages類的Names, Prices, Suppliers信息

第四步：顯示產(chǎn)品的詳細(xì)信息

　　最后要創(chuàng)建的頁面—ProductDetails.aspx,是用來顯示指定產(chǎn)品的詳細(xì)信息的。打開ProductDetails.aspx頁面，從工具箱拖一個DetailsView控件到頁面，設(shè)置其ID為ProductInfo，并清除其Height 和 Width屬性值。在其智能標(biāo)簽里，綁定到一個名為ProductDataSource的ObjectDataSource，設(shè)置該ObjectDataSource使用ProductsBLL類的GetProductByProductID(productID)方法。在UPDATE, INSERT,和DELETE標(biāo)簽里選“(None)”.

圖12：設(shè)置該ObjectDataSource控件調(diào)用GetProductByProductID(productID)方法

　　最后，需要設(shè)置參數(shù)productID的來源，由于數(shù)據(jù)通過查詢字符串ProductID來傳遞，在參數(shù)源下拉列表里選QueryString，在QueryStringField對話框里輸入“ProductID”. 最后，點Finish按鈕完成設(shè)置。

圖13:設(shè)置參數(shù)productID來源于查詢字符串

　　完成設(shè)置后，Visual Studio會為DetailsView控件添加相應(yīng)的綁定列和CheckBox列，移除ProductID, SupplierID, 和CategoryID列，剩下的列想怎樣設(shè)就怎樣設(shè)置吧。我對界面做了些優(yōu)化，這樣的話，聲明代碼看起來像下面這樣：

asp:DetailsView ID="ProductInfo" runat="server" AutoGenerateRows="False"
 DataKeyNames="ProductID" DataSourceID="ProductDataSource"
 EnableViewState="False">
 Fields>
 asp:BoundField DataField="ProductName" HeaderText="Product"
  SortExpression="ProductName" />
 asp:BoundField DataField="CategoryName" HeaderText="Category"
  ReadOnly="True" SortExpression="CategoryName" />
 asp:BoundField DataField="SupplierName" HeaderText="Supplier"
  ReadOnly="True" SortExpression="SupplierName" />
 asp:BoundField DataField="QuantityPerUnit" HeaderText="Qty/Unit"
  SortExpression="QuantityPerUnit" />
 asp:BoundField DataField="UnitPrice" DataFormatString="{0:c}"
  HeaderText="Price" HtmlEncode="False"
  SortExpression="UnitPrice" />
 asp:BoundField DataField="UnitsInStock" HeaderText="Units In Stock"
  SortExpression="UnitsInStock" />
 asp:BoundField DataField="UnitsOnOrder" HeaderText="Units On Order"
  SortExpression="UnitsOnOrder" />
 asp:BoundField DataField="ReorderLevel" HeaderText="Reorder Level"
  SortExpression="ReorderLevel" />
 asp:CheckBoxField DataField="Discontinued" HeaderText="Discontinued"
  SortExpression="Discontinued" />
 /Fields>
/asp:DetailsView>

asp:ObjectDataSource ID="ProductDataSource" runat="server"
 OldValuesParameterFormatString="original_{0}"
 SelectMethod="GetProductByProductID" TypeName="ProductsBLL">
 SelectParameters>
 asp:QueryStringParameter Name="productID"
  QueryStringField="ProductID" Type="Int32" />
 /SelectParameters>
/asp:ObjectDataSource>

　　來對該頁面進(jìn)行測試，返回Default.aspx頁面，點種類Beverages的“View Products”鏈接；再點產(chǎn)品Chai Tea的“View Details”鏈接。這將轉(zhuǎn)到ProductDetails.aspx?ProductID=1頁面，其顯示的是Chai Tea的詳細(xì)信息(如圖14所示).

圖14：Chai Tea的Supplier, Category, Price等信息顯示出來了

第五步：理解Site Map Provider的內(nèi)部處理機(jī)制

　　site map呈現(xiàn)的是源于某種層次結(jié)構(gòu)的SiteMapNode實例集(a  collection of SiteMapNode instances)。其必須有一個根節(jié)點，所有的非根節(jié)點都有一個父節(jié)點，且每個節(jié)點都可以有任意數(shù)量的子節(jié)點.每個SiteMapNode對象對應(yīng)的是website體系結(jié)構(gòu)的某個部分。這些部分通常都有對應(yīng)的web頁面，因此，SiteMapNode class類有像Title, Url, 和 Description這樣的屬性，它們用來描述SiteMapNode所對應(yīng)部分的相關(guān)信息。
還有一個Key屬性用來專門唯一的標(biāo)識這些SiteMapNode；除此以外，還有ChildNodes, ParentNode, NextSibling, PreviousSibling等等.

圖15顯示的是對應(yīng)于圖1的site map的總體結(jié)構(gòu)，只是更細(xì)化了而已.

 　　可以通過命名空間System.Web的SiteMap class類來訪問site map；該類的RootNode屬性返回網(wǎng)站地圖的根目錄的SiteMapNode實例；CurrentNode屬性返回的是這種SiteMapNode，其Url屬性剛好與當(dāng)前請求頁面的URL匹配.ASP.NET 2.0的Web導(dǎo)航控件的內(nèi)部就會用到SiteMap class類.

　　當(dāng)訪問SiteMap class類的屬性時，必須將網(wǎng)站地圖的層次結(jié)構(gòu)從某個介質(zhì)傳入內(nèi)存(memory).SiteMap class類并不是通過“硬編碼”的方式來處理網(wǎng)站地圖的邏輯關(guān)系，而是通過某種site map provider來工作.在默認(rèn)情況下，使用的是XmlSiteMapProvider class類，它從一個標(biāo)準(zhǔn)的XML文件讀取網(wǎng)站地圖的結(jié)構(gòu).不過，我們稍微做點工作就可以創(chuàng)建自己的site map provider.

　　所有的site map providers都繼承自SiteMapProvider class類，該類包含了site map providers要用到的最基本的方法和屬性，不過略去了很多執(zhí)行細(xì)節(jié).site map providers要用到的第二個類是StaticSiteMapProvider class類，它對SiteMapProvider class類進(jìn)行了擴(kuò)充，包含了更多的必要的函數(shù).在其內(nèi)部，StaticSiteMapProvider將網(wǎng)站地圖的SiteMapNode實例存儲在一個哈希表(Hashtable)里，并包含了AddNode(child, parent), RemoveNode(siteMapNode), Clear()等方法，以對哈希表里的SiteMapNodes執(zhí)行添加、刪除等操作.另外，XmlSiteMapProvider也繼承自StaticSiteMapProvider.

　　當(dāng)創(chuàng)建自定義的site map provider時，要對StaticSiteMapProvider進(jìn)行擴(kuò)充，重寫(overrid)2個抽象方法——BuildSiteMap 和 GetRootNodeCore. 對BuildSiteMap而言，就像它的名字暗示的那樣，將網(wǎng)站地圖的結(jié)構(gòu)從某種介質(zhì)里按層次結(jié)構(gòu)裝載進(jìn)內(nèi)存；而GetRootNodeCore返回的是網(wǎng)站地圖的根目錄.

　　在使用某個site map provider時，需要在應(yīng)用程序的配置文件里進(jìn)行注冊(registered)
.默認(rèn)情況下，XmlSiteMapProvider class類被注冊為AspNetXmlSiteMapProvider.為對額外添加的site map providers進(jìn)行注冊，可以在Web.config文件里添加如下的代碼：

configuration>
 system.web>
 ...

 siteMap defaultProvider="defaultProviderName">
  providers>
  add name="name" type="type" />
  /providers>
 /siteMap>
 /system.web>
/configuration>

　　name屬性可以為site map provider指派一個易讀的名稱；type屬性決定了該site map provider的類型.當(dāng)創(chuàng)建完我們定制的site map provider后，我們將在第七步為name 和type屬性賦值.

　　當(dāng)?shù)谝淮螐腟iteMap class類訪問site map provider時，site map provider class類都應(yīng)該被實例化，并在web應(yīng)用程序的整個生命周期里都駐留在內(nèi)存.

　　基于性能等方面的考慮，我們應(yīng)該將對駐留在內(nèi)存里的網(wǎng)站地圖結(jié)構(gòu)進(jìn)行數(shù)據(jù)緩存，每次調(diào)用BuildSiteMap的方法時，直接返回緩存的數(shù)據(jù)而不用重新檢索數(shù)據(jù).在任何情況下，如果我們不對BuildSiteMap對應(yīng)的網(wǎng)站結(jié)構(gòu)進(jìn)行緩存的話，每次調(diào)用時，我們都需要通過“層”來重新檢索產(chǎn)品和種類的信息(這將最終導(dǎo)致對數(shù)據(jù)庫的查詢).我們在前面的緩存章節(jié)探討過緩存數(shù)據(jù)“過時”的問題，為此，我們要么使用基于時間，要么使用基于SQL cache dependency的緩存技術(shù).

　　注意：一個site map provider可以任意地重寫(override)Initialize method方法.Initialize 方法是當(dāng)site map provider第一次實例化的時候被調(diào)用的，并可以將我們在Web.config 文件的add>元素里賦值的用戶自定義屬性值傳遞給它，比如：add name="name" type="type" customAttribute="value" />.當(dāng)一個頁面開發(fā)者希望指定各種與site map provider相關(guān)的設(shè)置，而又不希望修改site map provider的代碼的時候，這樣做很有用.比如，假如我們希望不通過“層”而直接從數(shù)據(jù)庫讀取category 和 products的數(shù)據(jù)時，我們當(dāng)然希望頁面開發(fā)者調(diào)用Web.config文件里的數(shù)據(jù)庫連接字符串，而不使用site map provider代碼里的“硬編碼”值.我們不打算在第六步創(chuàng)建的自定義site map provider里重寫Initialize方法.見Jeff Prosise的文章《Storing Site Maps in SQL Server》(http://msdn.microsoft.com/msdnmag/issues/05/06/WickedCode/)

第六步：創(chuàng)建自定義的Site Map Provider

　　要想創(chuàng)建一個自定義的site map provider來構(gòu)建源于Northwind數(shù)據(jù)庫里的categories 和 products信息的網(wǎng)站地圖(site map),我們需要創(chuàng)建一個類來擴(kuò)展StaticSiteMapProvider.在前面我們在App_Code文件夾里添加了一個CustomProviders文件夾，在該文件夾里添加名為NorthwindSiteMapProvider的新類，在類里添加如下的代碼：

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using System.Web.Caching;

public class NorthwindSiteMapProvider : StaticSiteMapProvider
{
 private readonly object siteMapLock = new object();
 private SiteMapNode root = null;
 public const string CacheDependencyKey =
 "NorthwindSiteMapProviderCacheDependency";

 public override SiteMapNode BuildSiteMap()
 {
 // Use a lock to make this method thread-safe
 lock (siteMapLock)
 {
  // First, see if we already have constructed the
  // rootNode. If so, return it...
  if (root != null)
  return root;

  // We need to build the site map!
  
  // Clear out the current site map structure
  base.Clear();

  // Get the categories and products information from the database
  ProductsBLL productsAPI = new ProductsBLL();
  Northwind.ProductsDataTable products = productsAPI.GetProducts();

  // Create the root SiteMapNode
  root = new SiteMapNode(
  this, "root", "~/SiteMapProvider/Default.aspx", "All Categories");
  AddNode(root);

  // Create SiteMapNodes for the categories and products
  foreach (Northwind.ProductsRow product in products)
  {
  // Add a new category SiteMapNode, if needed
  string categoryKey, categoryName;
  bool createUrlForCategoryNode = true;
  if (product.IsCategoryIDNull())
  {
   categoryKey = "Category:None";
   categoryName = "None";
   createUrlForCategoryNode = false;
  }
  else
  {
   categoryKey = string.Concat("Category:", product.CategoryID);
   categoryName = product.CategoryName;
  }

  SiteMapNode categoryNode = FindSiteMapNodeFromKey(categoryKey);

  // Add the category SiteMapNode if it does not exist
  if (categoryNode == null)
  {
   string productsByCategoryUrl = string.Empty;
   if (createUrlForCategoryNode)
   productsByCategoryUrl =
    "~/SiteMapProvider/ProductsByCategory.aspx?CategoryID="
    + product.CategoryID;

   categoryNode = new SiteMapNode(
   this, categoryKey, productsByCategoryUrl, categoryName);
   AddNode(categoryNode, root);
  }

  // Add the product SiteMapNode
  string productUrl =
   "~/SiteMapProvider/ProductDetails.aspx?ProductID="
   + product.ProductID;
  SiteMapNode productNode = new SiteMapNode(
   this, string.Concat("Product:", product.ProductID),
   productUrl, product.ProductName);
  AddNode(productNode, categoryNode);
  }
  
  // Add a "dummy" item to the cache using a SqlCacheDependency
  // on the Products and Categories tables
  System.Web.Caching.SqlCacheDependency productsTableDependency =
  new System.Web.Caching.SqlCacheDependency("NorthwindDB", "Products");
  System.Web.Caching.SqlCacheDependency categoriesTableDependency =
  new System.Web.Caching.SqlCacheDependency("NorthwindDB", "Categories");

  // Create an AggregateCacheDependency
  System.Web.Caching.AggregateCacheDependency aggregateDependencies =
  new System.Web.Caching.AggregateCacheDependency();
  aggregateDependencies.Add(productsTableDependency, categoriesTableDependency);

  // Add the item to the cache specifying a callback function
  HttpRuntime.Cache.Insert(
  CacheDependencyKey, DateTime.Now, aggregateDependencies,
  Cache.NoAbsoluteExpiration, Cache.NoSlidingExpiration,
  CacheItemPriority.Normal,
  new CacheItemRemovedCallback(OnSiteMapChanged));


  // Finally, return the root node
  return root;
 }
 }

 protected override SiteMapNode GetRootNodeCore()
 {
 return BuildSiteMap();
 }

 protected void OnSiteMapChanged(string key, object value, CacheItemRemovedReason reason)
 {
 lock (siteMapLock)
 {
  if (string.Compare(key, CacheDependencyKey) == 0)
  {
  // Refresh the site map
  root = null;
  }
 }
 }

 public DateTime? CachedDate
 {
 get
 {
  return HttpRuntime.Cache[CacheDependencyKey] as DateTime?;
 }
 }
}

　　讓我們考察該類的BuildSiteMap方法，它有一個lock statement聲明。lock statement每次只允許“單線程操作”(one thread at a time to enter)，以避免“多線程操作”之間的沖突.

　　屬于“類級別”(class-level)的SiteMapNode變量—root，用來緩存網(wǎng)站地圖結(jié)構(gòu).當(dāng)網(wǎng)站地圖第一次被“結(jié)構(gòu)化”，或“源數(shù)據(jù)”發(fā)生變動后的第一次“結(jié)構(gòu)化”時，root為null值，在“結(jié)構(gòu)化”的過程中，root被賦值為網(wǎng)站地圖的根節(jié)點；所以，當(dāng)?shù)诙握{(diào)用BuildSiteMap方法時，root就不為null值了.自然，只要root不為null，直接將網(wǎng)站地圖結(jié)構(gòu)返回，而用不著重新創(chuàng)建.

　　如果root為null，那么將根據(jù)product 和 category信息創(chuàng)建網(wǎng)站地圖結(jié)構(gòu).為此，先要創(chuàng)建一個SiteMapNode實例，再調(diào)用StaticSiteMapProvider class類的AddNode method方法來構(gòu)建網(wǎng)站地圖的層次體系，再將SiteMapNode實例存儲進(jìn)一個哈希表.在我們構(gòu)建層次體系之前，我們首先調(diào)用Clear method方法，將內(nèi)部的哈希表清空；然后，調(diào)用ProductsBLL class類的GetProducts()方法，把返回的ProductsDataTable存儲進(jìn)局部變量.

　　創(chuàng)建網(wǎng)站地圖結(jié)構(gòu)從創(chuàng)建根節(jié)點并賦值給root開始，本章要用到的SiteMapNode's constructor重載，接受如下的信息：

對一個site map provider (this)的引用.

SiteMapNode的Key值：對每個SiteMapNode而言，這個待定值必須是唯一的.

SiteMapNode的Url值：Url為可選項，但一旦指定的話，每個SiteMapNode的Url值必須是唯一的.

SiteMapNode的Title值：此為必選項.

　　AddNode(root) method方法將SiteMapNode root添加給網(wǎng)站地圖作為根節(jié)點。然后，遍歷ProductsDataTable里的所有ProductRow，如果當(dāng)前product的category所對應(yīng)的SiteMapNode已經(jīng)存在的話，那么引用該SiteMapNode；如果不存在的話，則為該category創(chuàng)建一個新的SiteMapNode，并且調(diào)用AddNode(categoryNode, root) method方法，將其作為SiteMapNode root的子節(jié)點進(jìn)行添加.當(dāng)找到或創(chuàng)建category對應(yīng)的SiteMapNode后，創(chuàng)建一個當(dāng)前product對應(yīng)的SiteMapNode，并通過AddNode(productNode, categoryNode)方法將其作為category SiteMapNode的子節(jié)點進(jìn)行添加.注意，category SiteMapNode的Url屬性為~/SiteMapProvider/ProductsByCategory.aspx?CategoryID=categoryID；而product SiteMapNode的Url屬性為~/SiteMapNode/ProductDetails.aspx?ProductID=productID.

　　注意：對那種CategoryID為NULL值的產(chǎn)品，統(tǒng)統(tǒng)將其歸為一個category，其對應(yīng)的category SiteMapNode的Title屬性可設(shè)置為“None”；Url屬性設(shè)置為空字符串。我將其Url設(shè)置為空字符串是因為ProductBLL class類的GetProductsByCategory(categoryID)方法無法返回那些CategoryID值為NULL的產(chǎn)品.不過我鼓勵你對本教程進(jìn)行擴(kuò)展，使該category SiteMapNode的Url屬性對應(yīng)一個ProductsByCategory.aspx頁面，該頁面專門用來展示那些CategoryID為NULL的產(chǎn)品.

　　當(dāng)完成site map的構(gòu)建后，將一個AggregateCacheDependency object對象添加到data cache，該對象使用基于Categories 和 Products表的SQL cache dependency技術(shù)。我們在前面的教程里探討過SQL cache dependencies，不過我們自定義的site map provider使用的是重載(overload)的data cache的Insert方法，該重載方法接受一個delegate作為輸入?yún)?shù).具體而言，我們將傳入一個CacheItemRemovedCallback delegate，其指向OnSiteMapChanged method方法，該方法定義在NorthwindSiteMapProvider class類里
注意：內(nèi)存里的site map表述是緩存在一個“類級”(class-level)變量root里的.由于只有一個site map provider的實例(instance)，并且對web應(yīng)用程序的線程來說都是共享的，這個類級變量當(dāng)作緩存服務(wù)。BuildSiteMap method方法也會用到data cache，但僅僅做作為一種探測Categories 或 Products表里的數(shù)據(jù)發(fā)生改變的方法。注意添加到data cache里的僅僅是當(dāng)前的date和time，實際的site map數(shù)據(jù)并沒有添加到data cache.

BuildSiteMap method方法最后返回網(wǎng)站地圖的根節(jié)點.

　　剩下的方法就比較簡單易懂了.GetRootNodeCore方法用來返回根節(jié)點，由于BuildSiteMap返回根節(jié)點root， GetRootNodeCore方法僅僅返回BuildSiteMap方法的返回值.當(dāng)緩存條碼被清除掉時，OnSiteMapChanged方法將root設(shè)置為null；當(dāng)root為null的時候，當(dāng)下一次調(diào)用BuildSiteMap時，將重新創(chuàng)建地圖網(wǎng)站結(jié)構(gòu).最后，如果data cache里存儲有date 和 time值的話，CachedDate屬性將返回這些值.頁面開發(fā)員可以用該屬性來探測site map數(shù)據(jù)最近被緩存的時間.

第七步：對NorthwindSiteMapProvider進(jìn)行登記

　　為了使用我們在第六步創(chuàng)建的NorthwindSiteMapProvider site map provider，我們需要在Web.config文件的siteMap>部分進(jìn)行注冊.具體來說，將下面的代碼添加到Web.config文件的system.web>部分：

siteMap defaultProvider="AspNetXmlSiteMapProvider">
 providers>
 add name="Northwind" type="NorthwindSiteMapProvider" />
 /providers>
/siteMap>

　　上述代碼闡明了如下2個事實：第一，它指明了“內(nèi)置”的AspNetXmlSiteMapProvider為默認(rèn)的site map provider；第二，它將我們在第六步創(chuàng)建的用戶自定義site map provider進(jìn)行了注冊，取名為“Northwind”.
注意：對那些位于在App_Code文件夾的site map providers而言，type屬性的值就是類的名稱.還一種方法，我們可以用一個單獨的類庫工程來創(chuàng)建自定義的site map provider，將其編譯文件放置在/Bin目錄；如果是那樣的話，type屬性就變成了“Namespace.ClassName, AssemblyName”.

　　更新Web.config文件后，花點時間在瀏覽器里登錄本教程的任何一個頁面，我們注意到左邊的導(dǎo)航界面跟以前一樣，那是因為我們把AspNetXmlSiteMapProvider作為默認(rèn)的provider，為了使導(dǎo)航用戶界面使用我們定制的NorthwindSiteMapProvider，我們應(yīng)明確的指定使用“Northwind” site map provider，我們將在第八步完成.

第八步：使用定制的Site Map Provider來顯示網(wǎng)站地圖信息

　　把我們定制的site map provider注冊到Web.config文件后，我們可以將導(dǎo)航控件添加到SiteMapProvider文件夾里的Default.aspx, ProductsByCategory.aspx, 和ProductDetails.aspx頁面.首先，打開Default.aspx頁面進(jìn)入設(shè)計模式，從工具箱拖一個SiteMapPath控件到頁面。該控件位于工具箱的導(dǎo)航區(qū)域.

圖16：為Default.aspx頁面添加一個SiteMapPath控件

　　SiteMapPath控件包含一個breadcrumb，用來顯示當(dāng)前頁面在網(wǎng)站地圖里的位置。我們在第三章《模板頁和站點導(dǎo)航》里在模板頁的頂部添加了一個SiteMapPath控件.

　　花點時間在瀏覽器里登錄頁面，我們在圖16里添加的SiteMapPath控件使用的是默認(rèn)的site map provider，它從Web.sitemap文件獲取數(shù)據(jù)，因此breadcrumb顯示為“Home > Customizing the Site Map”.如下圖：

圖17：Breadcrumb使用的是默認(rèn)的Site Map Provider

　　要使在圖16里添加的SiteMapPath使用我們定制的site map provider的話，設(shè)其SiteMapProvider property屬性為“Northwind”, 這個名字是我們在Web.config文件里分配給NorthwindSiteMapProvider的.不過，在設(shè)計器里依然使用的是默認(rèn)的site map provider，但是如你在瀏覽器里登錄該頁面的話，你將看到breadcrumb使用的是我們定制的site map provider了.

圖18：Breadcrumb現(xiàn)在使用的是我們定制的NorthwindSiteMapProvider

　　SiteMapPath控件將在ProductsByCategory.aspx 和 ProductDetails.aspx頁面展示更具功能性的用戶界面.在這2個頁面里添加SiteMapPath控件，設(shè)置其SiteMapProvider屬性為“Northwind”. 在Default.aspx頁面里點擊Beverages類的“View Products”鏈接，然后再點Chai Tea的“View Details”鏈接，如圖19所示，breadcrumb顯示的是當(dāng)前的網(wǎng)站地圖節(jié)點(“Chai Tea”)，及其上級節(jié)點：“Beverages” 和“All Categories”.

圖19：Breadcrumb現(xiàn)在使用的是我們定制的NorthwindSiteMapProvider

　　除了SiteMapPath外，還可以使用其它的導(dǎo)航控件，比如Menu 和 TreeView控件.本章的下載代碼里，Default.aspx, ProductsByCategory.aspx,和ProductDetails.aspx頁面都包含Menu控件(見圖20).要想更深入的了解ASP.NET 2.0里的導(dǎo)航控件和site map體系的話，可參閱《ASP.NET 2.0 QuickStarts》系列（http://quickstarts.asp.net/QuickStartv20/aspnet/）的《Examining ASP.NET 2.0's Site Navigation Features》和《Using Site Navigation Controls》部分.

圖20：Menu控件列出了所有的Categories 和 Products

就像在本教程前面提到的那樣，網(wǎng)站地圖結(jié)構(gòu)可以通過SiteMap class類來進(jìn)行訪問，下面的代碼返回默認(rèn)的provider的root SiteMapNode：

SiteMapNode root = SiteMap.RootNode;

由于AspNetXmlSiteMapProvider是默認(rèn)的provider，上述代碼返回的是定義在Web.sitemap文件里的根節(jié)點，要引用其它的site map provider的話，使用SiteMap class類的Providers property屬性，如：

SiteMapNode root = SiteMap.Providers["name"].RootNode;
這里的name是用戶定制的site map provider的名稱(就本文而言,為“Northwind”)

要訪問某個具體的site map provider，使用SiteMap.Providers["name"]來獲取該provider的實例，再將其轉(zhuǎn)換成恰當(dāng)?shù)念愋?。比如，要展示NorthwindSiteMapProvider的CachedDate property屬性，使用如下的代碼：

NorthwindSiteMapProvider customProvider =
 SiteMap.Providers["Northwind"] as NorthwindSiteMapProvider;
if (customProvider != null)
{
 DateTime? lastCachedDate = customProvider.CachedDate;

 if (lastCachedDate != null)
 LabelID.Text = "Site map cached on: " + lastCachedDate.Value.ToString();
 else
 LabelID.Text = "The site map is being reconstructed!";
}

　　注意：務(wù)必測試SQL cache dependency屬性，訪問完Default.aspx, ProductsByCategory.aspx, 和 ProductDetails.aspx頁面后，轉(zhuǎn)到本系列教程的《編輯插入和刪除數(shù)據(jù)》部分的任一個頁面，編輯某個category 或 product的名稱；然后再轉(zhuǎn)到SiteMapProvider文件夾里的某個頁面，假設(shè)時間足夠長，長到檢測機(jī)制(polling mechanism)發(fā)現(xiàn)“源數(shù)據(jù)庫”已經(jīng)發(fā)生了改動，那么site map應(yīng)該被更新以顯示新的product 或 category名字.

結(jié)語：

　　ASP.NET 2.0的site map屬性包含一個SiteMap class類，一系列內(nèi)置的的導(dǎo)航Web控件，以及一個默認(rèn)的site map provider.為了使用來自某些數(shù)據(jù)源的site map信息——比如數(shù)據(jù)庫、系統(tǒng)的“層”、或者某些Web服務(wù)，我們需要創(chuàng)建一個用戶定制的 site map provider.這就要創(chuàng)建一個類，該類直接或間接的源自SiteMapProvider class類.

　　本章我們探討了如何創(chuàng)建一個用戶定制的site map provider，它以一個由product 和 category信息構(gòu)成的site map為基礎(chǔ).我們的provider對StaticSiteMapProvider class類進(jìn)行了擴(kuò)充，并創(chuàng)建了一個BuildSiteMap method方法來獲取數(shù)據(jù)、構(gòu)建site map的層次體系，并且將最終的網(wǎng)站地圖結(jié)構(gòu)緩存在一個“類級”的變量里.我們使用一個SQL cache dependency來確保當(dāng)Categories 或 Products的“源數(shù)據(jù)”發(fā)生改動時使緩存的數(shù)據(jù)失效.

　　祝編程快樂！

作者簡介

　　本系列教程作者 Scott Mitchell，著有六本ASP/ASP.NET方面的書，是4GuysFromRolla.com的創(chuàng)始人，自1998年以來一直應(yīng)用 微軟Web技術(shù)。大家可以點擊查看全部教程《[翻譯]Scott Mitchell 的ASP.NET 2.0數(shù)據(jù)教程》，希望對大家的學(xué)習(xí)ASP.NET有所幫助。