org.hibernate.engine.jdbc.spi

Interface LogicalConnectionImplementor

All Superinterfaces:

LogicalConnection, Serializable

All Known Implementing Classes:

LogicalConnectionImpl

public interface LogicalConnectionImplementor
extends LogicalConnection

The "internal" contract for LogicalConnection

Method Summary

Methods

Modifier and Type	Method and Description
void	addObserver(ConnectionObserver observer) Add an observer interested in notification of connection events.
void	aggressiveRelease() Perform an aggressive release
ConnectionReleaseMode	getConnectionReleaseMode() The release mode under which this logical connection is operating.
JdbcServices	getJdbcServices() Obtains the JDBC services associated with this logical connection.
boolean	isAutoCommit() Is this logical connection in auto-commit mode?
boolean	isUserSuppliedConnection() Does this logical connection wrap a user/application supplied connection?
Connection	manualDisconnect() Manually disconnect the underlying JDBC Connection.
void	manualReconnect(Connection suppliedConnection) Manually reconnect the underlying JDBC Connection.
void	notifyObserversStatementPrepared() Callback to notify all registered observers of a connection being prepared.
void	releaseConnection() Release any held connection.
void	removeObserver(ConnectionObserver connectionObserver) Remove an observer

Methods inherited from interface org.hibernate.engine.jdbc.spi.LogicalConnection

close, getConnection, isOpen, isPhysicallyConnected

Method Detail

getJdbcServices

JdbcServices getJdbcServices()

Obtains the JDBC services associated with this logical connection.

Returns:

JDBC services

addObserver

void addObserver(ConnectionObserver observer)

Add an observer interested in notification of connection events.

Parameters:

observer - The observer.

removeObserver

void removeObserver(ConnectionObserver connectionObserver)

Remove an observer

Parameters:

connectionObserver - The observer to remove.

getConnectionReleaseMode

ConnectionReleaseMode getConnectionReleaseMode()

The release mode under which this logical connection is operating.

Returns:

the release mode.

manualDisconnect

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(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.

aggressiveRelease

void aggressiveRelease()

Perform an aggressive release

releaseConnection

void releaseConnection()
                       throws JDBCException

Release any held connection.

Throws:

JDBCException - Indicates a problem releasing the connection

isAutoCommit

boolean isAutoCommit()

Is this logical connection in auto-commit mode?

Returns:

true if auto-commit

notifyObserversStatementPrepared

void notifyObserversStatementPrepared()

Callback to notify all registered observers of a connection being prepared.

isUserSuppliedConnection

boolean isUserSuppliedConnection()

Does this logical connection wrap a user/application supplied connection?

Returns:

true if the underlying connection was user supplied.