Package org.hibernate.resource.jdbc.spi

Interface LogicalConnectionImplementor

All Superinterfaces:

LogicalConnection

public interface LogicalConnectionImplementor
extends LogicalConnection

SPI contract for LogicalConnection

Method Summary

Modifier and Type	Method	Description
void	afterStatement()	Notification indicating a JDBC statement has been executed to trigger ConnectionReleaseMode.AFTER_STATEMENT releasing if needed
void	afterTransaction()	Notification indicating a transaction has completed to trigger ConnectionReleaseMode.AFTER_TRANSACTION releasing if needed
void	beforeTransactionCompletion()	Notification indicating a transaction is about to be completed, so to trigger releasing of the connection if needed (ConnectionReleaseMode.BEFORE_TRANSACTION_COMPLETION is enabled)
PhysicalConnectionHandlingMode	getConnectionHandlingMode()
java.sql.Connection	getPhysicalConnection()	Exposes access to the "real" Connection.
PhysicalJdbcTransaction	getPhysicalJdbcTransaction()
LogicalConnectionImplementor	makeShareableCopy()	Deprecated. This method is not used by Hibernate.
java.sql.Connection	manualDisconnect()	Manually disconnect the underlying JDBC Connection.
void	manualReconnect(java.sql.Connection suppliedConnection)	Manually reconnect the underlying JDBC Connection.
void	serialize(java.io.ObjectOutputStream oos)	Serialization hook

Methods inherited from interface org.hibernate.resource.jdbc.LogicalConnection

close, getResourceRegistry, isOpen, isPhysicallyConnected

Method Detail

getPhysicalConnection

java.sql.Connection getPhysicalConnection()

Exposes access to the "real" Connection.

Returns:

The connection

Todo:

: expose Connection as here? or accept(WorkInConnection) where WorkInConnection is given access to Connection?

getConnectionHandlingMode

PhysicalConnectionHandlingMode getConnectionHandlingMode()

afterStatement

void afterStatement()

Notification indicating a JDBC statement has been executed to trigger ConnectionReleaseMode.AFTER_STATEMENT releasing if needed

beforeTransactionCompletion

void beforeTransactionCompletion()

Notification indicating a transaction is about to be completed, so to trigger releasing of the connection if needed (ConnectionReleaseMode.BEFORE_TRANSACTION_COMPLETION is enabled)

afterTransaction

void afterTransaction()

Notification indicating a transaction has completed to trigger ConnectionReleaseMode.AFTER_TRANSACTION releasing if needed

manualDisconnect

java.sql.Connection manualDisconnect()

Manually disconnect the underlying JDBC Connection. The assumption here is that the manager will be reconnected at a later point in time.

Returns:

The connection maintained here at time of disconnect. null if there was no connection cached internally.

manualReconnect

void manualReconnect(java.sql.Connection suppliedConnection)

Manually reconnect the underlying JDBC Connection. Should be called at some point after manualDisconnect().

Parameters:

suppliedConnection - For user supplied connection strategy the user needs to hand us the connection with which to reconnect. It is an error to pass a connection in the other strategies.

makeShareableCopy

@Deprecated
LogicalConnectionImplementor makeShareableCopy()

Deprecated.

This method is not used by Hibernate.

Creates a shareable copy of itself for use in "shared sessions"

Returns:

The shareable copy.

getPhysicalJdbcTransaction

PhysicalJdbcTransaction getPhysicalJdbcTransaction()

serialize

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

Serialization hook

Parameters:

oos - The stream to write out state to

Throws:

java.io.IOException - Problem accessing stream