org.openejb.client.proxy
Interface ProxyFactory

All Known Implementing Classes:

Jdk13ProxyFactory

public interface ProxyFactory

Allows us to implement different versions of Proxies

Since:

11/25/2001

Author:

David Blevins

Method Summary

InvocationHandler	getInvocationHandler(Object proxy) Returns the invocation handler for the specified proxy instance.
Class	getProxyClass(Class interfce) Returns the java.lang.Class object for a proxy class given a class loader and an array of interfaces.
Class	getProxyClass(Class[] interfaces) Returns the java.lang.Class object for a proxy class given a class loader and an array of interfaces.
void	init(Properties props) Prepares the ProxyFactory for use.
boolean	isProxyClass(Class cl) Returns true if and only if the specified class was dynamically generated to be a proxy class using the getProxyClass method or the newProxyInstance method.
Object	newProxyInstance(Class proxyClass) Returns a new proxy instance from the specified proxy class.
Object	newProxyInstance(Class[] interfaces, InvocationHandler h) Returns an instance of a proxy class for the specified interface that dispatches method invocations to the specified invocation handler.
Object	newProxyInstance(Class interfce, InvocationHandler h) Returns an instance of a proxy class for the specified interface that dispatches method invocations to the specified invocation handler.
Object	setInvocationHandler(Object proxy, InvocationHandler handler) Sets the invocation handler for the specified proxy instance.

Method Detail

init

void init(Properties props)

Prepares the ProxyFactory for use. Called once right after the ProxyFactory is instantiated.

Parameters:

props -

getInvocationHandler

InvocationHandler getInvocationHandler(Object proxy)
                                       throws IllegalArgumentException

Returns the invocation handler for the specified proxy instance.

Throws:

IllegalArgumentException

setInvocationHandler

Object setInvocationHandler(Object proxy,
                            InvocationHandler handler)
                            throws IllegalArgumentException

Sets the invocation handler for the specified proxy instance.

Throws:

IllegalArgumentException

getProxyClass

Class getProxyClass(Class interfce)
                    throws IllegalArgumentException

Returns the java.lang.Class object for a proxy class given a class loader and an array of interfaces.

Parameters:

interfce -

Returns:

Class

Throws:

IllegalArgumentException

getProxyClass

Class getProxyClass(Class[] interfaces)
                    throws IllegalArgumentException

Returns the java.lang.Class object for a proxy class given a class loader and an array of interfaces.

Parameters:

interfaces -

Returns:

Class

Throws:

IllegalArgumentException

isProxyClass

boolean isProxyClass(Class cl)

Returns true if and only if the specified class was dynamically generated to be a proxy class using the getProxyClass method or the newProxyInstance method.

Parameters:

cl -

Returns:

boolean

newProxyInstance

Object newProxyInstance(Class interfce,
                        InvocationHandler h)
                        throws IllegalArgumentException

Returns an instance of a proxy class for the specified interface that dispatches method invocations to the specified invocation handler.

Parameters:

interfce -

h -

Returns:

Object

Throws:

IllegalArgumentException

newProxyInstance

Object newProxyInstance(Class[] interfaces,
                        InvocationHandler h)
                        throws IllegalArgumentException

Returns an instance of a proxy class for the specified interface that dispatches method invocations to the specified invocation handler.

Parameters:

interfaces -

h -

Returns:

Object

Throws:

IllegalArgumentException

newProxyInstance

Object newProxyInstance(Class proxyClass)
                        throws IllegalArgumentException

Returns a new proxy instance from the specified proxy class. The interface(s) implemented by the proxy instance are determined by the proxy class. The class name may or may not be meaningful, depending on the implementation.

Parameters:

proxyClass -

Returns:

Object

Throws:

IllegalArgumentException - Occurs when the specified class is not a proxy class.

IllegalArgumentException