org.hibernate.resource.jdbc

Interface LogicalConnection

All Known Subinterfaces:

LogicalConnectionImplementor

All Known Implementing Classes:

AbstractLogicalConnectionImplementor, LogicalConnectionManagedImpl, LogicalConnectionProvidedImpl

public interface LogicalConnection

Models the logical notion of a JDBC Connection. We may release/re-acquire physical JDBC connections under the covers, but this logically represents the overall access to the JDBC Connection.

Author:

Steve Ebersole

Method Summary

Modifier and Type	Method and Description
Connection	close() Closes the JdbcSession, making it inactive and forcing release of any held resources
ResourceRegistry	getResourceRegistry() Provides access to the registry of JDBC resources associated with this LogicalConnection.
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)?

Method Detail

isOpen

boolean isOpen()

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

Returns:

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

close

Connection close()

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

boolean isPhysicallyConnected()

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.

getResourceRegistry

ResourceRegistry getResourceRegistry()

Provides access to the registry of JDBC resources associated with this LogicalConnection.

Returns:

The JDBC resource registry.

Throws:

ResourceClosedException - if the LogicalConnection is closed