NBearV3教程——Cache篇

NBearV3教程——Cache篇2010-07-13 cnblogs teddyma版本

1.0 [2006-11-18]

简介

本教程介绍NBearV3中的查询缓存支持。

目标

通过本教程，读者应能够全面掌握内置于NBearV3的查询缓存的使用。

代码

本教程不包含任何演示代码。

时间

<10分钟。

正文

1 配置及启用NBearV3中的缓存功能

要启用缓存支持，需要在Web.config或App.config中添加cacheConfig配置节：

<？xml version="1.0" encoding="utf-8" ？>
<configuration>
<configSections>
  <section name="entityConfig" type="NBear.Common.EntityConfigurationSection, NBear.Common" />
  <section name="cacheConfig" type="NBear.Data.CacheConfigurationSection, NBear.Data" />
</configSections>
<entityConfig>
  <includes>
   <add key="Sample" value="C:TeddyNBearV3srcNBear.Test.UnitTestsEntityConfig.xml" />
  </includes>
</entityConfig>
<cacheConfig enable="true">
  <cachingTables>
   <add key="Northwind.Orders" value="5" />
  </cachingTables>
</cacheConfig>
<connectionStrings>
  <add name="Northwind" connectionString="Server=（local）;Database=Northwind;Uid=sa;Pwd=sa" providerName="NBear.Data.SqlServer.SqlDbProvider"/>
</connectionStrings>
</configuration>

注意代码中粗体的部分，首先在

configSections中添加cacheConfig这个section。接着，添加一个cacheConfig配置节，其中的cachingTables中可以有多个add，每一个add中，key的值格式为AAA.BBB；value代表缓存有效的时间长度，单位为秒。

AAA代表对应的ConnectionString中的name。比如这里的Northwind代表了名为Northwind的ConnectionString。

BBB代表数据库中实际的表名、视图名或存储过程名。

2 在代码中启用、禁用和使用自动缓存

一旦如上配置了启用缓存，则默认情况下，所有的NBear.Data.Gateway实例，默认将是开启了自动缓存功能的。相应的表、视图或存储过程被查询时，如果在config中设置为需要缓存的，则会被缓存。可以调用Gateway.TurnOnCache（）和TurnOffCache（）方法开启和关闭一个Gateway的缓存支持。

在两种情况下，自动缓存会自动过期失效。一是被缓存的数据超过config中设置的缓存过期时间；二是，指定的过期时间还没到，但是，此时执行了对该实体的强类型写操作。所谓强类型写操作，指Gateway.Delete/Save/BatchDelete/BatchUpdate等这些带范型参数列表EntityType的范型方法。

注：所有缓存数据是作为一个Gateway的静态变量，对所有的Gateway可见并共享的。也就是说，即使有多个Gateway实例，他们共享所有的缓存数据。并且，即使一个禁用了缓存的Gateway实例，对他执行的强类型写数据库操作，也会导致全局的Gateway缓存中的对应实体的缓存数据过期。

3 在代码中使用自定义缓存

除了默认的自动缓存之外，也可以手动的使用自定义缓存。任何时候，我们都可以使用任何Gateway实例的AddCache（）/GetCache（）/RemoveCache（）和RemoveCaches（）方法手动读写和删除缓存对象。

//正文结束