BorrowedConnectionProxy (Hibernate Core 3.3.1.GA API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.hibernate.jdbc
Class BorrowedConnectionProxy

java.lang.Object
  org.hibernate.jdbc.BorrowedConnectionProxy

All Implemented Interfaces:: java.lang.reflect.InvocationHandler

public class BorrowedConnectionProxy
extends java.lang.Object
implements java.lang.reflect.InvocationHandler
extends java.lang.Object
implements java.lang.reflect.InvocationHandler

A proxy for borrowed connections which funnels all requests back into the ConnectionManager from which it was borrowed to be properly handled (in terms of connection release modes).

Note: the term borrowed here refers to connection references obtained via Session.connection() for application usage.

Author:: Steve Ebersole

Constructor Summary
`BorrowedConnectionProxy(ConnectionManager connectionManager)`

Method Summary
`static java.sql.Connection`	`generateProxy(ConnectionManager connectionManager)` Generates a Connection proxy wrapping the connection managed by the passed connection manager.
`static java.lang.ClassLoader`	`getProxyClassLoader()` Determines the appropriate class loader to which the generated proxy should be scoped.
`static java.sql.Connection`	`getWrappedConnection(java.sql.Connection connection)` Convience method for unwrapping a connection proxy and getting a handle to an underlying connection.
`java.lang.Object`	`invoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args)`
`static void`	`renderUnuseable(java.sql.Connection connection)` Marks a borrowed connection as no longer usable.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

BorrowedConnectionProxy

public BorrowedConnectionProxy(ConnectionManager connectionManager)

Method Detail

invoke

public java.lang.Object invoke(java.lang.Object proxy,
                               java.lang.reflect.Method method,
                               java.lang.Object[] args)
                        throws java.lang.Throwable

Specified by:: invoke in interface java.lang.reflect.InvocationHandler

Throws:: java.lang.Throwable

generateProxy

public static java.sql.Connection generateProxy(ConnectionManager connectionManager)

Generates a Connection proxy wrapping the connection managed by the passed connection manager.

Parameters:: connectionManager - The connection manager to wrap with the connection proxy.
Returns:: The generated proxy.

renderUnuseable

public static void renderUnuseable(java.sql.Connection connection)

Marks a borrowed connection as no longer usable.

Parameters:: connection - The connection (proxy) to be marked.

getWrappedConnection

public static java.sql.Connection getWrappedConnection(java.sql.Connection connection)

Convience method for unwrapping a connection proxy and getting a handle to an underlying connection.

Parameters:: connection - The connection (proxy) to be unwrapped.
Returns:: The unwrapped connection.

getProxyClassLoader

public static java.lang.ClassLoader getProxyClassLoader()

Determines the appropriate class loader to which the generated proxy should be scoped.

Returns:: The class loader appropriate for proxy construction.