com.thoughtworks.proxy.toys.decorate

Interface InvocationDecorator

All Superinterfaces:

java.io.Serializable

All Known Implementing Classes:

EchoDecorator, InvocationDecoratorSupport

public interface InvocationDecorator
extends java.io.Serializable

Decorates a method invocation

Since:

0.1

Author:

Dan North

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object[]	beforeMethodStarts(java.lang.Object 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(java.lang.Object 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(java.lang.Object 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(java.lang.Object 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.

Method Detail

beforeMethodStarts

java.lang.Object[] beforeMethodStarts(java.lang.Object 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:

0.1

decorateResult

java.lang.Object decorateResult(java.lang.Object 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:

0.2, different arguments in 0.1

decorateTargetException

java.lang.Throwable decorateTargetException(java.lang.Object 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:

0.2, different arguments in 0.1

decorateInvocationException

java.lang.Exception decorateInvocationException(java.lang.Object 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:

0.2, different arguments in 0.1