net.jodah.recurrent

Class AsyncInvocation

java.lang.Object

net.jodah.recurrent.Invocation

net.jodah.recurrent.AsyncInvocation

public class AsyncInvocation
extends Invocation

Tracks asynchronous invocations and allows retries to be scheduled according to a RetryPolicy.

Field Summary

Fields inherited from class net.jodah.recurrent.Invocation

completed, lastFailure, lastResult

Method Summary

Modifier and Type	Method and Description
void	complete() Completes the invocation and the associated RecurrentFuture.
boolean	complete(Object result) Attempts to complete the invocation and the associated RecurrentFuture with the result.
boolean	complete(Object result, Throwable failure) Attempts to complete the invocation and the associated RecurrentFuture with the result and failure.
boolean	retry() Attempts to retry a failed invocation.
boolean	retryFor(Object result) Attempts to retry a failed invocation.
boolean	retryFor(Object result, Throwable failure) Attempts to retry a failed invocation.
boolean	retryOn(Throwable failure) Attempts to retry a failed invocation.

Methods inherited from class net.jodah.recurrent.Invocation

canRetryFor, canRetryFor, canRetryOn, getAttemptCount, getLastFailure, getLastResult, getWaitTime, isComplete, recordFailure

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

complete

public void complete()

Completes the invocation and the associated RecurrentFuture.

Overrides:

complete in class Invocation

Throws:

IllegalStateException - if the invocation is already complete

complete

public boolean complete(Object result)

Attempts to complete the invocation and the associated RecurrentFuture with the result. Returns true on success, else false if completion failed and should be retried via retry().

Overrides:

complete in class Invocation

Throws:

IllegalStateException - if the invocation is already complete

complete

public boolean complete(Object result,
                        Throwable failure)

Attempts to complete the invocation and the associated RecurrentFuture with the result and failure. Returns true on success, else false if completion failed and should be retried via retry().

Throws:

IllegalStateException - if the invocation is already complete

retry

public boolean retry()

Attempts to retry a failed invocation. Returns true if the retry can be attempted, else returns returns false and completes the invocation and associated RecurrentFuture.

Throws:

IllegalStateException - if a retry method has already been called or the invocation is already complete

retryFor

public boolean retryFor(Object result)

Attempts to retry a failed invocation. Returns true if the retry can be attempted for the result, else returns false and completes the invocation and associated RecurrentFuture.

Throws:

IllegalStateException - if a retry method has already been called or the invocation is already complete

retryFor

public boolean retryFor(Object result,
                        Throwable failure)

Attempts to retry a failed invocation. Returns true if the retry can be attempted for the result and failure, else returns false and completes the invocation and associated RecurrentFuture.

Throws:

IllegalStateException - if a retry method has already been called or the invocation is already complete

retryOn

public boolean retryOn(Throwable failure)

Attempts to retry a failed invocation. Returns true if the retry can be attempted for the failure, else returns false and completes the invocation and associated RecurrentFuture exceptionally.

Throws:

NullPointerException - if failure is null

IllegalStateException - if a retry method has already been called or the invocation is already complete