com.cosylab.cdb.jdal.hibernate

Class HibernateUtil

java.lang.Object

com.cosylab.cdb.jdal.hibernate.HibernateUtil

public class HibernateUtil
extends java.lang.Object

Basic Hibernate helper class, handles SessionFactory, Session and Transaction.

Holds Session and Transactions in thread local variables. All exceptions are wrapped in an unchecked HibernateUtilException.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HibernateUtil.HibernateUtilException

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	HIBERNATE_FILENAME_DEFAULT

Method Summary

Modifier and Type	Method and Description
void	beginTransaction() Start a new database transaction.
static void	clearInstance() Nulls the instance field, so that subsequent calls to getInstance(Logger) will create a new instance.
void	closeSession() Closes the Session local to the thread.
void	commitTransaction() Commit the database transaction.
Session	disconnectSession() Disconnect and return Session from current Thread.
Configuration	getConfiguration() Returns the original Hibernate configuration.
static HibernateUtil	getInstance(java.util.logging.Logger logger) Singleton accessor
java.util.List	getList(java.lang.Class type)
Session	getSession() Retrieves the current Session local to the thread.
SessionFactory	getSessionFactory() Returns the SessionFactory used for this static class.
void	rebuildSessionFactory() Rebuild the SessionFactory with the static Configuration.
void	rebuildSessionFactory(Configuration cfg) Rebuild the SessionFactory with the given Hibernate Configuration.
void	reconnect(Session session) Reconnects a Hibernate Session to the current Thread.
void	registerInterceptor(Interceptor interceptor) Register a Hibernate interceptor with the current thread.
void	rollbackTransaction() Commit the database transaction.
void	setConfiguration(Configuration config) Set your own configuration and build session factory from it.
void	setConfiguration(java.util.Properties extraProperties) Use default configuration and add properties from Properties.

Methods inherited from class java.lang.Object

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

Field Detail

HIBERNATE_FILENAME_DEFAULT

public static final java.lang.String HIBERNATE_FILENAME_DEFAULT

See Also:

Constant Field Values

Method Detail

getInstance

public static HibernateUtil getInstance(java.util.logging.Logger logger)

Singleton accessor

Returns:

clearInstance

public static void clearInstance()

Nulls the instance field, so that subsequent calls to getInstance(Logger) will create a new instance. This probably only makes sense between junit tests that want to start out fresh.

setConfiguration

public void setConfiguration(java.util.Properties extraProperties)

Use default configuration and add properties from Properties. Build session factory from combined configuration.

Parameters:

config -

setConfiguration

public void setConfiguration(Configuration config)

Set your own configuration and build session factory from it. Used to tests.

Parameters:

config -

getSessionFactory

public SessionFactory getSessionFactory()

Returns the SessionFactory used for this static class.

Returns:

SessionFactory

getConfiguration

public Configuration getConfiguration()

Returns the original Hibernate configuration.

Returns:

Configuration

rebuildSessionFactory

public void rebuildSessionFactory()
                           throws HibernateUtil.HibernateUtilException

Rebuild the SessionFactory with the static Configuration.

Throws:

HibernateUtil.HibernateUtilException

rebuildSessionFactory

public void rebuildSessionFactory(Configuration cfg)
                           throws HibernateUtil.HibernateUtilException

Rebuild the SessionFactory with the given Hibernate Configuration.

Parameters:

cfg -

Throws:

HibernateUtil.HibernateUtilException

getSession

public Session getSession()
                   throws HibernateUtil.HibernateUtilException

Retrieves the current Session local to the thread.

If no Session is open, opens a new Session for the running thread.

Returns:

Session

Throws:

HibernateUtil.HibernateUtilException

closeSession

public void closeSession()
                  throws HibernateUtil.HibernateUtilException

Closes the Session local to the thread.

Throws:

HibernateUtil.HibernateUtilException

beginTransaction

public void beginTransaction()
                      throws HibernateUtil.HibernateUtilException

Start a new database transaction.

Throws:

HibernateUtil.HibernateUtilException

commitTransaction

public void commitTransaction()
                       throws HibernateUtil.HibernateUtilException

Commit the database transaction.

Throws:

HibernateUtil.HibernateUtilException

rollbackTransaction

public void rollbackTransaction()
                         throws HibernateUtil.HibernateUtilException

Commit the database transaction.

Throws:

HibernateUtil.HibernateUtilException

reconnect

public void reconnect(Session session)
               throws HibernateUtil.HibernateUtilException

Reconnects a Hibernate Session to the current Thread.

Parameters:

session - The Hibernate Session to be reconnected.

Throws:

HibernateUtil.HibernateUtilException

disconnectSession

public Session disconnectSession()
                          throws HibernateUtil.HibernateUtilException

Disconnect and return Session from current Thread.

Returns:

Session the disconnected Session

Throws:

HibernateUtil.HibernateUtilException

registerInterceptor

public void registerInterceptor(Interceptor interceptor)

Register a Hibernate interceptor with the current thread.

Every Session opened is opened with this interceptor after registration. Has no effect if the current Session of the thread is already open, effective on next close()/getSession().

getList

public java.util.List getList(java.lang.Class type)
                       throws HibernateUtil.HibernateUtilException

Throws:

HibernateUtil.HibernateUtilException