org.hibernate.engine.jdbc.internal

Class JdbcCoordinatorImpl

java.lang.Object

org.hibernate.engine.jdbc.internal.JdbcCoordinatorImpl

All Implemented Interfaces:

java.io.Serializable, JdbcCoordinator, JdbcResourceTransactionAccess, TransactionCoordinatorOwner

public class JdbcCoordinatorImpl
extends java.lang.Object
implements JdbcCoordinator

Standard Hibernate implementation of JdbcCoordinator

IMPL NOTE : Custom serialization handling!

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
JdbcCoordinatorImpl(java.sql.Connection userSuppliedConnection, JdbcSessionOwner owner) Constructs a JdbcCoordinatorImpl

Method Summary

Modifier and Type	Method and Description
void	abortBatch() Abort the currently managed batch (if any)
void	afterStatementExecution() Used to signify that a statement has completed execution which may indicate that this logical connection need to perform an aggressive release of its physical connection.
void	afterTransaction() Signals the end of transaction.
void	afterTransactionBegin() A after-begin callback from the coordinator to its owner.
void	afterTransactionCompletion(boolean successful, boolean delayed) An after-completion callback from the coordinator to its owner.
protected BatchBuilder	batchBuilder()
void	beforeTransactionCompletion() A before-completion callback from the coordinator to its owner.
void	cancelLastQuery() Attempt to cancel the last query sent to the JDBC driver.
java.sql.Connection	close() Close this coordinator and release and resources.
protected void	close(java.sql.ResultSet resultSet)
protected void	close(java.sql.Statement statement)
protected void	closeAll(java.util.Set<java.sql.ResultSet> resultSets)
<T> T	coordinateWork(WorkExecutorVisitable<T> work) Perform the requested work handling exceptions, coordinating and handling return processing.
static JdbcCoordinatorImpl	deserialize(java.io.ObjectInputStream ois, JdbcSessionOwner owner) JDK deserialization hook
int	determineRemainingTransactionTimeOutPeriod() Calculate the amount of time, in seconds, still remaining before transaction timeout occurs.
void	disableReleases() Disable connection releases
void	enableReleases() Enable connection releases
void	executeBatch() Execute the currently managed batch (if any)
void	flushBeforeTransactionCompletion()
void	flushBeginning() Callback to let us know that a flush is beginning.
void	flushEnding() Callback to let us know that a flush is ending.
Batch	getBatch(BatchKey key) Get a batch instance.
ConnectionReleaseMode	getConnectionReleaseMode() The release mode under which this logical connection is operating.
JdbcSessionOwner	getJdbcSessionOwner()
LogicalConnectionImplementor	getLogicalConnection() Retrieves the logical connection associated with this JDBC coordinator.
JdbcResourceTransaction	getResourceLocalTransaction() Provides access to the resource local transaction of this data store, which is used by the TransactionCoordinator to manage transactions against the data store when not using JTA.
ResourceRegistry	getResourceRegistry()
ResultSetReturn	getResultSetReturn() Obtain the resultset extractor associated with this JDBC coordinator.
StatementPreparer	getStatementPreparer() Obtain the statement preparer associated with this JDBC coordinator.
boolean	isActive() Is the TransactionCoordinator owner considered active?
boolean	isReadyForSerialization() Can this coordinator be serialized?
void	registerLastQuery(java.sql.Statement statement) Register a query statement as being able to be cancelled.
void	serialize(java.io.ObjectOutputStream oos) JDK serialization hook
protected SessionFactoryImplementor	sessionFactory()
void	setTransactionTimeOut(int seconds) Set the effective transaction timeout period for the current transaction, in seconds.
SqlExceptionHelper	sqlExceptionHelper() Access to the SqlExceptionHelper

Methods inherited from class java.lang.Object

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

Constructor Detail

JdbcCoordinatorImpl

public JdbcCoordinatorImpl(java.sql.Connection userSuppliedConnection,
                           JdbcSessionOwner owner)

Constructs a JdbcCoordinatorImpl

Parameters:

userSuppliedConnection - The user supplied connection (may be null)

Method Detail

getLogicalConnection

public LogicalConnectionImplementor getLogicalConnection()

Description copied from interface: JdbcCoordinator

Retrieves the logical connection associated with this JDBC coordinator.

