org.hibernate.context

Class JTASessionContext

Implemented Interfaces:
CurrentSessionContext, Serializable

public class JTASessionContext
extends java.lang.Object
implements CurrentSessionContext

An implementation of CurrentSessionContext which scopes the notion of a current session to a JTA transaction. Because JTA gives us a nice tie-in to clean up after ourselves, this implementation will generate Sessions as needed provided a JTA transaction is in effect. If a session is not already associated with the current JTA transaction at the time currentSession() is called, a new session will be opened and it will be associated with that JTA transaction.

Note that the sessions returned from this method are automatically configured with both the auto-flush and auto-close attributes set to true, meaning that the Session will be automatically flushed and closed as part of the lifecycle for the JTA transaction to which it is associated. Additionally, it will also be configured to aggressively release JDBC connections after each statement is executed. These settings are governed by the isAutoFlushEnabled(), isAutoCloseEnabled(), and getConnectionReleaseMode() methods; these are provided (along with the buildOrObtainSession() method) for easier subclassing for custom JTA-based session tracking logic (like maybe long-session semantics).

Author:
Steve Ebersole

Nested Class Summary

protected static class
JTASessionContext.CleanupSynch
JTA transaction synch used for cleanup of the internal session map.

Field Summary

protected SessionFactoryImplementor
factory

Constructor Summary

JTASessionContext(SessionFactoryImplementor factory)

Method Summary

protected Session
buildOrObtainSession()
Strictly provided for subclassing purposes; specifically to allow long-session support.
Session
currentSession()
protected ConnectionReleaseMode
getConnectionReleaseMode()
Mainly for subclass usage.
protected boolean
isAutoCloseEnabled()
Mainly for subclass usage.
protected boolean
isAutoFlushEnabled()
Mainly for subclass usage.

Field Details

factory

protected final SessionFactoryImplementor factory

Constructor Details

JTASessionContext

public JTASessionContext(SessionFactoryImplementor factory)

Method Details

buildOrObtainSession

protected Session buildOrObtainSession()
Strictly provided for subclassing purposes; specifically to allow long-session support.

This implementation always just opens a new session.

Returns:
the built or (re)obtained session.

currentSession

public Session currentSession()
            throws HibernateException
Specified by:
currentSession in interface CurrentSessionContext

getConnectionReleaseMode

protected ConnectionReleaseMode getConnectionReleaseMode()
Mainly for subclass usage. This impl always returns after_statement.
Returns:
The connection release mode for any built sessions.

isAutoCloseEnabled

protected boolean isAutoCloseEnabled()
Mainly for subclass usage. This impl always returns true.
Returns:
Whether or not the the session should be closed by transaction completion.

isAutoFlushEnabled

protected boolean isAutoFlushEnabled()
Mainly for subclass usage. This impl always returns true.
Returns:
Whether or not the the session should be flushed prior transaction completion.