快速入门使用了一个顶层的处理程序来捕获任何场景中的任何异常。处理程序显示了一个带有异常信息的对话框。
快速入门在构建和运行应用程序之前不需要执行任何安装步骤。[注意:默认的快速入门配置不使用持久后端存储。]
快速入门提供两个版本。第一个版本使用工厂创建Enterprise Library 对象,例如使用CacheFactory.GetCacheManager 方法创建CacheManager 实例, 以及使用new操作符创建ProductData 实例。
第二个版本演示了集成Unity 应用程序块。创建和填充UnityContainer 实例是使用配置文件中<unity>配置节的数据。这会加载Enterprise Library 核心和缓存应用程序块扩展。在这个快速入门也使用UnityContainer的Resolve 方法创建Main Form实例,从而导致Unity创建和注入Main Form所需要的CacheManager 和ProductData 实例,他们是通过构造函数注入的。
构建并运行快速入门
快速入门以源代码的形式发布,这意味着在运行之前必须编译它,可以使用 Visual Studio 来构建快速入门。
构建缓存快速入门
- 确认已安装 Enterprise Library 源代码
- 从 Windows 资源管理器中打开 Enterprise Library 源码文件夹,或者用开始菜单快捷方式打开:在任务栏中,单击 开始 ,指向 程序 ,指向 Microsoft patterns and practices ,指向 Enterprise Library 4.0 – May 2008 ,然后选择 Enterprise Library 4.0 Source Folder 。
- 运行集成Unity应用程序块的实例,打开 QuickStarts 文件夹,然后是 Cache ,然后是 CS-UnityIntegration (用于 C#)或者 VB-UnityIntegration (用于 Visual Basic .NET)。
- 双击 CachingQuickStart.sln 图标。
- Visual Studio 打开、显示解决方案文件。在菜单中,单击 生成 。
- 单击 重新生成解决方案 。默认情况下,这是一个 debug 构建。
- 按下 F5 运行快速入门。
快速入门配置
快速入门配置信息放置在快速入门项目的文件夹中,它具有下列属性:
- 用于缓存操作节的缓存管理器被命名为“Default Cache Manager”。用于主动和被动加载缓存的节的缓存管理器被命名为“Loading Scenario Cache Manager”。
- 数据仅写在内存中(而不是后端存储)。
- 每 60 秒发生一次到期周期。
- 在缓存中有 1000 个条目时发生清理。
- 从缓存中清理移除 10 个条目。
快速入门中的漫游带有定义好的配置,它被包括在 App.config 文件中。这个文件放置在快速入门项目文件的文件夹中。
要修改或查看这些设置,使用 Enterprise Library 配置控制台打开包含快速入门项目文件目录中的 App.config 文件。App.config 包含了配置数据。
在每次构建代码时,Visual Studio 复制 App.config 文件到项目的输出目录中(创建的快速入门可执行文件的目录),并改名为 CachingQuickStart.exe.config 。
这意味着如果要使用配置控制台修改任何配置设置,如到期周期,并且计划重建解决方案,就必须打开快速入门源目录中的 App.config 文件来修改配置。可以用配置控制台打开 CachingQuickStart.exe.config 文件。然而,这些改变将在下次成功构建中被覆盖。
这意味着当使用配置控制台打开 App.config 文件并修改配置设置时,必须复制文件到输出目录。可以手工复制,也可以重建项目来完成此目的。记住,简单的修改配置设置没有必要重建代码。运行在成功构建之上的命令是为了方便构建。
漫游:添加条目到缓存中
漫游示范了如何添加条目到缓存中。
重建示例
1. 配置缓存。必要的步骤,请参见输入配置信息。
2. 在 QuickStartForm 类中为 CacheManager 对象声明一个成员变量。
private ICacheManager primitivesCache;
3.在 QuickStart_Load 方法中,添加下列代码以创建 CacheManager 。对 GetCacheManager 的调用没有包含CacheManager 的名称,所以工厂创建了声明在配置文件中的默认 CacheManager 对象。
this.primitivesCache = CacheFactory.GetCacheManager();
4. 创建要添加到缓存中的条目。下列代码创建了一个 Product 类型的条目。
string id="ProductOneId";
string name = "ProductOneName";
int price = 50;
Product product = new Product(id, name, price);
5. 添加条目到缓存中。下列代码使用了 Add 方法的一个重载,重载包含清理优先级(在此为2),条目在到期时不刷新的指令、从条目的最后访问时间开始的5分钟的到期时间。
primitivesCache.Add(product.ProductID, product, CacheItemPriority.Normal, null,
new SlidingTime(TimeSpan.FromMinutes(5)));
漫游:从缓存中移除条目
此漫游示范了如何从缓存中移除条目。
重建此示例
1. 配置缓存。必要的步骤,请参见缓存快速入门中的“快速入门配置”。
2. 在 QuickStartForm 类中为 CacheManager 对象声明一个成员变量。
private ICacheManager primitivesCache;
3. 在响应用户请求从缓存中移除条目的方法中,添加下列代码。
// Prompt the user for the key of the item to be removed. if (this.selectItemForm.ShowDialog() == DialogResult.OK) { // Request that the item be removed from the cache. this.primitivesCache.Remove(selectItemForm.ItemKey); }
漫游:从缓存中获取条目
此漫游示范了如何从缓存中获取条目。
重建示例
1. 配置缓存。必要步骤,请参见缓存快速入门中的“快速入门配置”。
2. 在 QuickStartForm 类中为 CacheManager 对象声明一个成员变量。
private ICacheManager primitivesCache;
3. 在响应用户请求从缓存中读取条目的方法中,添加下列代码。
// Prompt the user for the key of the item to be read. if (this.selectItemForm.ShowDialog() == DialogResult.OK) { // Read the item from the cache. If the item is not found in the cache, the // return value will be null. Product product = (Product) this.primitivesCache.GetData(selectItemForm.ItemKey); }
漫游:清除缓存
此漫游示范了如何清除缓存,清空缓存中的所有数据。
重建此示例
1. 配置缓存。必要步骤,请参见缓存快速入门中的“快速入门配置”。
2. 在 QuickStartForm 类中为 CacheManager 对象声明一个成员变量。
private ICacheManager primitivesCache;
3. 在响应用户请求清空缓存的方法中,添加下列代码。
this.primitivesCache.Flush();
漫游:加载缓存
快速入门的此节说明了如何主动加载缓存和如何被动加载缓存。
解决方案概述
图 1 说明了快速入门如何从缓存中获取数据。
图 1 说明了如何几点:
- 简单的产品数据被包含在 XML 文件 CachingQuickStartData.xml 中。
- DataProvider 对象从 XML 文件中读取产品数据。
- ProductData 对象使用 DataProvider 类获得添加到缓存中的产品数据。
- QuickStartForm 对象通过调用 ProductData 对象获取产品信息。在查询产品信息时,ProductData 首先在缓存中查找,如果找到,返回信息。对于没有在缓存中的条目,ProductData 对象使用 DataProvider 来从文件中获取数据,然后添加到缓存中。
主动加载缓存
可以主动缓存数据以获取应用程序和进程所需要的所有状态,通常在应用程序或者进程启动时,可以在应用程序或者进程的整个生命周期内缓存数据。
主动加载缓存
1. 配置缓存,定义名为 Loading Scenario Cache Manager 的 CacheManager 的对象。对于必要的步骤,请参见缓存快速入门中“快速入门的配置”。
2. 在 ProductData 类中定义用于 CacheManager 对象的成员变量。
private ICacheManager cache;
3. 通过添加下列代码来创建 CacheManager 对象。工厂使用在配置文件中的名称来创建 CacheManager 对象。
cache = CacheFactory.GetCacheManager("Loading Scenario Cache Manager");
4. 从 XML 文件中加载完整的数据集到缓存中。
List<Product> list = this.dataProvider.GetProductList();
for (int i = 0; i < list.Count; i++)
{
Product product = listi;
cache.Add(product.ProductID, product);
}
被动加载缓存
可以被动的缓存数据以获取应用程序请求的数据,并缓存它以备以后的请求使用。
被动加载缓存
1. 配置缓存,定义名为 Loading Scenario Cache Manager 的 CacheManager 的对象。对于必要的步骤,请参见缓存快速入门中“快速入门的配置”。
2. 在 ProductData 类中定义用于 CacheManager 对象的成员变量。
private ICacheManager cache;
3. 通过添加下列代码来创建 CacheManager 对象。工厂使用在配置文件中的名称来创建 CacheManager 对象。
cache = CacheFactory.GetCacheManager("Loading Scenario Cache Manager");
4. 添加下列在请求以获取 Product 时将执行的代码。
Product product = (Product)cache.GetData(productID); // Does our cache already have the requested object? if (product == null) { // Requested object is not cached; therefore, retrieve it from // the data provider and cache it for more requests. product = this.dataProvider.GetProductByID(productID); if (product != null) { cache.Add(productID, product); } } return product;
缓存与主数据源的比较
要查看在缓存中的数据与主数据源中的数据有什么不同,单击 Edit Master Data 按钮,然后修改 XML 文件中的某些值。如果在主数据修改之前条目已经在缓存中,并在修改后从缓存中获取它,从缓存中获取的数据将与主数据源中的数据不匹配。
本文来自云栖社区合作伙伴“doNET跨平台”,了解相关信息可以关注“opendotnet”微信公众号