package org.talos.impl.repository;

 import org.hibernate.Session;

 import org.talos.exception.TalosHibernateException;

 /**

  * This class manages the current transaction of a repository.

  */

 public interface TransactionContext {

         /**

          * Discards any changes to the persistent store.

          * 

          * @throws TalosHibernateException if the rollback operation fails.

          * @see org.talos.Talos#rollback()

          * @see #commit()

          */

         void rollback() throws TalosHibernateException;

         /**

          * Commits any changes to the persistent store. 

          * 

          * @throws TalosHibernateException if the changes cannot be committed

          * @see org.talos.Talos#commit()

          * @see #rollback()

          */

         void commit() throws TalosHibernateException;

         /**

          * Gets the current Hibernate Session. This will automatically start a transaction if one isn't

          * started yet.

          * 

          * @return the current Hibernate Session

          * @throws TalosHibernateException if the Session cannot be retrieved

          * @see #commit()

          * @see #rollback()

          */

         Session getSession() throws TalosHibernateException;

 }