org.apache.ignite.cache.hibernate

Class HibernateQueryResultsRegion

java.lang.Object

org.hibernate.cache.spi.support.AbstractRegion

org.apache.ignite.cache.hibernate.HibernateRegion

org.apache.ignite.cache.hibernate.HibernateGeneralDataRegion

org.apache.ignite.cache.hibernate.HibernateQueryResultsRegion

All Implemented Interfaces:

org.hibernate.cache.spi.DirectAccessRegion, org.hibernate.cache.spi.ExtendedStatisticsSupport, org.hibernate.cache.spi.QueryResultsRegion, org.hibernate.cache.spi.Region

public class HibernateQueryResultsRegion
extends HibernateGeneralDataRegion
implements org.hibernate.cache.spi.QueryResultsRegion

Implementation of QueryResultsRegion. This region is used to store query results.

Query results caching can be enabled in the Hibernate configuration file:

 <hibernate-configuration>
     <!-- Enable L2 cache. -->
     <property name="cache.use_second_level_cache">true</property>

     <!-- Enable query cache. -->
     <property name="cache.use_second_level_cache">true</property>

     <!-- Use Ignite as L2 cache provider. -->
     <property name="cache.region.factory_class">org.apache.ignite.cache.hibernate.HibernateRegionFactory</property>

     <!-- Specify entity. -->
     <mapping class="com.example.Entity"/>

     <!-- Enable L2 cache with nonstrict-read-write access strategy for entity. -->
     <class-cache class="com.example.Entity" usage="nonstrict-read-write"/>
 </hibernate-configuration>
 

By default queries are not cached even after enabling query caching, to enable results caching for a particular query, call Query.setCacheable(boolean):

     Session ses = getSession();

     Query qry = ses.createQuery("...");

     qry.setCacheable(true); // Enable L2 cache for query.
 

Note: the query cache does not cache the state of the actual entities in the cache, it caches only identifier values. For this reason, the query cache should always be used in conjunction with the second-level cache for those entities expected to be cached as part of a query result cache

Field Summary

Fields inherited from class org.apache.ignite.cache.hibernate.HibernateRegion

cache, ignite

Constructor Summary

Constructors

Constructor and Description
HibernateQueryResultsRegion(HibernateRegionFactory factory, String name, Ignite ignite, HibernateCacheProxy cache)

Method Summary

Methods inherited from class org.apache.ignite.cache.hibernate.HibernateGeneralDataRegion

evict, evictAll, get, put

Methods inherited from class org.apache.ignite.cache.hibernate.HibernateRegion

clear, destroy, getElementCountInMemory, getElementCountOnDisk, getSizeInMemory

Methods inherited from class org.hibernate.cache.spi.support.AbstractRegion

getName, getRegionFactory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.hibernate.cache.spi.DirectAccessRegion

getFromCache, putIntoCache

Methods inherited from interface org.hibernate.cache.spi.Region

clear, destroy, getName, getRegionFactory

Constructor Detail

HibernateQueryResultsRegion

public HibernateQueryResultsRegion(HibernateRegionFactory factory,
                                   String name,
                                   Ignite ignite,
                                   HibernateCacheProxy cache)

Parameters:

factory - Region factory.

name - Region name.

ignite - Grid.

cache - Region cache.