版本

　　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()方法手动读写和删除缓存对象。

　　//正文结束