org.apache.ignite.compute

## Interface ComputeJobResult

-     public interface ComputeJobResult

  Result of remote job which gets passed into `ComputeTask.result(ComputeJobResult, List)` method.

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method and Description
    --- | ---
    `<T> T` | `getData()` Gets data returned by remote job if it didn't fail.
    `IgniteException` | `getException()` Gets exception produced by execution of remote job, or `null` if remote execution finished normally and did not produce any exceptions.
    `<T extends ComputeJob> T` | `getJob()` Gets local instance of remote job returned by `ComputeTask.map(List, Object)` method.
    `ComputeJobContext` | `getJobContext()` Gets job context.
    `ClusterNode` | `getNode()` Gets node this job executed on.
    `boolean` | `isCancelled()` Gets job cancellation status.

- - ### Method Detail

    - #### getJobContext

          ComputeJobContext 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 `ComputeJob.execute()` method.

      Note that if task is annotated with `ComputeTaskNoResultCache` annotation, then job results will not be cached and will be available only in `ComputeTask.result(ComputeJobResult, List)` method for every individual job, but not in `ComputeTask.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 `ComputeJob.execute()` method.
      Returns:
        Data returned by remote job's `ComputeJob.execute()` method if it didn't fail.

    - #### getException

          IgniteException getException()

      Gets exception produced by execution of remote job, or `null` if remote execution finished normally and did not produce any exceptions.
      Returns:
        `IgniteException` 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 `ComputeUserUndeclaredException` returned by this method.

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

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

    - #### getJob

          <T extends ComputeJob> T getJob()

      Gets local instance of remote job returned by `ComputeTask.map(List, Object)` method.
      Type Parameters:
        `T` - Type of `ComputeJob` that was sent to remote node.
      Returns:
        Local instance of remote job returned by `ComputeTask.map(List, Object)` method.

    - #### getNode

          ClusterNode 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 `IgniteFuture.cancel()`) or if task completed prior to getting results from all remote jobs.

      Returns:
        `true` if job received cancellation request and `false` otherwise.

${current.year} Copyright © Apache Software Foundation
| Follow @ApacheIgnite
Ignite Database and Caching Platform | : ver. 2.16.0
Release Date | : December 15 2023