NHibernate 缓存

NHibernate 支持两种级别的缓存，即一级缓存以及二级缓存。

一级缓存

一级缓存就是 ISession 缓存，在 ISession 的生命周期内可用，多个 ISession 之间不能共享缓存的对象，通过 ISessionFactory 创建的 ISession 默认支持一级缓存，不需要特殊的配置。在 NHibernate 的参考文档中，对 ISession 的描述如下：

A single-threaded, short-lived object representing a conversation between the application and the persistent store. Wraps an ADO.NET connection. Factory for ITransaction. Holds a mandatory (first-level) cache of persistent objects, used when navigating the object graph or looking up objects by identifier. looking up objects by identifier.

注意最后一句，明确说明了一级缓存的用途：

在对象树种导航、浏览时，使用一级缓存；
根据对象的 id 加载对象；

由此可以看出，一级缓存的作用是比较有限的，但是也有用得着的地方。

一级缓存测试

一级缓存缓存无需配置，默认支持，因此，在使用 session 查询对象，如果仅仅是根据 id 加载指定的对象，需要使用 session 的 Get 或 Load 方法，这样可以充分利用 session 的一级缓存，下面是一些测试用例以及输出：

1、测试一级缓存

[Test]
public void TestSessionLoad() {using (var session = this._sessionFactory.OpenSession()) {Console.WriteLine("Before Load Category");var cat = session.Get<Category>(1);Console.WriteLine("{0}, {1}", cat.CategoryID, cat.CategoryName);cat = session.Get<Category>(1);Console.WriteLine("{0}, {1}", cat.CategoryID, cat.CategoryName);}
}

在上面的测试中，两次加载同一个实体类，该测试的输出为：

First get category 1
NHibernate: SELECTcategory0_.[CategoryID] as column1_0_0_,category0_.[CategoryName] as column2_0_0_,category0_.[Description] as column3_0_0_,category0_.[Picture] as column4_0_0_ FROM[dbo].[Categories] category0_ WHEREcategory0_.[CategoryID]=@p0;@p0 = 1 [Type: Int32 (0)]
1, Beverages
second get category 1
1, Beverages

从输出可以看到，只有第一次调用 Get 方法加载实体类时，有 sql 输出，从数据库取出了数据，第二次加载则没有 sql 数据，也就是利用了 session 的一级缓存。

2、测试 Get 与 Load 方法

session 提供了 Get 和 Load 两个方法，这两个方法有什么区别呢？我的测试代码如下：

[Test]
public void TestSessionGet() {using (var session = this._sessionFactory.OpenSession()) {Console.WriteLine("Before Get Category");var cat = session.Get<Category>(1);Console.WriteLine("After Get Category");}
}

对应的输出代码如下：

Before Get Category
NHibernate: SELECTcategory0_.[CategoryID] as column1_0_0_,category0_.[CategoryName] as column2_0_0_,category0_.[Description] as column3_0_0_,category0_.[Picture] as column4_0_0_ FROM[dbo].[Categories] category0_ WHEREcategory0_.[CategoryID]=@p0;@p0 = 1 [Type: Int32 (0)]
After Get Category

从输出可以看到，调用 Get 方法之后， Nh 立刻从数据库加载实例，接下来看对 Load 方法的测试：

[Test]
public void TestSessionLoad() {using (var session = this._sessionFactory.OpenSession()) {Console.WriteLine("Before Load Category");var cat = session.Load<Category>(1);Console.WriteLine("After Load Category");Console.WriteLine("{0}, {1}", cat.CategoryID, cat.CategoryName);}
}

对应的输出代码为：

Before Load Category
After Load Category
NHibernate: SELECTcategory0_.[CategoryID] as column1_0_0_,category0_.[CategoryName] as column2_0_0_,category0_.[Description] as column3_0_0_,category0_.[Picture] as column4_0_0_ FROM[dbo].[Categories] category0_ WHEREcategory0_.[CategoryID]=@p0;@p0 = 1 [Type: Int32 (0)]
1, Beverages

