public interface JdbcCoordinator extends Serializable, TransactionCoordinatorOwner, JdbcResourceTransactionAccess
Coordinates JDBC-related activities.
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 |
cancelLastQuery()
Attempt to cancel the last query sent to the JDBC driver.
|
Connection |
close()
Close this coordinator and release and resources.
|
<T> T |
coordinateWork(WorkExecutorVisitable<T> work)
Perform the requested work handling exceptions, coordinating and handling return processing.
|
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 |
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.
|
default PhysicalConnectionHandlingMode |
getConnectionHandlingMode()
Deprecated.
(since 5.2) access via
getLogicalConnection() instead |
default ConnectionReleaseMode |
getConnectionReleaseMode()
Deprecated.
(since 5.2) use
PhysicalConnectionHandlingMode via getLogicalConnection() instead |
LogicalConnectionImplementor |
getLogicalConnection()
Retrieves the logical connection associated with this JDBC coordinator.
|
default ResourceRegistry |
getResourceRegistry()
Deprecated.
(since 5.2) access via
getLogicalConnection() instead |
ResultSetReturn |
getResultSetReturn()
Obtain the resultset extractor associated with this JDBC coordinator.
|
StatementPreparer |
getStatementPreparer()
Obtain the statement preparer associated with this JDBC coordinator.
|
boolean |
isReadyForSerialization()
Can this coordinator be serialized?
|
void |
registerLastQuery(Statement statement)
Register a query statement as being able to be cancelled.
|
void |
serialize(ObjectOutputStream objectOutputStream) |
afterTransactionBegin, afterTransactionCompletion, beforeTransactionCompletion, flushBeforeTransactionCompletion, getJdbcSessionOwner, isActive, setTransactionTimeOut, startTransactionBoundary
getResourceLocalTransaction
LogicalConnectionImplementor getLogicalConnection()
Retrieves the logical connection associated with this JDBC coordinator.
Batch getBatch(BatchKey key)
Get a batch instance.
key
- The unique batch key.void executeBatch()
Execute the currently managed batch (if any)
void abortBatch()
Abort the currently managed batch (if any)
StatementPreparer getStatementPreparer()
Obtain the statement preparer associated with this JDBC coordinator.
ResultSetReturn getResultSetReturn()
Obtain the resultset extractor associated with this JDBC coordinator.
void flushBeginning()
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 flushEnding()
void flushEnding()
Callback to let us know that a flush is ending. We use this fact to stop circumventing aggressive releasing connections.
Connection close()
Close this coordinator and release and resources.
Connection
associated with the managed logical connection
LogicalConnection.close()
void afterTransaction()
Signals the end of transaction. <p/> 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.
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.
<T> T coordinateWork(WorkExecutorVisitable<T> work)
Perform the requested work handling exceptions, coordinating and handling return processing.
T
- The result type.work
- The work to be performed.void cancelLastQuery()
Attempt to cancel the last query sent to the JDBC driver.
int determineRemainingTransactionTimeOutPeriod()
Calculate the amount of time, in seconds, still remaining before transaction timeout occurs.
TransactionException
- Indicates the time out period has already been exceeded.void enableReleases()
Enable connection releases
void disableReleases()
Disable connection releases
void registerLastQuery(Statement statement)
Register a query statement as being able to be cancelled.
statement
- The cancel-able query statement.boolean isReadyForSerialization()
Can this coordinator be serialized?
true
indicates the coordinator can be serialized.@Deprecated default ConnectionReleaseMode getConnectionReleaseMode()
PhysicalConnectionHandlingMode
via getLogicalConnection()
insteadThe release mode under which this logical connection is operating.
@Deprecated default PhysicalConnectionHandlingMode getConnectionHandlingMode()
getLogicalConnection()
insteadThe mode for physical handling of the JDBC Connection
@Deprecated default ResourceRegistry getResourceRegistry()
getLogicalConnection()
insteadvoid serialize(ObjectOutputStream objectOutputStream) throws IOException
IOException
Copyright © 2001-2018 Red Hat, Inc. All Rights Reserved.