Specified by:

getLogicalConnection in interface JdbcCoordinator

Returns:

The logical connection

sessionFactory

protected SessionFactoryImplementor sessionFactory()

batchBuilder

protected BatchBuilder batchBuilder()

sqlExceptionHelper

public SqlExceptionHelper sqlExceptionHelper()

Access to the SqlExceptionHelper

Returns:

The SqlExceptionHelper

flushBeginning

public void flushBeginning()

Description copied from interface: JdbcCoordinator

Callback to let us know that a flush is beginning. We use this fact to temporarily circumvent aggressive connection releasing until after the flush cycle is complete JdbcCoordinator.flushEnding()

Specified by:

flushBeginning in interface JdbcCoordinator

flushEnding

public void flushEnding()

Description copied from interface: JdbcCoordinator

Callback to let us know that a flush is ending. We use this fact to stop circumventing aggressive releasing connections.

Specified by:

flushEnding in interface JdbcCoordinator

close

public java.sql.Connection close()

Description copied from interface: JdbcCoordinator

Close this coordinator and release and resources.

Specified by:

close in interface JdbcCoordinator

Returns:

The Connection associated with the managed logical connection

See Also:

LogicalConnection.close()

getBatch

public Batch getBatch(BatchKey key)

Description copied from interface: JdbcCoordinator

Get a batch instance.

Specified by:

getBatch in interface JdbcCoordinator

Parameters:

key - The unique batch key.

Returns:

The batch

executeBatch

public void executeBatch()

Description copied from interface: JdbcCoordinator

Execute the currently managed batch (if any)

Specified by:

executeBatch in interface JdbcCoordinator

abortBatch

public void abortBatch()

Description copied from interface: JdbcCoordinator

Abort the currently managed batch (if any)

Specified by:

abortBatch in interface JdbcCoordinator

getStatementPreparer

public StatementPreparer getStatementPreparer()

Description copied from interface: JdbcCoordinator

Obtain the statement preparer associated with this JDBC coordinator.

Specified by:

getStatementPreparer in interface JdbcCoordinator

Returns:

This coordinator's statement preparer

getResultSetReturn

public ResultSetReturn getResultSetReturn()

Description copied from interface: JdbcCoordinator

Obtain the resultset extractor associated with this JDBC coordinator.

Specified by:

getResultSetReturn in interface JdbcCoordinator

Returns:

This coordinator's resultset extractor

setTransactionTimeOut

public void setTransactionTimeOut(int seconds)

Description copied from interface: TransactionCoordinatorOwner

Set the effective transaction timeout period for the current transaction, in seconds.

Specified by:

setTransactionTimeOut in interface TransactionCoordinatorOwner

Parameters:

seconds - The number of seconds before a time out should occur.

flushBeforeTransactionCompletion

public void flushBeforeTransactionCompletion()

Specified by:

flushBeforeTransactionCompletion in interface TransactionCoordinatorOwner

determineRemainingTransactionTimeOutPeriod

public int determineRemainingTransactionTimeOutPeriod()

Description copied from interface: JdbcCoordinator

Calculate the amount of time, in seconds, still remaining before transaction timeout occurs.

Specified by:

determineRemainingTransactionTimeOutPeriod in interface JdbcCoordinator

Returns:

The number of seconds remaining until until a transaction timeout occurs. A negative value indicates no timeout was requested.

afterStatementExecution

public void afterStatementExecution()

Description copied from interface: JdbcCoordinator

Used to signify that a statement has completed execution which may indicate that this logical connection need to perform an aggressive release of its physical connection.

Specified by:

afterStatementExecution in interface JdbcCoordinator

afterTransaction

public void afterTransaction()

Description copied from interface: JdbcCoordinator

Signals the end of transaction.

Intended for use from the transaction coordinator, after local transaction completion. Used to conditionally release the JDBC connection aggressively if the configured release mode indicates.

Specified by:

afterTransaction in interface JdbcCoordinator

getResourceRegistry

public ResourceRegistry getResourceRegistry()

Specified by:

getResourceRegistry in interface JdbcCoordinator

getConnectionReleaseMode

public ConnectionReleaseMode getConnectionReleaseMode()

Description copied from interface: JdbcCoordinator

The release mode under which this logical connection is operating.

Specified by:

