org.apache.hadoop.mapreduce
Class JobID

java.lang.Object
  extended by org.apache.hadoop.mapreduce.ID
      extended by org.apache.hadoop.mapred.ID
          extended by org.apache.hadoop.mapreduce.JobID
All Implemented Interfaces:
Comparable<ID>, Writable, WritableComparable<ID>
Direct Known Subclasses:
JobID

public class JobID
extends ID
implements Comparable<ID>

JobID represents the immutable and unique identifier for the job. JobID consists of two parts. First part represents the jobtracker identifier, so that jobID to jobtracker map is defined. For cluster setup this string is the jobtracker start time, for local setting, it is "local". Second part of the JobID is the job number.
An example JobID is : job_200707121733_0003 , which represents the third job running at the jobtracker started at 200707121733.

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

See Also:
TaskID, TaskAttemptID, JobTracker.getNewJobId(), JobTracker.getStartTime()

Field Summary
protected static NumberFormat idFormat
           
protected static String JOB
           
static String JOBID_REGEX
           
 
Fields inherited from class org.apache.hadoop.mapreduce.ID
id, SEPARATOR
 
Constructor Summary
JobID()
           
JobID(String jtIdentifier, int id)
          Constructs a JobID object
 
Method Summary
 StringBuilder appendTo(StringBuilder builder)
          Add the stuff after the "job" prefix to the given builder.
 int compareTo(ID o)
          Compare JobIds by first jtIdentifiers, then by job numbers
 boolean equals(Object o)
           
static JobID forName(String str)
          Construct a JobId object from given string
 String getJtIdentifier()
           
 int hashCode()
           
 void readFields(DataInput in)
          Deserialize the fields of this object from in.
 String toString()
           
 void write(DataOutput out)
          Serialize the fields of this object to 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

JOB

protected static final String JOB
See Also:
Constant Field Values

JOBID_REGEX

public static final String JOBID_REGEX
See Also:
Constant Field Values

idFormat

protected static final NumberFormat idFormat
Constructor Detail

JobID

public JobID(String jtIdentifier,
             int id)
Constructs a JobID object

Parameters:
jtIdentifier - jobTracker identifier
id - job number

JobID

public JobID()
Method Detail

getJtIdentifier

public String getJtIdentifier()

equals

public boolean equals(Object o)
Overrides:
equals in class ID

compareTo

public int compareTo(ID o)
Compare JobIds by first jtIdentifiers, then by job numbers

Specified by:
compareTo in interface Comparable<ID>
Overrides:
compareTo in class ID

appendTo

public StringBuilder appendTo(StringBuilder builder)
Add the stuff after the "job" prefix to the given builder. This is useful, because the sub-ids use this substring at the start of their string.

Parameters:
builder - the builder to append to
Returns:
the builder that was passed in

hashCode

public int hashCode()
Overrides:
hashCode in class ID

toString

public String toString()
Overrides:
toString in class ID

readFields

public void readFields(DataInput in)
                throws IOException
Description copied from interface: Writable
Deserialize the fields of this object from in.

For efficiency, implementations should attempt to re-use storage in the existing object where possible.

Specified by:
readFields in interface Writable
Overrides:
readFields in class ID
Parameters:
in - DataInput to deseriablize this object from.
Throws:
IOException

write

public void write(DataOutput out)
           throws IOException
Description copied from interface: Writable
Serialize the fields of this object to out.

Specified by:
write in interface Writable
Overrides:
write in class ID
Parameters:
out - DataOuput to serialize this object into.
Throws:
IOException

forName

public static JobID forName(String str)
                     throws IllegalArgumentException
Construct a JobId object from given string

Returns:
constructed JobId object or null if the given String is null
Throws:
IllegalArgumentException - if the given string is malformed


Copyright © 2009 The Apache Software Foundation