Package 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
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.Object
getReturnValue()
The return value from the method invocation.<T extends java.lang.Throwable>
TgetThrown(java.lang.Class<T> throwableClass)
IfisFail()
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 examinegetReturnValue()
.
-
getThrown
<T extends java.lang.Throwable> T getThrown(java.lang.Class<T> throwableClass)
IfisFail()
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.
-
-