org.apache.tapestry5.services
Interface MethodInvocationResult

All Known Implementing Classes:

MethodInvocationFailResult, MethodInvocationSuccessfulResult

public interface MethodInvocationResult

Captures the result of invoking a method.

Since:

5.2.0

Method Summary

java.lang.Object	getReturnValue() The return value from the method invocation.
<T extends java.lang.Throwable> T	getThrown(java.lang.Class<T> throwableClass) If isFail() is true, this method provides access to the actual checked exception that was thrown.
boolean	isFail() If true, then the method invocation ended with a checked exception being thrown.
void	rethrow() If the invocation threw a checked exception, this method will wrap that exception in a RuntimeException and throw that.

Method Detail

getReturnValue

java.lang.Object getReturnValue()

The return value from the method invocation. This will be null if the method returns null, is a void method, or if a checked exception was thrown by the method.

isFail

boolean isFail()

If true, then the method invocation ended with a checked exception being thrown.

rethrow

void rethrow()

If the invocation threw a checked exception, this method will wrap that exception in a RuntimeException and throw that. For most code that doesn't specifically care about the thrown exception, this method should be invoked before continuing on to examine getReturnValue().

getThrown

<T extends java.lang.Throwable> T getThrown(java.lang.Class<T> throwableClass)

If isFail() is true, this method provides access to the actual checked exception that was thrown.

Parameters:

throwableClass - the type of exception to match

Returns:

the exception, if the method invocation threw a checked exception, and the exception is assignable to the provided type. In other cases, null is returned.