org.hibernate.resource.jdbc.spi

Interface LogicalConnectionImplementor

All Superinterfaces:

LogicalConnection

All Known Implementing Classes:

AbstractLogicalConnectionImplementor, LogicalConnectionManagedImpl, LogicalConnectionProvidedImpl

public interface LogicalConnectionImplementor
extends LogicalConnection

SPI contract for LogicalConnection

Author:

Steve Ebersole

Method Summary

Modifier and Type	Method and 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
Connection	getPhysicalConnection() Exposes access to the "real" Connection.
PhysicalJdbcTransaction	getPhysicalJdbcTransaction()
LogicalConnectionImplementor	makeShareableCopy() Creates a shareable copy of itself for use in "shared sessions"
Connection	manualDisconnect() Manually disconnect the underlying JDBC Connection.
void	manualReconnect(Connection suppliedConnection) Manually reconnect the underlying JDBC Connection.
void	serialize(ObjectOutputStream oos) Serialization hook

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

close, getResourceRegistry, isOpen, isPhysicallyConnected

Method Detail

getPhysicalConnection

Connection getPhysicalConnection()

Exposes access to the "real" Connection.

Returns:

The connection

afterStatement

void afterStatement()

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

afterTransaction

void afterTransaction()

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

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.

makeShareableCopy

LogicalConnectionImplementor makeShareableCopy()

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

Returns:

The shareable copy.

getPhysicalJdbcTransaction

PhysicalJdbcTransaction getPhysicalJdbcTransaction()

serialize

void serialize(ObjectOutputStream oos)
        throws IOException

Serialization hook

Parameters:

oos - The stream to write out state to

Throws:

IOException - Problem accessing stream