可以看出，调用完 Load 方法之后， nh 并没有立即从数据库加载实体，而是等到读取实体类属性时，才从数据库加载，也就是说， Load 方法是延迟加载的。

测试Query

根据文档的描述，用 session 查询对象，应该是不能利用一级缓存的，我们来测试一下：

[Test]
public void TestSessionLambdaQuery() {using (var session = this._sessionFactory.OpenSession()) {(from c in session.Query<Category>()where c.CategoryID == 1select c).First();(from c in session.Query<Category>()where c.CategoryID == 1select c).First();}
}

该测试用例的输出如下：

NHibernate: selectTOP (1)  category0_.[CategoryID] as column1_0_,category0_.[CategoryName] as column2_0_,category0_.[Description] as column3_0_,category0_.[Picture] as column4_0_ from[dbo].[Categories] category0_ wherecategory0_.[CategoryID]=@p0;@p0 = 1 [Type: Int32 (0)]
NHibernate: selectTOP (1)  category0_.[CategoryID] as column1_0_,category0_.[CategoryName] as column2_0_,category0_.[Description] as column3_0_,category0_.[Picture] as column4_0_ from[dbo].[Categories] category0_ wherecategory0_.[CategoryID]=@p0;@p0 = 1 [Type: Int32 (0)]

从输出可以看出，用 session 查询对象，确实不能利用一级缓存。

注意：如果查询时不想使用一级缓存，可以 StatelessSession 对象，和 Session 对象用法一样，只是该对象没有一级缓存。

一级缓存管理

一级缓存的管理也是很简单的，可以通过下面的三个方法管理：

session.Evict 从一级缓存中删除指定的实例；
session.Clear 清空一级缓存，不会保存修改的内容；
session.Contains 检查实例是否存在于一级缓存中。

二级缓存

二级缓存是 SessionFactory 级别的缓存，也就是数据库级别的缓存，可以被同一个 SessionFactory 创建的所有 session 共享。

启用二级缓存

Nh 默认未启用二级缓存，启用二级缓存需要如下步骤：

1、在 hibernate.cfg.xml 文件中添加下面三个属性：

