Package ball.lang.reflect

Class FacadeProxyInvocationHandler

java.lang.Object

ball.lang.reflect.DefaultInvocationHandler

ball.lang.reflect.FacadeProxyInvocationHandler

All Implemented Interfaces:

DefaultInterfaceMethodInvocationHandler, InvocationHandler

Direct Known Subclasses:

FluentNode.InvocationHandler

public abstract class FacadeProxyInvocationHandler
extends DefaultInvocationHandler

InvocationHandler abstract base class to "extend" concrete implementation Classes by adding "facade" interfaces. See getProxyClassFor(Object).

Author:

Allen D. Ball

Constructor Summary

Constructors

Constructor	Description
FacadeProxyInvocationHandler()

Method Summary

Modifier and Type	Method	Description
Object	enhance(Object in)	Method to return an extended Proxy implementing "facade" interfaces for in if getProxyClassFor(Object) returns non-null.
protected abstract Class<?>	getProxyClassFor(Object object)	Method provided by subclasses to provide the Proxy Class if the input Object should be extended.
Object	invoke(Object proxy, Method method, Object[] argv)	If the method.isDefault(), that Method will be invoked directly.

Methods inherited from class ball.lang.reflect.DefaultInvocationHandler

getImplementedInterfacesOf, getProxyClass, newProxyInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

FacadeProxyInvocationHandler

public FacadeProxyInvocationHandler()

Method Detail

enhance

public Object enhance(Object in)

Method to return an extended Proxy implementing "facade" interfaces for in if getProxyClassFor(Object) returns non-null.

Parameters:

in - The Object to extend.

Returns:

A Proxy if getProxyClassFor(Object) returns non-null; in otherwise.

getProxyClassFor

protected abstract Class<?> getProxyClassFor(Object object)

Method provided by subclasses to provide the Proxy Class if the input Object should be extended.

Parameters:

object - The Object that may or may not be extended.

Returns:

A Proxy Class if the Object should be extended; null otherwise.

invoke

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

Description copied from class: DefaultInvocationHandler

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

Overrides:

invoke in class DefaultInvocationHandler

Parameters:

proxy - The proxy instance.

method - The Method.

argv - The argument array.

Returns:

The value to return from the Method invocation.

Throws:

Throwable