Package ball.lang.reflect

Class DefaultInvocationHandler

java.lang.Object

ball.lang.reflect.DefaultInvocationHandler

All Implemented Interfaces:

DefaultInterfaceMethodInvocationHandler, InvocationHandler

Direct Known Subclasses:

FacadeProxyInvocationHandler, InterceptingInvocationHandler

public class DefaultInvocationHandler
extends Object
implements DefaultInterfaceMethodInvocationHandler

Default InvocationHandler implementation. See invoke(Object,Method,Object[]).

Author:

Allen D. Ball

Constructor Summary

Constructors

Constructor	Description
DefaultInvocationHandler()

Method Summary

Modifier and Type	Method	Description
protected List<Class<?>>	getImplementedInterfacesOf(Class<?> type, Class<?>... types)	Method available to subclass implementations to get the implemented interfaces of the argument types.
Class<?>	getProxyClass(Class<?>... interfaces)	See Proxy.getProxyClass(ClassLoader,Class[]).
Object	invoke(Object proxy, Method method, Object[] argv)	If the method.isDefault(), that Method will be invoked directly.
Object	newProxyInstance(Class<?>... interfaces)	See Proxy.newProxyInstance(ClassLoader,Class[],InvocationHandler).

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultInvocationHandler

public DefaultInvocationHandler()

Method Detail

getProxyClass

public Class<?> getProxyClass(Class<?>... interfaces)
                       throws IllegalArgumentException

See Proxy.getProxyClass(ClassLoader,Class[]).

Parameters:

interfaces - The interface Classes the Proxy Class will implement.

Returns:

The Proxy.

Throws:

IllegalArgumentException

newProxyInstance

public Object newProxyInstance(Class<?>... interfaces)
                        throws IllegalArgumentException

See Proxy.newProxyInstance(ClassLoader,Class[],InvocationHandler). Default implementation invokes getProxyClass(Class...).

Parameters:

interfaces - The interface Classes the Proxy Class will implement.

Returns:

The Proxy.

Throws:

IllegalArgumentException

invoke

public Object invoke(Object proxy,
                     Method method,
                     Object[] argv)
              throws Throwable

If the method.isDefault(), that Method will be invoked directly. If the Method is declared in Object, it is applied to this InvocationHandler. Otherwise, the call will be dispatched to a declared Method on this InvocationHandler with the same name and compatible parameter types (forcing access if necessary).

Specified by:

invoke in interface DefaultInterfaceMethodInvocationHandler

Specified by:

invoke in interface InvocationHandler

Parameters:

proxy - The proxy instance.

method - The Method.

argv - The argument array.

Returns:

The value to return from the Method invocation.

Throws:

Exception - If no compatible Method is found or the Method cannot be invoked.

Throwable

getImplementedInterfacesOf

protected List<Class<?>> getImplementedInterfacesOf(Class<?> type,
                                                    Class<?>... types)

Method available to subclass implementations to get the implemented interfaces of the argument types. The default implementation caches the results.

Parameters:

type - The Class to analyze.

types - Additional Classes to analyze.

Returns:

The List of interface Classes.