NBearV3教程——Cache篇

版本

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:\Teddy\NBearV3\src\NBear.Test.UnitTests\EntityConfig.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()方法手动读写和删除缓存对象。

//正文结束

//本文结束