com.thoughtworks.proxy.toys.decorate

Class Decorator<T>

java.lang.Object

com.thoughtworks.proxy.toys.decorate.Decorator<T>

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

EchoDecorator

public abstract class Decorator<T>
extends java.lang.Object
implements java.io.Serializable

Identity implementation for a Decorator. The implementation will just pass through any values. Override all methods that should behave differently.

Since:

1.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
Decorator()

Method Summary

Modifier and Type	Method and Description
java.lang.Object[]	beforeMethodStarts(T proxy, java.lang.reflect.Method method, java.lang.Object[] args) Called before a method is invoked on an object, to possibly decorate the arguments being passed to the method invocation.
java.lang.Exception	decorateInvocationException(T proxy, java.lang.reflect.Method method, java.lang.Object[] args, java.lang.Exception cause) Called when a method cannot be invoked, to possibly decorate the type of error.
java.lang.Object	decorateResult(T proxy, java.lang.reflect.Method method, java.lang.Object[] args, java.lang.Object result) Called on the way back from a method invocation, to possibly decorate the result.
java.lang.Throwable	decorateTargetException(T proxy, java.lang.reflect.Method method, java.lang.Object[] args, java.lang.Throwable cause) Called when a called method fails, to possibly decorate the type of error.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

Constructor Detail

Decorator

public Decorator()

Method Detail

beforeMethodStarts

public java.lang.Object[] beforeMethodStarts(T proxy,
                                             java.lang.reflect.Method method,
                                             java.lang.Object[] args)

Called before a method is invoked on an object, to possibly decorate the arguments being passed to the method invocation.

Parameters:

proxy - the proxy the method will be invoked on

method - the method to be invoked

args - the arguments being passed to the method

Returns:

the decorated arguments (typically just the ones supplied)

Since:

1.0

decorateResult

public java.lang.Object decorateResult(T proxy,
                                       java.lang.reflect.Method method,
                                       java.lang.Object[] args,
                                       java.lang.Object result)

Called on the way back from a method invocation, to possibly decorate the result.

Parameters:

proxy - the proxy the method was be invoked on

method - the invoked method

args - the arguments passed to the method

result - the result of the method invocation

Returns:

the decorated result (typically just the supplied result)

Since:

1.0

decorateTargetException

public java.lang.Throwable decorateTargetException(T proxy,
                                                   java.lang.reflect.Method method,
                                                   java.lang.Object[] args,
                                                   java.lang.Throwable cause)

Called when a called method fails, to possibly decorate the type of error.

Parameters:

proxy - the proxy the method was be invoked on

method - the invoked method

args - the arguments passed to the method

cause - the original exception thrown

Returns:

the decorated exception (typically just the supplied cause)

Since:

1.0

decorateInvocationException

public java.lang.Exception decorateInvocationException(T proxy,
                                                       java.lang.reflect.Method method,
                                                       java.lang.Object[] args,
                                                       java.lang.Exception cause)

Called when a method cannot be invoked, to possibly decorate the type of error.

Parameters:

proxy - the proxy the method was be invoked on

method - the invoked method

args - the arguments passed to the method

cause - the original exception thrown

Returns:

the decorated exception (typically just the supplied cause)

Since:

1.0