Field Detail

• public static final int FLUSH_ALWAYS

  Flushing before every query statement is rarely necessary. It is only available for special needs.

  In case of an existing Session, FLUSH_ALWAYS will turn the flush mode to ALWAYS for the scope of the current operation, resetting the previous flush mode afterwards.

  See Also:

  setFlushMode

• public static final int FLUSH_AUTO

  Automatic flushing is the default mode for a Hibernate Session. A session will get flushed on transaction commit, and on certain find operations that might involve already modified instances, but not after each unit of work like with eager flushing.

  In case of an existing Session, FLUSH_AUTO will participate in the existing flush mode, not modifying it for the current operation. This in particular means that this setting will not modify an existing flush mode NEVER, in contrast to FLUSH_EAGER.

  See Also:

  setFlushMode

• public static final int FLUSH_COMMIT

  Flushing at commit only is intended for units of work where no intermediate flushing is desired, not even for find operations that might involve already modified instances.

  In case of an existing Session, FLUSH_COMMIT will turn the flush mode to COMMIT for the scope of the current operation, resetting the previous flush mode afterwards. The only exception is an existing flush mode NEVER, which will not be modified through this setting.

  See Also:

  setFlushMode

• public static final int FLUSH_EAGER

  Eager flushing leads to immediate synchronization with the database, even if in a transaction. This causes inconsistencies to show up and throw a respective exception immediately, and JDBC access code that participates in the same transaction will see the changes as the database is already aware of them then. But the drawbacks are:

  • additional communication roundtrips with the database, instead of a single batch at transaction commit;
  • the fact that an actual database rollback is needed if the Hibernate transaction rolls back (due to already submitted SQL statements).

  In case of an existing Session, FLUSH_EAGER will turn the flush mode to AUTO for the scope of the current operation and issue a flush at the end, resetting the previous flush mode afterwards.

  See Also:

  setFlushMode

• public static final int FLUSH_NEVER

  Never flush is a good strategy for read-only units of work. Hibernate will not track and look for changes in this case, avoiding any overhead of modification detection.

  In case of an existing Session, FLUSH_NEVER will turn the flush mode to NEVER for the scope of the current operation, resetting the previous flush mode afterwards.

  See Also:

  setFlushMode

• protected boolean cacheQueries

• protected javax.sql.DataSource dataSource

• protected boolean exposeNativeSession

• protected int flushMode

• protected org.springframework.jdbc.support.SQLExceptionTranslator jdbcExceptionTranslator

• protected org.hibernate.SessionFactory sessionFactory

Constructor Detail

• protected GrailsHibernateTemplate()

• public GrailsHibernateTemplate(org.hibernate.SessionFactory sessionFactory)

• public GrailsHibernateTemplate(org.hibernate.SessionFactory sessionFactory, HibernateDatastore datastore)

• public GrailsHibernateTemplate(org.hibernate.SessionFactory sessionFactory, HibernateDatastore datastore, int defaultFlushMode)

Method Detail

• protected org.hibernate.FlushMode applyFlushMode(org.hibernate.Session session, boolean existingTransaction)

  Apply the flush mode that's been specified for this accessor to the given Session.

  Parameters:

  session - the current Hibernate Session

  existingTransaction - if executing within an existing transaction

  Returns:

  the previous flush mode to restore after the operation, or null if none

  See Also:

  setFlushMode

  org.hibernate.Session#setFlushMode

• @java.lang.Override
  public void applySettings(org.hibernate.query.Query query)

• @java.lang.Override
  public void applySettings(org.hibernate.Criteria criteria)

• public void clear()

• public boolean contains(java.lang.Object entity)

• @java.lang.SuppressWarnings("ConstantConditions")
  protected org.springframework.dao.DataAccessException convertHibernateAccessException(org.hibernate.HibernateException ex)

• @java.lang.SuppressWarnings("SqlDialectInspection")
  protected org.springframework.dao.DataAccessException convertJdbcAccessException(org.hibernate.JDBCException ex, org.springframework.jdbc.support.SQLExceptionTranslator translator)

