Package dev.failsafe

Interface ExecutionContext<R>

Type Parameters:
R - result type
All Known Subinterfaces:
AsyncExecution<R>, AsyncExecutionInternal<R>, Execution<R>, ExecutionInternal<R>, SyncExecutionInternal<R>
All Known Implementing Classes:
AsyncExecutionImpl, ExecutionImpl, SyncExecutionImpl

public interface ExecutionContext<R>
Contextual execution information.
  • Method Summary

    Modifier and Type
    Method
    Description
    int
    Gets the number of execution attempts so far, including attempts that are blocked before being executed, such as when a CircuitBreaker is open.
    Returns the elapsed time since the last execution attempt began.
    Returns the elapsed time since initial execution began.
    int
    Gets the number of completed executions so far.
    <T extends Throwable>
    T
    Returns the last exception that was recorded else null.
    Returns the last result that was recorded else null.
    getLastResult(R defaultValue)
    Returns the last result that was recorded else the defaultValue.
    Returns the time that the initial execution started.
    boolean
    Returns whether the execution has been cancelled.
    boolean
    Returns true when an execution result has not yet been recorded, meaning this is the first execution attempt.
    boolean
    Returns true when an execution result has already been recorded, meaning the execution is being retried.
    void
    onCancel(CheckedRunnable cancelCallback)
    Sets the cancelCallback to be called if the execution is cancelled, such as by the resulting Call or CompletableFuture, or a Timeout.
  • Method Details

    • onCancel

      void onCancel(CheckedRunnable cancelCallback)
      Sets the cancelCallback to be called if the execution is cancelled, such as by the resulting Call or CompletableFuture, or a Timeout. Any exception thrown by the cancelCallback is ignored.
    • getElapsedTime

      Duration getElapsedTime()
      Returns the elapsed time since initial execution began.
    • getElapsedAttemptTime

      Duration getElapsedAttemptTime()
      Returns the elapsed time since the last execution attempt began.
    • getAttemptCount

      int getAttemptCount()
      Gets the number of execution attempts so far, including attempts that are blocked before being executed, such as when a CircuitBreaker is open. Will return 0 when the first attempt is in progress or has yet to begin.
    • getExecutionCount

      int getExecutionCount()
      Gets the number of completed executions so far. Executions that are blocked, such as when a CircuitBreaker is open, are not counted. Will return 0 when the first attempt is in progress or has yet to begin.
    • getLastException

      <T extends Throwable> T getLastException()
      Returns the last exception that was recorded else null.
    • getLastResult

      R getLastResult()
      Returns the last result that was recorded else null.
    • getLastResult

      R getLastResult(R defaultValue)
      Returns the last result that was recorded else the defaultValue.
    • getStartTime

      Instant getStartTime()
      Returns the time that the initial execution started.
    • isCancelled

      boolean isCancelled()
      Returns whether the execution has been cancelled. In this case the implementor should attempt to stop execution.
    • isFirstAttempt

      boolean isFirstAttempt()
      Returns true when an execution result has not yet been recorded, meaning this is the first execution attempt.
    • isRetry

      boolean isRetry()
      Returns true when an execution result has already been recorded, meaning the execution is being retried.