getConnectionReleaseMode in interface JdbcCoordinator

Returns:

the release mode.

coordinateWork

public <T> T coordinateWork(WorkExecutorVisitable<T> work)

Description copied from interface: JdbcCoordinator

Perform the requested work handling exceptions, coordinating and handling return processing.

Specified by:

coordinateWork in interface JdbcCoordinator

Type Parameters:

T - The result type.

Parameters:

work - The work to be performed.

Returns:

The work result.

isReadyForSerialization

public boolean isReadyForSerialization()

Description copied from interface: JdbcCoordinator

Can this coordinator be serialized?

Specified by:

isReadyForSerialization in interface JdbcCoordinator

Returns:

true indicates the coordinator can be serialized.

registerLastQuery

public void registerLastQuery(java.sql.Statement statement)

Description copied from interface: JdbcCoordinator

Register a query statement as being able to be cancelled.

Specified by:

registerLastQuery in interface JdbcCoordinator

Parameters:

statement - The cancel-able query statement.

cancelLastQuery

public void cancelLastQuery()

Description copied from interface: JdbcCoordinator

Attempt to cancel the last query sent to the JDBC driver.

Specified by:

cancelLastQuery in interface JdbcCoordinator

enableReleases

public void enableReleases()

Description copied from interface: JdbcCoordinator

Enable connection releases

Specified by:

enableReleases in interface JdbcCoordinator

disableReleases

public void disableReleases()

Description copied from interface: JdbcCoordinator

Disable connection releases

Specified by:

disableReleases in interface JdbcCoordinator

closeAll

protected void closeAll(java.util.Set<java.sql.ResultSet> resultSets)

close

protected void close(java.sql.Statement statement)

close

protected void close(java.sql.ResultSet resultSet)

isActive

public boolean isActive()

Description copied from interface: TransactionCoordinatorOwner

Is the TransactionCoordinator owner considered active?

Specified by:

isActive in interface TransactionCoordinatorOwner

Returns:

true indicates the owner is still active; false indicates it is not.

afterTransactionBegin

public void afterTransactionBegin()

Description copied from interface: TransactionCoordinatorOwner

A after-begin callback from the coordinator to its owner.

Specified by:

afterTransactionBegin in interface TransactionCoordinatorOwner

beforeTransactionCompletion

public void beforeTransactionCompletion()

Description copied from interface: TransactionCoordinatorOwner

A before-completion callback from the coordinator to its owner.

Specified by:

beforeTransactionCompletion in interface TransactionCoordinatorOwner

afterTransactionCompletion

public void afterTransactionCompletion(boolean successful,
                                       boolean delayed)

Description copied from interface: TransactionCoordinatorOwner

An after-completion callback from the coordinator to its owner.

Specified by:

afterTransactionCompletion in interface TransactionCoordinatorOwner

Parameters:

successful - Was the transaction successful?

delayed - Is this a delayed after transaction completion call (aka after a timeout)?

getJdbcSessionOwner

public JdbcSessionOwner getJdbcSessionOwner()

Specified by:

getJdbcSessionOwner in interface TransactionCoordinatorOwner

getResourceLocalTransaction

public JdbcResourceTransaction getResourceLocalTransaction()

Description copied from interface: JdbcResourceTransactionAccess

Provides access to the resource local transaction of this data store, which is used by the TransactionCoordinator to manage transactions against the data store when not using JTA.

Specified by:

getResourceLocalTransaction in interface JdbcResourceTransactionAccess

Returns:

The resource-local transaction

serialize

public void serialize(java.io.ObjectOutputStream oos)
               throws java.io.IOException

JDK serialization hook

Parameters:

oos - The stream into which to write our state

Throws:

java.io.IOException - Trouble accessing the stream

deserialize

public static JdbcCoordinatorImpl deserialize(java.io.ObjectInputStream ois,
                                              JdbcSessionOwner owner)
                                       throws java.io.IOException,
                                              java.lang.ClassNotFoundException

JDK deserialization hook

Parameters:

ois - The stream into which to write our state

owner - The Jdbc Session owner which owns the JdbcCoordinatorImpl to be deserialized.

Returns:

The deserialized JdbcCoordinatorImpl

Throws:

java.io.IOException - Trouble accessing the stream

java.lang.ClassNotFoundException - Trouble reading the stream