org.infinispan.distexec

Interface FailoverContext

public interface FailoverContext

As DistributedTask might potentially fail on subset of executing nodes FailureContext provides details of such task failure. FailureContext has a scope of a node where the task failed.

Since:

5.2

Author:

Vladimir Blagojevic

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Throwable	cause() Returns the Throwable which was the cause of the task failure.
java.util.List<org.infinispan.remoting.transport.Address>	executionCandidates() Returns a list of candidates for possible repeated execution governed by installed DistributedTaskFailoverPolicy
org.infinispan.remoting.transport.Address	executionFailureLocation() Returns an Address of the node where the task failed
<K> java.util.List<K>	inputKeys() Returns a list of input keys for this task.

Method Detail

executionFailureLocation

org.infinispan.remoting.transport.Address executionFailureLocation()

Returns an Address of the node where the task failed

Returns:

the Address of the failed execution location

executionCandidates

java.util.List<org.infinispan.remoting.transport.Address> executionCandidates()

Returns a list of candidates for possible repeated execution governed by installed DistributedTaskFailoverPolicy

Returns:

an Address list of possible execution candidates

cause

java.lang.Throwable cause()

Returns the Throwable which was the cause of the task failure. This includes both system exception related to Infinispan transient failures (node crash, transient errors etc) as well as application level exceptions. Returned Throwable will most likely contain the chain of Exceptions that interested clients can inspect and, if desired, find the root cause of the returned Throwable

Returns:

the Throwable that caused task failure on the particular Infinispan node

See Also:

Throwable#getCause()} API to recursively traverse the Exception chain

inputKeys

<K> java.util.List<K> inputKeys()

Returns a list of input keys for this task. Note that this method does not return all of the keys used as input for DistributedTask but rather only the input keys used as input for a part of that task where the execution failed

Type Parameters:

K -

Returns:

the list of input keys if any