org.gridgain.grid.compute

Interface GridComputeJobResult

All Known Implementing Classes:

GridJobResultImpl

public interface GridComputeJobResult

Result of remote job which gets passed into GridComputeTask.result(GridComputeJobResult, List) method.

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	getData() Gets data returned by remote job if it didn't fail.
GridException	getException() Gets exception produced by execution of remote job, or null if remote execution finished normally and did not produce any exceptions.
<T extends GridComputeJob> T	getJob() Gets local instance of remote job returned by GridComputeTask.map(List, Object) method.
GridComputeJobContext	getJobContext() Gets job context.
GridNode	getNode() Gets node this job executed on.
boolean	isCancelled() Gets job cancellation status.

Method Detail

getJobContext

GridComputeJobContext getJobContext()

Gets job context. Use job context to access job unique ID or to get/set jobs attributes. Context is attached to a job and travels with it wherever it goes. For example, if a job gets failed-over from one node to another, then its context will be failed over with it and all attributes that were set on the job on the first node will be available on the new node.

Returns:

Job context.

getData

<T> T getData()

Gets data returned by remote job if it didn't fail. This data is the object returned from GridComputeJob.execute() method.

Note that if task is annotated with GridComputeTaskNoResultCache annotation, then job results will not be cached and will be available only in GridComputeTask.result(GridComputeJobResult, List) method for every individual job, but not in GridComputeTask.reduce(List) method. This feature was added to avoid excessive storing of overly large results.

Type Parameters:

T - Type of the return value returning from GridComputeJob.execute() method.

Returns:

Data returned by remote job's GridComputeJob.execute() method if it didn't fail.

getException

GridException getException()

Gets exception produced by execution of remote job, or null if remote execution finished normally and did not produce any exceptions.

Returns:

GridException produced by execution of remote job or null if no exception was produced.

Note that if remote job resulted in RuntimeException or Error then they will be wrapped into GridComputeUserUndeclaredException returned by this method.

If job on remote node was rejected (cancelled while it was on waiting queue), then GridComputeExecutionRejectedException will be returned.

If node on which job was computing failed, then GridTopologyException is returned.

getJob

<T extends GridComputeJob> T getJob()

Gets local instance of remote job returned by GridComputeTask.map(List, Object) method.

Type Parameters:

T - Type of GridComputeJob that was sent to remote node.

Returns:

Local instance of remote job returned by GridComputeTask.map(List, Object) method.

getNode

GridNode getNode()

Gets node this job executed on.

Returns:

Node this job executed on.

isCancelled

boolean isCancelled()

Gets job cancellation status. Returns true if job received cancellation request on remote node. Note that job, after receiving cancellation request, will still need to finish and return, hence getData() method may contain execution result even if the job was canceled.

Job can receive cancellation request if the task was explicitly cancelled from future (see GridFuture.cancel()) or if task completed prior to getting results from all remote jobs.

Returns:

true if job received cancellation request and false otherwise.