org.apache.hadoop.mapreduce

Class TaskID

java.lang.Object

org.apache.hadoop.mapreduce.ID

org.apache.hadoop.mapred.ID

org.apache.hadoop.mapreduce.TaskID

All Implemented Interfaces:

java.lang.Comparable<ID>, org.apache.hadoop.io.Writable, org.apache.hadoop.io.WritableComparable<ID>

Direct Known Subclasses:

TaskID

public class TaskID
extends ID

TaskID represents the immutable and unique identifier for a Map or Reduce Task. Each TaskID encompasses multiple attempts made to execute the Map or Reduce Task, each of which are uniquely indentified by their TaskAttemptID. TaskID consists of 3 parts. First part is the JobID, that this TaskInProgress belongs to. Second part of the TaskID is either 'm' or 'r' representing whether the task is a map task or a reduce task. And the third part is the task number.
An example TaskID is : task_200707121733_0003_m_000005 , which represents the fifth map task in the third job running at the jobtracker started at 200707121733.

Applications should never construct or parse TaskID strings , but rather use appropriate constructors or forName(String) method.

See Also:

JobID, TaskAttemptID

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.text.NumberFormat	idFormat
protected static java.lang.String	TASK

Fields inherited from class org.apache.hadoop.mapreduce.ID

id, SEPARATOR

Constructor Summary

Constructors

Constructor and Description
TaskID()
TaskID(JobID jobId, boolean isMap, int id) Constructs a TaskID object from given JobID.
TaskID(java.lang.String jtIdentifier, int jobId, boolean isMap, int id) Constructs a TaskInProgressId object from given parts.
TaskID(java.lang.String jtIdentifier, int jobId, TaskType type, int id) Constructs a TaskInProgressId object from given parts.

Method Summary

Methods

Modifier and Type	Method and Description
protected java.lang.StringBuilder	appendTo(java.lang.StringBuilder builder) Add the unique string to the given builder.
int	compareTo(ID o) Compare TaskInProgressIds by first jobIds, then by tip numbers.
boolean	equals(java.lang.Object o)
static TaskID	forName(java.lang.String str) Construct a TaskID object from given string
JobID	getJobID() Returns the JobID object that this tip belongs to
TaskType	getTaskType() Get the type of the task
int	hashCode()
boolean	isMap() Returns whether this TaskID is a map ID
void	readFields(java.io.DataInput in)
java.lang.String	toString()
void	write(java.io.DataOutput out)

Methods inherited from class org.apache.hadoop.mapreduce.ID

getId

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

TASK

protected static final java.lang.String TASK

See Also:

Constant Field Values

idFormat

protected static final java.text.NumberFormat idFormat

Constructor Detail

TaskID

public TaskID(JobID jobId,
      boolean isMap,
      int id)

Constructs a TaskID object from given JobID.

Parameters:

jobId - JobID that this tip belongs to

isMap - whether the tip is a map

id - the tip number

TaskID

public TaskID(java.lang.String jtIdentifier,
      int jobId,
      boolean isMap,
      int id)

Constructs a TaskInProgressId object from given parts.

Parameters:

jtIdentifier - jobTracker identifier

jobId - job number

isMap - whether the tip is a map

id - the tip number

TaskID

public TaskID(java.lang.String jtIdentifier,
      int jobId,
      TaskType type,
      int id)

Constructs a TaskInProgressId object from given parts.

Parameters:

jtIdentifier - jobTracker identifier

jobId - job number

type - the TaskType

id - the tip number

TaskID

public TaskID()

Method Detail

getJobID

public JobID getJobID()

Returns the JobID object that this tip belongs to

isMap

public boolean isMap()

Returns whether this TaskID is a map ID

getTaskType

public TaskType getTaskType()

Get the type of the task

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class ID

compareTo

public int compareTo(ID o)

Compare TaskInProgressIds by first jobIds, then by tip numbers. Reduces are defined as greater then maps.

Specified by:

compareTo in interface java.lang.Comparable<ID>

Overrides:

compareTo in class ID

toString

public java.lang.String toString()

Overrides:

toString in class ID

appendTo

protected java.lang.StringBuilder appendTo(java.lang.StringBuilder builder)

Add the unique string to the given builder.

Parameters:

builder - the builder to append to

Returns:

the builder that was passed in

hashCode

public int hashCode()

Overrides:

hashCode in class ID

readFields

public void readFields(java.io.DataInput in)
                throws java.io.IOException

Specified by:

readFields in interface org.apache.hadoop.io.Writable

Overrides:

readFields in class ID

Throws:

java.io.IOException

write

public void write(java.io.DataOutput out)
           throws java.io.IOException

Specified by:

write in interface org.apache.hadoop.io.Writable

Overrides:

write in class ID

Throws:

java.io.IOException

forName

public static TaskID forName(java.lang.String str)
                      throws java.lang.IllegalArgumentException

Construct a TaskID object from given string

Returns:

constructed TaskID object or null if the given String is null

Throws:

java.lang.IllegalArgumentException - if the given string is malformed