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

  Modifier and Type
  Method
  Description
  `Object`
  `getReturnValue()`
  The return value from the method invocation.
  `<T extends Throwable>
  T`
  `getThrown(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 Details

  - ### getReturnValue

    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 Throwable> T getThrown(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.