js.transaction.hibernate

Class HibernateAdapter

java.lang.Object

js.transaction.hibernate.HibernateAdapter

final class HibernateAdapter
extends Object

Hibernate database adapter creates session factory and use it to create transactions. Keeps a transactions cache stored on thread local variables and use it to retrieve currently executed Hibernate session, see getSession().

Session factory is configured from provided configuration object, see Config class for format description.

Version:

draft

Author:

Iulian Rotaru

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_CONFIG Defualt Hibernate configuration resource is used when Config object is not provided, that is, is null.
private static js.log.Log	log Class logger.
private org.hibernate.SessionFactory	sessionFactory Hibernate session factory.
private static String	TEST_PERIOD Database connection keep alive period, set to half hour.
private static String	TEST_QUERY Query for database connection keep alive transaction.
private ThreadLocal<TransactionImpl>	transactionsCache Keep current on working transaction on thread local variable.
private int	transactionTimeout Hibernate transaction timeout.

Constructor Summary

Constructors

Constructor and Description
HibernateAdapter()

Method Summary

Modifier and Type	Method and Description
void	config(js.lang.Config config) Hibernate adapter initialization.
TransactionImpl	createTransaction(boolean readOnly) Create a database handler.
void	destroy() Destroy Hibernate session factory and releases database resources.
void	destroyTransaction() Remote transaction from transactions cache.
<T> T	getSession()
org.hibernate.SessionFactory	getSessionFactory() Get session factory.
private static org.hibernate.cfg.Configuration	hibernateConfiguration(js.lang.Config config) Configure Hibernate from j(s)-lib configuration object.

Methods inherited from class java.lang.Object

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

Field Detail

log

private static final js.log.Log log

Class logger.

DEFAULT_CONFIG

public static final String DEFAULT_CONFIG

Defualt Hibernate configuration resource is used when Config object is not provided, that is, is null. See config(Config).

See Also:

Constant Field Values

TEST_PERIOD

private static final String TEST_PERIOD

Database connection keep alive period, set to half hour.

See Also:

Constant Field Values

TEST_QUERY

private static final String TEST_QUERY

Query for database connection keep alive transaction.

See Also:

Constant Field Values

transactionsCache

private final ThreadLocal<TransactionImpl> transactionsCache

Keep current on working transaction on thread local variable.

sessionFactory

private org.hibernate.SessionFactory sessionFactory

Hibernate session factory. This factory creates Hibernate session which is the native interface of Transaction implementation.

transactionTimeout

private int transactionTimeout

Hibernate transaction timeout. This value is global per database adapter, i.e. on application. Value expressed in seconds. Default value is zero which means blocking connection. It is loaded from hibernate.transaction.timeout property, if exists.

Constructor Detail

HibernateAdapter

HibernateAdapter()

Method Detail

config

public void config(js.lang.Config config)
            throws js.lang.ConfigException,
                   org.hibernate.HibernateException

Hibernate adapter initialization. Read Hibernate properties from configuration object and create the session factory; also configure connections pool. All properties from configuration object are passed as they are to Hibernate session factory builder.

Scan and register mappings files in the configured package(s). For Hibernate mappings there are mappings child elements into configuration object. There can be a not limited number of mappings elements but usually it is a single one. A mapping element has package and files-pattern attributes. Files pattern is optional with default *.hbm.xml.

Parameters:

config - configuration object, possible null.

Throws:

js.lang.ConfigException - if configuration object is not well formed.

org.hibernate.HibernateException - if a property is not recognized by Hibernate session factory builder.

hibernateConfiguration

private static org.hibernate.cfg.Configuration hibernateConfiguration(js.lang.Config config)

Configure Hibernate from j(s)-lib configuration object.

Parameters:

config - configuration object.

Returns:

Hibernate configuration instance initialized from j(s)-lib configuration object.

getSessionFactory

public org.hibernate.SessionFactory getSessionFactory()

Get session factory.

Returns:

session factory.

createTransaction

public TransactionImpl createTransaction(boolean readOnly)

Create a database handler. Create a new TransactionImpl and store it on current thread so that it can be retrieved by application code. This method is invoked by TransactionManagerImpl when start a new transaction. Note that created handler is valid only on current transaction boundaries.

Parameters:

readOnly - if this flag is true create a read-only transaction, supporting only database select operations.

Returns:

newly created database handler.

destroyTransaction

public void destroyTransaction()

Remote transaction from transactions cache.

getSession

public <T> T getSession()

destroy

public void destroy()

Destroy Hibernate session factory and releases database resources.