org.gridgain.grid.cache.hibernate

Class GridHibernateCollectionRegion

java.lang.Object

org.gridgain.grid.cache.hibernate.GridHibernateRegion

org.gridgain.grid.cache.hibernate.GridHibernateTransactionalDataRegion

org.gridgain.grid.cache.hibernate.GridHibernateCollectionRegion

All Implemented Interfaces:

org.hibernate.cache.spi.CollectionRegion, org.hibernate.cache.spi.Region, org.hibernate.cache.spi.TransactionalDataRegion

public class GridHibernateCollectionRegion
extends GridHibernateTransactionalDataRegion
implements org.hibernate.cache.spi.CollectionRegion

Implementation of CollectionRegion. This region is used to store collection data.

L2 cache for collection can be enabled in the Hibernate configuration file:

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

     <!-- Use GridGain as L2 cache provider. -->
     <property name="cache.region.factory_class">org.gridgain.grid.cache.hibernate.GridHibernateRegionFactory</property>

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

     <!-- Enable L2 cache with nonstrict-read-write access strategy for entities and collection. -->
     <collection-cache collection="com.example.Entity" usage="nonstrict-read-write"/>
     <collection-cache collection="com.example.ChildEntity" usage="nonstrict-read-write"/>
     <collection-cache collection="com.example.Entity.children" usage="nonstrict-read-write"/>
 </hibernate-configuration>
 

Also cache for collection can be enabled using annotations:

 @javax.persistence.Entity
 public class Entity {
    ...

    @javax.persistence.OneToMany(cascade=CascadeType.ALL, fetch=FetchType.EAGER)
    @javax.persistence.JoinColumn(name="PARENT_ID")
    @org.hibernate.annotations.Cache(usage = CacheConcurrencyStrategy.NONSTRICT_READ_WRITE)
    public List<ChildEntity> getChildren() {...}
 }
 

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

Field Summary

Fields inherited from class org.gridgain.grid.cache.hibernate.GridHibernateRegion

cache, factory, grid

Constructor Summary

Constructors

Constructor and Description
GridHibernateCollectionRegion(GridHibernateRegionFactory factory, String name, org.gridgain.grid.Grid grid, org.gridgain.grid.cache.GridCache<Object,Object> cache, org.hibernate.cache.spi.CacheDataDescription dataDesc)

Method Summary

Methods

Modifier and Type	Method and Description
org.hibernate.cache.spi.access.CollectionRegionAccessStrategy	buildAccessStrategy(org.hibernate.cache.spi.access.AccessType accessType)

Methods inherited from class org.gridgain.grid.cache.hibernate.GridHibernateTransactionalDataRegion

createAccessStrategy, getCacheDataDescription, isTransactionAware

Methods inherited from class org.gridgain.grid.cache.hibernate.GridHibernateRegion

contains, destroy, getElementCountInMemory, getElementCountOnDisk, getName, getSizeInMemory, getTimeout, nextTimestamp, toMap

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.TransactionalDataRegion

getCacheDataDescription, isTransactionAware

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

contains, destroy, getElementCountInMemory, getElementCountOnDisk, getName, getSizeInMemory, getTimeout, nextTimestamp, toMap

Constructor Detail

GridHibernateCollectionRegion

public GridHibernateCollectionRegion(GridHibernateRegionFactory factory,
                             String name,
                             org.gridgain.grid.Grid grid,
                             org.gridgain.grid.cache.GridCache<Object,Object> cache,
                             org.hibernate.cache.spi.CacheDataDescription dataDesc)

Parameters:

factory - Region factory.

name - Region name.

grid - Grid.

cache - Region cache.

dataDesc - Region data description.

Method Detail

buildAccessStrategy

public org.hibernate.cache.spi.access.CollectionRegionAccessStrategy buildAccessStrategy(org.hibernate.cache.spi.access.AccessType accessType)
                                                                                  throws org.hibernate.cache.CacheException

Specified by:

buildAccessStrategy in interface org.hibernate.cache.spi.CollectionRegion

Throws:

org.hibernate.cache.CacheException