01-08-03【Nhibernate (版本3.3.1.4000) 出入江湖】二级缓存：NHibernate自带的HashtableProvider之查询缓存

打开查询缓存，

第一步：需要在hbernate.cfg.xml中设置：

<!--4.启动查询缓存-->
<property name="cache.use_query_cache">true</property>

第二步：需要显式的使用IQuery.SetCacheable(true)方法

/// <summary>
/// 使用查询缓存的HQL查询
/// </summary>
/// <param name="customerId"></param>
/// <returns></returns>
public Customer GetCustomerUsingHqlAndSetCacheable(int customerId)
{
Customer result = null;
ISession session = _sessionManager.GetSession();

try
{

result = session.CreateQuery("from Customer c where c.CustomerId=:paraCustomerId")
.SetInt32("paraCustomerId", customerId)
.SetCacheable(true) //如果需要对查询缓存，还需要显式的使用IQuery.SetCacheable(true)方法
.List<Customer>().First();
}
catch (Exception)
{
throw;
}
finally
{
session.Close();
}

return result;
}

测试一和结果：

NHibernate:
INSERT
INTO
Customer
(Version, Firstname, Lastname, Age)
VALUES
(@p0, @p1, @p2, @p3);
select
SCOPE_IDENTITY();
@p0 = 1 [Type: Int32 (0)],
@p1 = 'Test' [Type: String (4000)],
@p2 = 'TestSessionFactoryCache' [Type: String (4000)],
@p3 = 10 [Type: Int32 (0)]
NHibernate:
INSERT
INTO
[

Order] (
Version, OrderDate, CustomerId
)
VALUES
(@p0, @p1, @p2);
select
SCOPE_IDENTITY();
@p0 = 1 [Type: Int32 (0)],
@p1 = 2014/5/30 0:52:54 [Type: DateTime (0)],
@p2 = 217 [Type: Int32 (0)]
第1次获取数据------------------------------：
NHibernate:
select
customer0_.CustomerId as CustomerId0_,
customer0_.Version as Version0_,
customer0_.Firstname as Firstname0_,
customer0_.Lastname as Lastname0_,
customer0_.Age as Age0_
from
Customer customer0_
where
customer0_.CustomerId=@p0;
@p0 = 217 [Type: Int32 (0)]
更新前：Id:217-->FirtstName:Test
第2次获取数据==============================：
Id:217-->FirtstName:Test

View Code

---------------------------------------------------------------

其他资料：

启用缓存查询

在NHibernate中，除了缓存持久化类和集合外，查询结果集也可以缓存。如果程序中经常使用同样的条件查询数据，则可以使用查询缓存。在配置文件中可以指定启动查询缓存

<property name="cache.use_query_cache">true</property>

查询缓存后，NHibernate将创建两个缓存区域。一个用于保存查询结果集，由NHibernate.Cache.StandardQueryCache实现。一个用来保存最近更新的查询表的时间截，由NHibernate.Cache.UpdateTimestampsCache实现。

查询缓存中的结果集并不是永久有效的。当缓存的查询语句对应的数据库发生改变时，该缓存结果随之失效。因而对大多数查询而言，查询缓存的益处不是很大，所以NHibernate在默认情况下不对查询进行缓存。

如果需要对查询缓存，还需要显式的使用IQuery.SetCacheable(true)方法。IQuery调用这个方法后，NHibernate将根据查询语句、查询参数、结果集起始范围等信息组成一个IQueryKey。接着根据这个IQueryKey到查询缓存中查找相应数据，查询成功则直接返回查找结果。否则，查询数据库，获取结果集，并把结果集根据IQueryKey放入查询缓存。如果IQueryKey数据发生改变(增加、删除、修改等)，这些IQueryKey及其对象的结果集将从缓存中删除。

测试2：显式启用缓存查询

这个例子显式使用IQuery.SetCacheable(true)方法缓存查询结果，第二次查询相同条件时，直接从缓存查询中读取。

[Test]

public void QueryCacheTest()