<property name="cache.provider_class">NHibernate.Cache.HashtableCacheProvider</property>`
<property name="cache.use_second_level_cache">true</property>`
<property name="cache.use_query_cache">true</property>`

这三个属性的作用是显而易见的，第一个是指定使用什么二级缓存的实现，第二个是启用二级缓存，第三个是为查询启用二级缓存缓存。

NHibernate 的二级缓存是可以扩展的， NHibernate.ControlLib 提供了几个实现，分别适用于不同的场景：

NHibernate.Caches.MemCache
NHibernate.Caches.Prevalence
NHibernate.Caches.SharedCache
NHibernate.Caches.SysCache
NHibernate.Caches.SysCache2
NHibernate.Caches.Velocity

这些实现都是

2、配置指定的实体类、集合启用二级缓存缓存

在 hibernate.cfg.xml 文件中添加下面的设置：

<class-cache class="HibernateTest.Models.Category" usage="read-only" include="all"/>

这一句表示对实体类 HibernateTest.Models.Category 启用二级缓存，在实际项目中，可以根据需要对多个实体类启用二级缓存。也可以在实体类的 hbm 映射文件中配置使用二级缓存，不过在 hibernate.cfg.xml 文件中统一配置是推荐的做法。

二级缓存测试

二级缓存的几个测试用例如下：

1、测试 Get 方法：

[Test]
public void TestGetEntity() {using (var session = this._sessionFactory.OpenSession()) {session.Get<Category>(1);}using (var session = this._sessionFactory.OpenSession()) {session.Get<Category>(1);}
}

对应的输出为：

NHibernate: SELECTcategory0_.[CategoryID] as column1_0_0_,category0_.[CategoryName] as column2_0_0_,category0_.[Description] as column3_0_0_,category0_.[Picture] as column4_0_0_ FROM[dbo].[Categories] category0_ WHEREcategory0_.[CategoryID]=@p0;@p0 = 1 [Type: Int32 (0)]

从测试用例的输出可以看出，二级缓存时可以在不同的 session 之间共享。

2、测试 HQL 查询：

[Test]
public void TestHqlQuery() {using (var session = this._sessionFactory.OpenSession()) {var query = session.CreateQuery("from Category").SetCacheMode(CacheMode.Normal).SetCacheRegion("AllCategories").SetCacheable(true);query.List<Category>();}using (var session = this._sessionFactory.OpenSession()) {var query = session.CreateQuery("from Category").SetCacheMode(CacheMode.Normal).SetCacheRegion("AllCategories").SetCacheable(true);query.List<Category>();}
}

对应的输出为：

NHibernate: selectcategory0_.[CategoryID] as column1_0_,category0_.[CategoryName] as column2_0_,category0_.[Description] as column3_0_,category0_.[Picture] as column4_0_ from[dbo].[Categories] category0_

3、测试 Linq 查询：

[Test]
public void TestLinqQuery() {using (var session = this._sessionFactory.OpenSession()) {var query = session.Query<Category>().Cacheable().CacheMode(CacheMode.Normal).CacheRegion("AllCategories");var result = query.ToList();}using (var session = this._sessionFactory.OpenSession()) {var query = session.Query<Category>().Cacheable().CacheMode(CacheMode.Normal).CacheRegion("AllCategories");var result = query.ToList();}
}

对应的输出为：

NHibernate: selectcategory0_.[CategoryID] as column1_0_,category0_.[CategoryName] as column2_0_,category0_.[Description] as column3_0_,category0_.[Picture] as column4_0_ from[dbo].[Categories] category0_

4、测试 QueryOver 查询：

[Test]
public void TestQueryOver() {using (var session = this._sessionFactory.OpenSession()) {var query = session.QueryOver<Category>().Cacheable().CacheMode(CacheMode.Normal).CacheRegion("AllCategories");query.List();}using (var session = this._sessionFactory.OpenSession()) {var query = session.QueryOver<Category>().Cacheable().CacheMode(CacheMode.Normal).CacheRegion("AllCategories");query.List();}
}

对应的输出为：

NHibernate: SELECTthis_.[CategoryID] as column1_0_0_,this_.[CategoryName] as column2_0_0_,this_.[Description] as column3_0_0_,this_.[Picture] as column4_0_0_ FROM[dbo].[Categories] this_

二级缓存选项

NHibernate 二级有几个配置选项，他们分别是：

实体类以及集合二级缓存配置选项

指定类：

<class-cache class="类名称" region="默认类名称" include="all|non-lazy"usage="read-only|read-write|nonstrict-read-write|transactional" />

指定集合：

<collection-cache collection ="集合名称" region="默认集合名称"usage="read-only|read-write|nonstrict-read-write|transactional"/>

region：可选，默认值为类或集合的名称，用来指定二级缓存的区域名，对应于缓存实现的一个命名缓存区域。
include：可选，默认值为all，当取non-lazy时设置延迟加载的持久化实例的属性不被缓存。
usage：声明缓存同步策略，就是上面说明的四种缓存策略。

查询二级缓存配置

Cacheable 为一个查询显示启用二级缓存；
CacheMode 缓存模式，有如下可选：
1. Ignore：更新数据时将二级缓存失效，其它时间不和二级缓存交互
2. Put：向二级缓存写数据，但不从二级缓存读数据
3. Get：从二级缓存读数据，仅在数据更新时向二级缓存写数据
4. Normal：默认方式。从二级缓存读/写数据
5. Refresh：向二级缓存写数据，想不从二级缓存读数据，通过在配置文件设置cache.use_minimal_puts从数据库中读取数据时，强制二级缓存刷新
CacheRegion 给查询缓存指定了特定的命名缓存区域，如果两个查询相同，但是指定的 CacheRegion 不同，则也会从数据库查询数据。

以上是在项目中用到的二级缓存相关知识的整理，肯定不完整， NHibernate 的缓存还有更多的地方需要挖掘。