在架構中快取資料 (C#)

作者:Scott Mitchell

下載 PDF

在先前的教程中,我們學習如何在呈現層應用快取。 在本教學課程中,我們學習如何利用層次化架構在業務邏輯層進行資料快取。 我們透過擴展架構以包含快取層來實現這一點。

簡介

正如我們在前面的教學課程中看到的,快取 ObjectDataSource 的資料就像設定幾個屬性一樣簡單。 不幸的是,ObjectDataSource 在表示層應用快取,這將快取策略與 ASP.NET 頁面緊密耦合。 建立分層架構的原因之一是允許打破這種耦合。 例如,業務邏輯層將業務邏輯與 ASP.NET 頁面分離,而資料存取層將資料存取細節分離。 這種業務邏輯和資料存取細節的解耦是首選,部分原因是它使系統更具可讀性,更易於維護,並且更改起來更靈活。 它還允許領域知識和分工,在表示層上工作的開發人員不需要熟悉資料庫的詳細資訊即可完成工作。 將快取策略與表示層解耦也能帶來類似的好處。

在本教學課程中,我們將增強我們的架構,以包含採用我們的快取策略的「快取層」(或簡稱 CL)。 快取層將包含一個類別 ProductsCL,提供訪問產品資訊的方法,例如 GetProducts()、GetProductsByCategoryID(categoryID) 等。當呼叫這些方法時,系統將首先嘗試從快取中擷取資料。 如果快取為空,這些方法將呼叫 BLL 中的適當ProductsBLL方法,進而從 DAL 取得資料。 ProductsCL 方法在傳回之前會快取從 BLL 擷取的資料。

如圖 1 所示,CL 位於表示層與業務邏輯層之間。

The Caching Layer (CL) is Another Layer in Our Architecture快取層 (CL) 是我們架構中的另一層

圖 1:快取層 (CL) 是我們架構中的另一層

第 1 步:建立快取層類別

在本教學課程中,我們將建立一個非常簡單的 CL,其中包含一個僅有少數方法的類別 ProductsCL。 為整個應用程式建立完整的緩存層需要建立 CategoriesCL、EmployeesCL 和 SuppliersCL 類別,並在這些緩存層類別中為 BLL 中的每個資料存取或修改方法提供一個方法。 與 BLL 和 DAL 一樣,快取層理想情況下應作為單獨的類別庫專案實現;但是,我們將把它作為 App_Code 資料夾中的類別來實現。

為了更清晰地將 CL 類別與 DAL 和 BLL 類別分開,讓我們在 App_Code 資料夾中建立一個新的子資料夾。 在解決方案總管中的App_Code 資料夾上右鍵單擊,選擇“新資料夾”,並將新資料夾命名為CL。 建立此資料夾後,向其中新增一個名為ProductsCL.cs的類別。

新增名為 CL 的新資料夾和名為 ProductsCL.cs 的類別新增名為 CL 的新資料夾和名為 ProductsCL.cs 的類別檔案

圖 2:新增名稱為CL的新資料夾和名稱為ProductsCL.cs的類別

ProductsCL 類別應包含與其對應的業務邏輯層類別 ProductsBLL 中相同的資料存取和修改方法集。 我們不需要建立所有這些方法,只需在這裡建立幾個,以了解 CL 使用的模式。 特別是,我們將在步驟 3 中新增 GetProducts() 和 GetProductsByCategoryID(categoryID) 方法,並在步驟 4 中新增 UpdateProduct 重載。 您可以隨意加入剩餘的 ProductsCL 方法和 CategoriesCL、EmployeesCL、SuppliersCL 類別。

步驟 2:讀取和寫入資料快取

前面教學中探討的 ObjectDataSource 快取功能在內部使用 ASP.NET 資料快取來儲存從 BLL 擷取的資料。 以程式設計方式,也可以從 ASP.NET 頁面的程式碼隱藏類別或 Web 應用程式體系結構中的類別存取資料快取。 若要從 ASP.NET 頁面的程式碼隱藏類別中讀取和寫入資料快取,請使用下列模式:

// Read from the cache
object value = Cache["key"];
// Add a new item to the cache
Cache["key"] = value;
Cache.Insert(key, value);
Cache.Insert(key, value, CacheDependency);
Cache.Insert(key, value, CacheDependency, DateTime, TimeSpan);

Cache 類別 的 Insert 方法 有許多重載。 Cache["key"] = value 和 Cache.Insert(key, value) 是同義詞,並且都使用指定的鍵將項目添加到快取,而沒有定義的到期時間。 通常,我們希望在將項目新增至快取時指定過期時間,可以作為依賴項、基於時間的過期時間,或兩者兼而有之。 使用其他Insert方法重載之一來提供依賴性基礎或時間基礎的到期資訊。

快取層的方法需要先檢查請求的資料是否在快取中,如果是,則從快取中傳回資料。 如果請求的資料不在快取中,則需要呼叫適當的 BLL 方法。 它的返回值應該被快取然後返回,如下面的序列圖所示。

快取層的方法會在快取可用時從中返回資料。

圖 3:快取層的方法從快取返回資料(如果可用)

圖 3 中描述的序列是使用以下模式在 CL 類別中完成的:

Type instance = Cache["key"] as Type;
if (instance == null)
{
    instance = BllMethodToGetInstance();
    Cache.Insert(key, instance, ...);
}
return instance;

這裡,Type 是儲存在快取中的資料類型,而 Northwind.ProductsDataTable 是唯一識別快取項目的鍵。 如果具有指定鍵的項目不在快取中,則實例將為null,並且將從適當的 BLL 方法擷取資料並新增至快取。 當到達 return instance 時,實例包含對資料的引用,無論資料是來自快取還是由 BLL 提取。

從快取存取資料時請務必使用上述模式。 下面的模式乍看之下似乎是等效的,但其中包含引入競爭條件的細微差別。 競爭條件很難除錯,因為它們偶爾才會顯現並且很難重現。

if (Cache["key"] == null)
{
    Cache.Insert(key, BllMethodToGetInstance(), ...);
}
return Cache["key"];

第二個錯誤的程式碼片段的差異在於,並不是在本地變數中儲存對快取項目的引用,而是在條件陳述式中直接訪問資料快取並且。 想像一下,當到達此程式碼時,Cache["key"] 是非 null,但在到達 return 陳述式之前,系統會從快取中移除 key。 在這種罕見的情況下,程式將傳回一個 null 值而不是預期類型的物件。

注意

資料快取是執行緒安全的,因此您不需要為簡單的讀取或寫入同步執行緒存取。 但是,如果您需要對快取中的資料執行多個需要原子操作的操作,則您需要負責實作鎖定或其他一些機制來確保執行緒安全。

可以使用 方法以程式方式從資料快取中逐出項目,如下所示:

Cache.Remove(key);

步驟 3:從ProductsCLClass返回產品資訊

在本教學課程中,實作兩種從 ProductsCL 類別傳回產品資訊的方法:GetProducts() 和 GetProductsByCategoryID(categoryID)。 如同業務邏輯層中的 ProductsBL 類別一樣,CL 中的 GetProducts() 方法將所有產品的資訊作為 Northwind.ProductsDataTable 物件傳回,而 GetProductsByCategoryID(categoryID) 則傳回指定類別的所有產品。

以下程式碼顯示了 ProductsCL 類別中的部分方法:

[System.ComponentModel.DataObject]
public class ProductsCL
{
    private ProductsBLL _productsAPI = null;
    protected ProductsBLL API
    {
        get
        {
            if (_productsAPI == null)
                _productsAPI = new ProductsBLL();
            return _productsAPI;
        }
    }
    
   [System.ComponentModel.DataObjectMethodAttribute(DataObjectMethodType.Select, true)]
    public Northwind.ProductsDataTable GetProducts()
    {
        const string rawKey = "Products";
        // See if the item is in the cache
        Northwind.ProductsDataTable products = _
            GetCacheItem(rawKey) as Northwind.ProductsDataTable;
        if (products == null)
        {
            // Item not found in cache - retrieve it and insert it into the cache
            products = API.GetProducts();
            AddCacheItem(rawKey, products);
        }
        return products;
    }
    
    [System.ComponentModel.DataObjectMethodAttribute(DataObjectMethodType.Select, false)]
    public Northwind.ProductsDataTable GetProductsByCategoryID(int categoryID)
    {
        if (categoryID < 0)
            return GetProducts();
        else
        {
            string rawKey = string.Concat("ProductsByCategory-", categoryID);
            // See if the item is in the cache
            Northwind.ProductsDataTable products = _
                GetCacheItem(rawKey) as Northwind.ProductsDataTable;
            if (products == null)
            {
                // Item not found in cache - retrieve it and insert it into the cache
                products = API.GetProductsByCategoryID(categoryID);
                AddCacheItem(rawKey, products);
            }
            return products;
        }
    }
}

首先,注意應用於類別和方法的 DataObject 和 DataObjectMethodAttribute 屬性。 這些屬性向 ObjectDataSource 精靈提供訊息,指示哪些類別和方法應出現在精靈的步驟中。 由於將從表示層中的 ObjectDataSource 存取 CL 類別和方法,因此我新增了這些屬性來增強設計時體驗。 回頭參考 建立業務邏輯層 教學,以獲得有關這些屬性及其效果的更詳細描述。

在 GetProducts() 和 GetProductsByCategoryID(categoryID) 方法中,從 GetCacheItem(key) 方法傳回的資料被指派給局部變數。 稍後我們將探討 GetCacheItem(key) 方法,它根據指定的 key 從快取中返回特定的項目。 如果在快取中沒有找到這樣的資料,則從對應的 ProductsBLL 類別方法中擷取,然後使用 AddCacheItem(key, value) 方法新增到快取中。

GetCacheItem(key) 方法用來從資料快取中讀取值,而 AddCacheItem(key, value) 方法則是用來將值寫入資料快取。 GetCacheItem(key) 方法是兩者之中較簡單的一個。 它只是使用傳入的key從 Cache 類別返回值:

private object GetCacheItem(string rawKey)
{
    return HttpRuntime.Cache[GetCacheKey(rawKey)];
}
private readonly string[] MasterCacheKeyArray = {"ProductsCache"};
private string GetCacheKey(string cacheKey)
{
    return string.Concat(MasterCacheKeyArray[0], "-", cacheKey);
}

GetCacheItem(key) 不使用提供的 key 值,而是呼叫 GetCacheKey(key) 方法,該方法傳回前綴為 ProductsCache- 的 key。 MasterCacheKeyArray 保存字串 ProductsCache ,它也被 AddCacheItem(key, value) 方法使用,我們稍後會看到。

從 ASP.NET 頁面的程式碼隱藏類別中,可以使用該類別的 Cache 屬性來存取資料快取,並允許使用 Cache["key"] = value 這樣的語法,如步驟 2 所述。 從架構內的類別中,可以使用 HttpRuntime.Cache 或 HttpContext.Current.Cache 來存取資料快取。 Peter Johnson 的部落格文章 HttpRuntime.Cache vs. HttpContext.Current.Cache 指出,與 相比,使用 在效能上具有輕微的優勢。因此, 選擇使用 。

注意

如果您的架構是使用類別庫專案實現的,那麼您將需要新增對 System.Web 組件的參考,以便使用 HttpRuntime 和 HttpContext 類別。

如果在快取中沒有找到該項目,則 ProductsCL 類別的方法會從 BLL 取得資料,並使用 AddCacheItem(key, value) 方法將其新增至快取。 要在快取中添加值,我們可以使用以下程式碼,該程式碼會使用 60 秒的過期時間:

const double CacheDuration = 60.0;
private void AddCacheItem(string rawKey, object value)
{
    HttpRuntime.Cache.Insert(GetCacheKey(rawKey), value, null, 
        DateTime.Now.AddSeconds(CacheDuration), Caching.Cache.NoSlidingExpiration);
}

DateTime.Now.AddSeconds(CacheDuration) 指定了一個基於時間的到期時間,在未來的60秒內失效,而 System.Web.Caching.Cache.NoSlidingExpiration 則表示沒有滑動過期配置。 雖然 Insert 方法重載有絕對到期和滑動到期的輸入參數,但您只能選擇其中之一。 如果您嘗試同時指定絕對時間和時間跨度,Insert 方法將引發 ArgumentException 異常。

注意

目前 AddCacheItem(key, value) 方法的實作存在一些缺陷。 我們將在步驟 4 中解決並克服這些問題。

第四步:透過架構修改資料時使快取失效

除了資料擷取方法之外,快取層還需要提供與 BLL 相同的方法來插入、更新和刪除資料。 CL的資料修改方法不會修改快取的資料,而是呼叫BLL對應的資料修改方法,然後使快取失效。 正如我們在前面的教學課程中所看到的,這與當 ObjectDataSource 啟用其快取功能並呼叫其 Insert、Update 或 Delete 方法時所表現的行為相同。

以下 UpdateProduct 重載函數說明如何在 CL 中實作資料修改方法:

[System.ComponentModel.DataObjectMethodAttribute(DataObjectMethodType.Update, false)]
public bool UpdateProduct(string productName, decimal? unitPrice, int productID)
{
    bool result = API.UpdateProduct(productName, unitPrice, productID);
    // TODO: Invalidate the cache
    return result;
}

呼叫適當的資料修改業務邏輯層方法,但在返回其回應之前,我們需要使快取失效。 不幸的是,使快取失效並不簡單,因為 ProductsCL 類別的 GetProducts() 和 GetProductsByCategoryID(categoryID) 方法各自使用不同的鍵向快取添加項目,並且 GetProductsByCategoryID(categoryID) 方法為每個唯一的 categoryID 添加不同的快取項目。

當使快取失效時,我們需要刪除 所有 可能由 ProductsCL 類別新增的項目。 這可以透過將快取相依性與新增到快取中的每個項目在方法中相關聯來實現。 一般來說,快取依賴項可以是快取中的另一個項目、檔案系統上的檔案或 Microsoft SQL Server 資料庫中的資料。 當依賴項變更或從快取中刪除時,與其關聯的快取項目將自動從快取中逐出。 對於本教學課程,我們希望在快取中建立一個額外項目,作為透過 ProductsCL 類別新增之所有項目的快取相依性。 這樣,只需刪除快取依賴項即可從快取中刪除所有這些項目。

讓我們更新 AddCacheItem(key, value) 方法,以便透過此方法新增至快取的每個項目都與單一快取依賴關聯:

private void AddCacheItem(string rawKey, object value)
{
    System.Web.Caching.Cache DataCache = HttpRuntime.Cache;
    // Make sure MasterCacheKeyArray[0] is in the cache - if not, add it
    if (DataCache[MasterCacheKeyArray[0]] == null)
        DataCache[MasterCacheKeyArray[0]] = DateTime.Now;
    // Add a CacheDependency
    System.Web.Caching.CacheDependency dependency = 
        new CacheDependency(null, MasterCacheKeyArray);
    DataCache.Insert(GetCacheKey(rawKey), value, dependency, 
        DateTime.Now.AddSeconds(CacheDuration), 
        System.Web.Caching.Cache.NoSlidingExpiration);
}

MasterCacheKeyArray 是一個包含單一值 ProductsCache 的字串陣列。 首先,將快取項目新增到快取中並分配當前日期和時間。 如果快取項目已存在,則更新它。 接下來,建立快取相依性。 此CacheDependency類別的建構函式有多個重載,但此處使用的建構函式需要兩個陣列輸入。 第一個指定要用作依賴項的檔案集。 由於我們不想使用任何基於檔案的依賴項,因此第一個輸入參數使用 null 值。 第二個輸入參數指定用作依賴項的快取鍵集。 在這裡我們指定我們的單一依賴項 MasterCacheKeyArray。 然後將 CacheDependency 傳遞到 Insert 方法中。

透過對 AddCacheItem(key, value) 的修改,使快取失效變得像刪除依賴項一樣簡單。

[System.ComponentModel.DataObjectMethodAttribute(DataObjectMethodType.Update, false)]
public bool UpdateProduct(string productName, decimal? unitPrice, int productID)
{
    bool result = API.UpdateProduct(productName, unitPrice, productID);
    // Invalidate the cache
    InvalidateCache();
    return result;
}
public void InvalidateCache()
{
    // Remove the cache dependency
    HttpRuntime.Cache.Remove(MasterCacheKeyArray[0]);
}

步驟 5:從表示層呼叫快取層

快取層的類別和方法可用於使用我們在這些教學課程中研究過的技術來處理資料。 為了說明如何使用快取資料,請將變更儲存到 ProductsCL 類別中,然後開啟 FromTheArchitecture.aspx 資料夾中的 Caching 頁面,並添加 GridView。 從 GridView 的智慧標記建立一個新的 ObjectDataSource。 在精靈的第一步中,您應該會看到 ProductsCL 類別作為下拉清單中的選項之一。

ProductsCL 類別被納入業務物件下拉清單中

圖 4:類別包含在業務物件下拉清單中 (按一下以查看完整大圖)

選擇 ProductsCL 後,按下一步。 SELECT 分頁標籤中的下拉清單有兩個項目 - GetProducts() 和 GetProductsByCategoryID(categoryID),並且 UPDATE 分頁標籤中只有 UpdateProduct 的唯一重載。 從 SELECT 標籤中選擇 GetProducts() 方法,從 UPDATE 標籤中選擇 UpdateProducts 方法,然後點擊 Finish。

ProductsCL 類別中的方法列在下拉清單中。

圖 5:CLASS_NAME 類別的方法列在下拉清單中 (按一下查看大圖)

完成精靈後,Visual Studio 將把 ObjectDataSource 的 OldValuesParameterFormatString 屬性設為 original_{0},並將適當的欄位新增至 GridView。 將 OldValuesParameterFormatString 屬性變更回其預設值 {0},並將 GridView 設定為支援分頁、排序和編輯。 由於 CL 使用的 UploadProducts 重載僅接受編輯後的產品名稱和價格,因此需限制 GridView,以便只有這些欄位是可編輯的。

在前面的教學中,我們定義了 GridView 以包含 ProductName、CategoryName 和 UnitPrice 欄位。 請隨意複製此格式和結構,在這種情況下,您的 GridView 和 ObjectDataSource 宣告性標記應類似於以下內容:

<asp:GridView ID="Products" runat="server" AutoGenerateColumns="False" 
    DataKeyNames="ProductID" DataSourceID="ProductsDataSource" 
    AllowPaging="True" AllowSorting="True">
    <Columns>
        <asp:CommandField ShowEditButton="True" />
        <asp:TemplateField HeaderText="Product" SortExpression="ProductName">
            <EditItemTemplate>
                <asp:TextBox ID="ProductName" runat="server" 
                    Text='<%# Bind("ProductName") %>' />
                <asp:RequiredFieldValidator ID="RequiredFieldValidator1"
                    ControlToValidate="ProductName" Display="Dynamic" 
                    ErrorMessage="You must provide a name for the product." 
                    SetFocusOnError="True"
                    runat="server">*</asp:RequiredFieldValidator>
            </EditItemTemplate>
            <ItemTemplate>
                <asp:Label ID="Label2" runat="server" 
                    Text='<%# Bind("ProductName") %>'></asp:Label>
            </ItemTemplate>
        </asp:TemplateField>
        <asp:BoundField DataField="CategoryName" HeaderText="Category" 
            ReadOnly="True" SortExpression="CategoryName" />
        <asp:TemplateField HeaderText="Price" SortExpression="UnitPrice">
            <EditItemTemplate>
                $<asp:TextBox ID="UnitPrice" runat="server" Columns="8" 
                    Text='<%# Bind("UnitPrice", "{0:N2}") %>'></asp:TextBox>
                <asp:CompareValidator ID="CompareValidator1" runat="server" 
                    ControlToValidate="UnitPrice" Display="Dynamic" 
                    ErrorMessage="You must enter a valid currency value with 
                        no currency symbols. Also, the value must be greater than 
                        or equal to zero."
                    Operator="GreaterThanEqual" SetFocusOnError="True" 
                    Type="Currency" ValueToCompare="0">*</asp:CompareValidator>
            </EditItemTemplate>
            <ItemStyle HorizontalAlign="Right" />
            <ItemTemplate>
                <asp:Label ID="Label1" runat="server" 
                    Text='<%# Bind("UnitPrice", "{0:c}") %>' />
            </ItemTemplate>
        </asp:TemplateField>
    </Columns>
</asp:GridView>
<asp:ObjectDataSource ID="ProductsDataSource" runat="server" 
    OldValuesParameterFormatString="{0}" SelectMethod="GetProducts" 
    TypeName="ProductsCL" UpdateMethod="UpdateProduct">
    <UpdateParameters>
        <asp:Parameter Name="productName" Type="String" />
        <asp:Parameter Name="unitPrice" Type="Decimal" />
        <asp:Parameter Name="productID" Type="Int32" />
    </UpdateParameters>
</asp:ObjectDataSource>

此時,我們有一個使用快取層 (Caching Layer) 的頁面。 若要查看快取的運作情況,請在 ProductsCL 類別 GetProducts() 和 UpdateProduct 方法中設定斷點。 在瀏覽器中存取該頁面,並在排序和分頁時單步執行程式碼,以便查看從快取中提取的資料。 然後更新一筆記錄,注意快取已失效,因此,當資料反彈到 GridView 時,會從 BLL 擷取該記錄。

注意

本文隨附下載中提供的快取層並不完整。 它只包含一個類別,ProductsCL,它只提供少數方法。 而且,只有單一 ASP.NET 頁面使用了 CL (~/Caching/FromTheArchitecture.aspx),所有其他頁面仍然直接引用 BLL。 如果您打算在應用程式中使用 CL,則來自表示層的所有呼叫都應轉到 CL,這將要求 CL 的類別和方法覆寫表示層目前使用的 BLL 中的那些類別和方法。

摘要

雖然可以使用 ASP.NET 2.0 SqlDataSource 和 ObjectDataSource 控制項在表示層套用快取,但理想情況下,將快取職責委託給體系結構中的單獨層。 在本教學課程中,我們建立了一個位於表示層和業務邏輯層之間的快取層。 快取層需要提供與 BLL 中存在的相同的類別和方法集,並從表示層呼叫。

我們在本教程及之前的教程中探索的快取層範例展示了反應式載入。 透過反應式加載,僅當發出資料請求並且快取中缺少該資料時,資料才會加載到快取中。 資料還可以主動載入到快取中,這是一種在實際需要資料之前將資料載入到快取中的技術。 在下一個教學中,當我們了解如何在應用程式啟動時將靜態值儲存到快取中時,我們將看到主動載入的範例。

快樂程式!

關於作者

斯科特·米切爾,七本 ASP/ASP.NET 書籍和 4GuysFromRolla.com 創始人的作者,自1998年以來一直與Microsoft Web 技術合作。 史考特是一名獨立顧問、培訓師和作家。 他的最新著作是《Sams Teach Yourself ASP.NET 2.0 in 24 Hours》。 他可以聯絡到 mitchell@4GuysFromRolla.com。

特別感謝

本教學系列得到了許多有用的審閱者的審閱。 本教學課程的首席審閱者是 Teresa Murph。 有興趣查看我即將發表的 MSDN 文章嗎? 如果是,請在 mitchell@4GuysFromRolla.com給我留言。