• protected org.hibernate.Session createSessionProxy(org.hibernate.Session session)

  Create a close-suppressing proxy for the given Hibernate Session. The proxy also prepares returned Query and Criteria objects.

  Parameters:

  session - the Hibernate Session to create a proxy for

  Returns:

  the Session proxy

  See Also:

  org.hibernate.Session#close()

  prepareQuery

  prepareCriteria

• public void delete(java.lang.Object entity)

• public void deleteAll(java.util.Collection<?> objects)

• <T> protected T doExecute(HibernateCallback<T> action, boolean enforceNativeSession)

  Execute the action specified by the given action object within a Session.

  throws:

  org.springframework.dao.DataAccessException in case of Hibernate errors

  Parameters:

  action - callback object that specifies the Hibernate action

  enforceNativeSession - whether to enforce exposure of the native Hibernate Session to callback code

  Returns:

  a result object returned by the action, or null

• public void evict(java.lang.Object entity)

• <T> @java.lang.Override
  public T execute(groovy.lang.Closure<T> callable)

• <T> public T execute(HibernateCallback<T> action)

• public java.util.List<?> executeFind(HibernateCallback<?> action)

• <T1> @java.lang.Override
  public T1 executeWithExistingOrCreateNewSession(org.hibernate.SessionFactory sessionFactory, groovy.lang.Closure<T1> callable)

• <T> @java.lang.Override
  public T executeWithNewSession(groovy.lang.Closure<T> callable)

• public void flush(java.lang.Object entity)

• public void flush()

• protected void flushIfNecessary(org.hibernate.Session session, boolean existingTransaction)

• <T> public T get(java.lang.Class<T> entityClass, java.io.Serializable id)

• <T> public T get(java.lang.Class<T> entityClass, java.io.Serializable id, org.hibernate.LockMode mode)

• public int getFlushMode()

  Return if a flush should be forced after executing the callback code.

• @java.lang.SuppressWarnings({"rawtypes", "unchecked"})
  protected java.util.Collection getIterableAsCollection(java.lang.Iterable objects)

• protected org.hibernate.Session getSession()

• public org.hibernate.SessionFactory getSessionFactory()

• public boolean isApplyFlushModeOnlyToNonExistingTransactions()

• public boolean isCacheQueries()

• public boolean isExposeNativeSession()

• public boolean isOsivReadOnly()

• protected boolean isSessionTransactional(org.hibernate.Session session)

• <T> public T load(java.lang.Class<T> entityClass, java.io.Serializable id)

• <T> public java.util.List<T> loadAll(java.lang.Class<T> entityClass)

• <T> public T lock(java.lang.Class<T> entityClass, java.io.Serializable id, org.hibernate.LockMode lockMode)

• public void lock(java.lang.Object entity, org.hibernate.LockMode lockMode)

• @java.lang.Deprecated
  protected void prepareCriteria(org.hibernate.Criteria criteria)

  Prepare the given Criteria object, applying cache settings and/or a transaction timeout.

  deprecated:

  Deprecated because Hibernate Criteria are deprecated

  Parameters:

  criteria - the Criteria object to prepare

• <T> protected void prepareCriteria(org.hibernate.Query<T> jpaQuery)

  Prepare the given Query object, applying cache settings and/or a transaction timeout.

  Parameters:

  jpaQuery - the Query object to prepare

• protected void prepareQuery(org.hibernate.query.Query query)

  Prepare the given Query object, applying cache settings and/or a transaction timeout.

  Parameters:

  query - the Query object to prepare

• public void refresh(java.lang.Object entity)

• public void refresh(java.lang.Object entity, org.hibernate.LockMode lockMode)

• public java.io.Serializable save(java.lang.Object o)

• public void setApplyFlushModeOnlyToNonExistingTransactions(boolean applyFlushModeOnlyToNonExistingTransactions)

• public void setCacheQueries(boolean cacheQueries)

• public void setExposeNativeSession(boolean exposeNativeSession)

• public void setFlushMode(int flushMode)

  Set the flush behavior to one of the constants in this class. Default is FLUSH_AUTO.

  See Also:

  FLUSH_AUTO

• public void setOsivReadOnly(boolean osivReadOnly)

• protected boolean shouldPassReadOnlyToHibernate()