RunningJob (Hadoop 1.2.2-SNAPSHOT API)

```
public interface RunningJob
```
RunningJob is the user-interface to query for details on a running Map-Reduce job.
Clients can get hold of RunningJob via the JobClient and then query the running-job for details such as name, configuration, progress etc.

另请参阅:
JobClient

方法概要

方法
限定符和类型	方法和说明
`float`	`cleanupProgress()` Get the progress of the job's cleanup-tasks, as a float between 0.0 and 1.0.
`Counters`	`getCounters()` Gets the counters for this job.
`String`	`getFailureInfo()` Get failure info for the job.
`JobID`	`getID()` Get the job identifier.
`String`	`getJobFile()` Get the path of the submitted job configuration.
`String`	`getJobID()` 已过时。 This method is deprecated and will be removed. Applications should rather use `getID()`.
`String`	`getJobName()` Get the name of the job.
`int`	`getJobState()` Returns the current state of the Job.
`JobStatus`	`getJobStatus()` Returns a snapshot of the current status, `JobStatus`, of the Job.
`TaskCompletionEvent[]`	`getTaskCompletionEvents(int startFrom)` Get events indicating completion (success/failure) of component tasks.
`String[]`	`getTaskDiagnostics(TaskAttemptID taskid)` Gets the diagnostic messages for a given task attempt.
`String`	`getTrackingURL()` Get the URL where some job progress information will be displayed.
`boolean`	`isComplete()` Check if the job is finished or not.
`boolean`	`isSuccessful()` Check if the job completed successfully.
`void`	`killJob()` Kill the running job.
`void`	`killTask(String taskId, boolean shouldFail)` 已过时。 Applications should rather use `killTask(TaskAttemptID, boolean)`
`void`	`killTask(TaskAttemptID taskId, boolean shouldFail)` Kill indicated task attempt.
`float`	`mapProgress()` Get the progress of the job's map-tasks, as a float between 0.0 and 1.0.
`float`	`reduceProgress()` Get the progress of the job's reduce-tasks, as a float between 0.0 and 1.0.
`void`	`setJobPriority(String priority)` Set the priority of a running job.
`float`	`setupProgress()` Get the progress of the job's setup-tasks, as a float between 0.0 and 1.0.
`void`	`waitForCompletion()` Blocks until the job is complete.

- 方法详细资料
  - getID
```
JobID getID()
```
    Get the job identifier.
    
    返回:
    the job identifier.
  - getJobID
```
@Deprecated
String getJobID()
```
    已过时。 This method is deprecated and will be removed. Applications should rather use getID().
  - getJobName
```
String getJobName()
```
    Get the name of the job.
    
    返回:
    the name of the job.
  - getJobFile
```
String getJobFile()
```
    Get the path of the submitted job configuration.
    
    返回:
    the path of the submitted job configuration.
  - getTrackingURL
```
String getTrackingURL()
```
    Get the URL where some job progress information will be displayed.
    
    返回:
    the URL where some job progress information will be displayed.
  - mapProgress
```
float mapProgress()
                  throws IOException
```
    Get the progress of the job's map-tasks, as a float between 0.0 and 1.0. When all map tasks have completed, the function returns 1.0.
    
    返回:
    the progress of the job's map-tasks.
    
    抛出:
    
    IOException
  - reduceProgress
```
float reduceProgress()
                     throws IOException
```
    Get the progress of the job's reduce-tasks, as a float between 0.0 and 1.0. When all reduce tasks have completed, the function returns 1.0.
    
    返回:
    the progress of the job's reduce-tasks.
    
    抛出:
    
    IOException
  - cleanupProgress
```
float cleanupProgress()
                      throws IOException
```
    Get the progress of the job's cleanup-tasks, as a float between 0.0 and 1.0. When all cleanup tasks have completed, the function returns 1.0.
    
    返回:
    the progress of the job's cleanup-tasks.
    
    抛出:
    
    IOException
  - setupProgress
```
float setupProgress()
                    throws IOException
```
    Get the progress of the job's setup-tasks, as a float between 0.0 and 1.0. When all setup tasks have completed, the function returns 1.0.
    
    返回:
    the progress of the job's setup-tasks.
    
    抛出:
    
    IOException
  - isComplete
```
boolean isComplete()
                   throws IOException
```
    Check if the job is finished or not. This is a non-blocking call.
    
    返回:
    true if the job is complete, else false.
    
    抛出:
    
    IOException
  - isSuccessful
```
boolean isSuccessful()
                     throws IOException
```
    Check if the job completed successfully.
    
    返回:
    true if the job succeeded, else false.
    
    抛出:
    
    IOException
  - waitForCompletion
```
void waitForCompletion()
                       throws IOException
```
    Blocks until the job is complete.
    
    抛出:
    
    IOException
  - getJobState
```
int getJobState()
                throws IOException
```
    Returns the current state of the Job.
    
    抛出:
    
    IOException
  - getJobStatus
```
JobStatus getJobStatus()
                       throws IOException
```
    Returns a snapshot of the current status, JobStatus, of the Job. Need to call again for latest information.
    
    抛出:
    
    IOException
  - killJob
```
void killJob()
             throws IOException
```
    Kill the running job. Blocks until all job tasks have been killed as well. If the job is no longer running, it simply returns.
    
    抛出:
    
    IOException
  - setJobPriority
```
void setJobPriority(String priority)
                    throws IOException
```
    Set the priority of a running job.
    
    参数:
    priority - the new priority for the job.
    
    抛出:
    
    IOException
  - getTaskCompletionEvents
```
TaskCompletionEvent[] getTaskCompletionEvents(int startFrom)
                                              throws IOException
```
    Get events indicating completion (success/failure) of component tasks.
    
    参数:
    startFrom - index to start fetching events from
    
    返回:
    an array of TaskCompletionEvents
    
    抛出:
    
    IOException
  - killTask
```
void killTask(TaskAttemptID taskId,
            boolean shouldFail)
              throws IOException
```
    Kill indicated task attempt.
    
    参数:
    taskId - the id of the task to be terminated.
    shouldFail - if true the task is failed and added to failed tasks list, otherwise it is just killed, w/o affecting job failure status.
    
    抛出:
    
    IOException
  - killTask
```
@Deprecated
void killTask(String taskId,
                       boolean shouldFail)
              throws IOException
```
    已过时。 Applications should rather use killTask(TaskAttemptID, boolean)
    
    抛出:
    
    IOException
  - getCounters
```
Counters getCounters()
                     throws IOException
```
    Gets the counters for this job.
    
    返回:
    the counters for this job.
    
    抛出:
    
    IOException
  - getFailureInfo
```
String getFailureInfo()
                      throws IOException
```
    Get failure info for the job.
    
    返回:
    the failure info for the job.
    
    抛出:
    
    IOException
  - getTaskDiagnostics
```
String[] getTaskDiagnostics(TaskAttemptID taskid)
                            throws IOException
```
    Gets the diagnostic messages for a given task attempt.
    
    参数:
    taskid -
    
    返回:
    the list of diagnostic messages for the task
    
    抛出:
    
    IOException

接口 RunningJob

方法概要

方法详细资料

getID

getJobID

getJobName

getJobFile

getTrackingURL

mapProgress

reduceProgress

cleanupProgress

setupProgress

isComplete

isSuccessful

waitForCompletion

getJobState

getJobStatus

killJob

setJobPriority

getTaskCompletionEvents

killTask

killTask

getCounters

getFailureInfo

getTaskDiagnostics