{

using (_session)

{

Console.WriteLine("第一次查询某数据，显式缓存查询结果");

IList<Customer> customers =

_session.CreateQuery("from Customer c where c.CustomerId > 2")

.SetCacheable(true)

.List<Customer>();

Assert.AreEqual(11, customers.Count);

}

ResetSession();

using (_session)

{

Console.WriteLine("第二次查询某数据，显式缓存查询结果");

IList<Customer> customers =

_session.CreateQuery("from Customer c where c.CustomerId > 2")

.SetCacheable(true)

.List<Customer>();

Assert.AreEqual(11, customers.Count);

}

}

测试3：指定命名缓存区域

我们还可以使用.SetCacheRegion("cacheRegion"), 给查询缓存指定了特定的命名缓存区域，该查询缓存的缓存策略将由二级缓存的命名区域负责：

[Test]

public void QueryCacheTest()

{

using (_session)

{

Console.WriteLine("第一次查询某数据，显式缓存查询结果");

IList<Customer> customers =

_session.CreateQuery("from Customer c where c.CustomerId > 2")

.SetCacheable(true)

.SetCacheRegion("queryCache")

.List<Customer>();

Assert.AreEqual(11, customers.Count);

}

ResetSession();

using (_session)

{

Console.WriteLine("第二次查询某数据，显式缓存查询结果");

IList<Customer> customers =

_session.CreateQuery("from Customer c where c.CustomerId > 2")

.SetCacheable(true)

.SetCacheRegion("queryCache")

.List<Customer>();

Assert.AreEqual(11, customers.Count);

}

}

测试结果说明：第一次查询出来的结果集被存储在名为queryCache的缓存区域，第二次同样在这个缓存区域里寻找需要数据，如果第二次没有指定或者指定别的缓存区域则没有需要的数据，就要到数据库中查询了。

测试4：命名查询

可以在映射文件中定义命名查询，<query>元素提供了很多属性，可以用于缓存结果，这里，我举一个例子吧，在Customer.hbm.xml映射文件中定义名为selectCustomer的查询由于查询所有Customer并启用缓存查询，缓存模式为默认方式(下面有说明)

<query cacheable ="true" cache-mode="normal" name="selectCustomer">

from Customer

</query>

编写一个方法：

[Test]

public void NamedQueryCacheTest()

{

using (_session)

{

Console.WriteLine("--->第一次使用命名查询");

IList<Customer> customers = _session.GetNamedQuery("selectCustomer")

.List<Customer>();

}

ResetSession();

using (_session)

{

Console.WriteLine("--->第二次使用命名查询");

IList<Customer> customers = _session.GetNamedQuery("selectCustomer")

.List<Customer>();

}

}

NHibernate提供的查询(HQL、条件查询、原生SQL查询)都类似，我在这里就不重复举例了，大家可以测试下。

管理NHibernate二级缓存

NHibernate二级缓存由ISessionFactory创建并由ISessionFactory自行维护。我们使用NHibernate操作数据时，ISessionFactory能够自动同步缓存，保证缓存的有效性。但是当我们批量操作数据时，往往NHibernate不能维护缓存持久有效。ISessionFactory提供了可编程方式的缓存管理方法。

ISessionFactory提供了一系列的EvictXXX()方法可以方便的从二级缓存中删除一个实例、删除一个集合、一个命名缓存等操作

•Evict(persistentClass)：从二级缓存中删除persistentClass类所有实例

•Evict(persistentClass, id)：从二级缓存中删除指定的持久化实例

•EvictEntity(entityName)：从二级缓存中删除命名实例

•EvictCollection(roleName)：从二级缓存中删除集合

•EvictCollection(roleName, id)：从二级缓存中删除指定的集合

•EvictQueries()：从二级缓存中刷新全部查询结果集

•EvictQueries(cacheRegion)：从二级缓存中刷新指定查询结果集

ISession内置缓存可以共享ISessionFactory缓存，通过指定ISession的CacheMode可以控制ISession和ISessionFactory的交互方式。ISession可以通过以下五种方式和ISessionFactory交互：

•Ignore：更新数据时将二级缓存失效，其它时间不和二级缓存交互

•Put：向二级缓存写数据，但不从二级缓存读数据

•Get：从二级缓存读数据，仅在数据更新时向二级缓存写数据

•Normal：默认方式。从二级缓存读/写数据

•Refresh：向二级缓存写数据，想不从二级缓存读数据，通过在配置文件设置cache.use_minimal_puts从数据库中读取数据时，强制二级缓存刷新