org.hibernate.engine.jdbc.spi
Interface LogicalConnection

All Superinterfaces:
Serializable
All Known Subinterfaces:
LogicalConnectionImplementor
All Known Implementing Classes:
LogicalConnectionImpl

public interface LogicalConnection
extends Serializable

LogicalConnection contract


Method Summary
 void afterTransaction()
          Signals the end of current transaction in which this logical connection operated.
 Connection close()
          Release the underlying connection and clean up any other resources associated with this logical connection.
 Connection getConnection()
          Retrieves the connection currently "logically" managed by this LogicalConnectionImpl.
 Connection getDistinctConnectionProxy()
          Retrieves a distinct connection proxy.
 Connection getShareableConnectionProxy()
          Retrieves the shareable connection proxy.
 boolean isOpen()
          Is this logical connection open? Another phraseology sometimes used is: "are we logically connected"?
 boolean isPhysicallyConnected()
          Is this logical connection instance "physically" connected.
 

Method Detail

isOpen

boolean isOpen()
Is this logical connection open? Another phraseology sometimes used is: "are we logically connected"?

Returns:
True if logically connected; false otherwise.

isPhysicallyConnected

boolean isPhysicallyConnected()
Is this logical connection instance "physically" connected. Meaning do we currently internally have a cached connection.

Returns:
True if physically connected; false otherwise.

getConnection

Connection getConnection()
Retrieves the connection currently "logically" managed by this LogicalConnectionImpl.

Note, that we may need to obtain a connection to return here if a connection has either not yet been obtained (non-UserSuppliedConnectionProvider) or has previously been aggressively released.

Returns:
The current Connection.

getShareableConnectionProxy

Connection getShareableConnectionProxy()
Retrieves the shareable connection proxy.

Returns:
The shareable connection proxy.

getDistinctConnectionProxy

Connection getDistinctConnectionProxy()
Retrieves a distinct connection proxy. It is distinct in that it is not shared with others unless the caller explicitly shares it.

Returns:
The distinct connection proxy.

close

Connection close()
Release the underlying connection and clean up any other resources associated with this logical connection.

This leaves the logical connection in a "no longer usable" state.

Returns:
The application-supplied connection, or null if Hibernate was managing connection.

afterTransaction

void afterTransaction()
Signals the end of current transaction in which this logical connection operated.



Copyright © 2001-2013 Red Hat, Inc. All Rights Reserved.