org.hibernate.resource.jdbc.internal

Class LogicalConnectionProvidedImpl

java.lang.Object

org.hibernate.resource.jdbc.internal.AbstractLogicalConnectionImplementor

org.hibernate.resource.jdbc.internal.LogicalConnectionProvidedImpl

All Implemented Interfaces:

LogicalConnection, LogicalConnectionImplementor, PhysicalJdbcTransaction, JdbcResourceTransaction

public class LogicalConnectionProvidedImpl
extends AbstractLogicalConnectionImplementor

Author:

Steve Ebersole

Field Summary

Fields inherited from class org.hibernate.resource.jdbc.internal.AbstractLogicalConnectionImplementor

resourceRegistry

Constructor Summary

Constructors

Constructor and Description
LogicalConnectionProvidedImpl(Connection providedConnection)
LogicalConnectionProvidedImpl(Connection providedConnection, ResourceRegistry resourceRegistry)

Method Summary

Modifier and Type	Method and Description
protected void	afterCompletion()
Connection	close() Closes the JdbcSession, making it inactive and forcing release of any held resources
static LogicalConnectionProvidedImpl	deserialize(ObjectInputStream ois)
protected Connection	getConnectionForTransactionManagement()
Connection	getPhysicalConnection() Exposes access to the "real" Connection.
boolean	isOpen() Is this (logical) JDBC Connection still open/active.
boolean	isPhysicallyConnected() Is this JdbcSession currently physically connected (meaning does it currently hold a JDBC Connection)?
LogicalConnectionImplementor	makeShareableCopy() Creates a shareable copy of itself for use in "shared sessions"
Connection	manualDisconnect() Manually disconnect the underlying JDBC Connection.
void	manualReconnect(Connection connection) Manually reconnect the underlying JDBC Connection.
void	serialize(ObjectOutputStream oos) Serialization hook

Methods inherited from class org.hibernate.resource.jdbc.internal.AbstractLogicalConnectionImplementor

afterStatement, afterTransaction, begin, commit, determineInitialAutoCommitMode, errorIfClosed, getPhysicalJdbcTransaction, getResourceRegistry, getStatus, resetConnection, rollback

Methods inherited from class java.lang.Object

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

Constructor Detail

LogicalConnectionProvidedImpl

public LogicalConnectionProvidedImpl(Connection providedConnection)

LogicalConnectionProvidedImpl

public LogicalConnectionProvidedImpl(Connection providedConnection,
                                     ResourceRegistry resourceRegistry)

Method Detail

isOpen

public boolean isOpen()

Description copied from interface: LogicalConnection

Is this (logical) JDBC Connection still open/active. In other words, has LogicalConnection.close() not been called yet?

Returns:

true if still open (LogicalConnection.close() has not been called yet); false if not open ((LogicalConnection.close() has been called).

close

public Connection close()

Description copied from interface: LogicalConnection

Closes the JdbcSession, making it inactive and forcing release of any held resources

Returns:

Legacy :( Returns the JDBC Connection *if* the user passed in a Connection originally.

isPhysicallyConnected

public boolean isPhysicallyConnected()

Description copied from interface: LogicalConnection

Is this JdbcSession currently physically connected (meaning does it currently hold a JDBC Connection)?

Returns:

true if the JdbcSession currently hold a JDBC Connection; false if it does not.

getPhysicalConnection

public Connection getPhysicalConnection()

Description copied from interface: LogicalConnectionImplementor

Exposes access to the "real" Connection.

Returns:

The connection

makeShareableCopy

public LogicalConnectionImplementor makeShareableCopy()

Description copied from interface: LogicalConnectionImplementor

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

Returns:

The shareable copy.

serialize

public void serialize(ObjectOutputStream oos)
               throws IOException

Description copied from interface: LogicalConnectionImplementor

Serialization hook

Parameters:

oos - The stream to write out state to

Throws:

IOException - Problem accessing stream

deserialize

public static LogicalConnectionProvidedImpl deserialize(ObjectInputStream ois)
                                                 throws IOException,
                                                        ClassNotFoundException

Throws:

IOException

ClassNotFoundException

manualDisconnect

public Connection manualDisconnect()

Description copied from interface: LogicalConnectionImplementor

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

public void manualReconnect(Connection connection)

Description copied from interface: LogicalConnectionImplementor

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

Parameters:

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

getConnectionForTransactionManagement

protected Connection getConnectionForTransactionManagement()

Specified by:

getConnectionForTransactionManagement in class AbstractLogicalConnectionImplementor

afterCompletion

protected void afterCompletion()

Overrides:

afterCompletion in class AbstractLogicalConnectionImplementor