org.apache.hadoop.mapred.join

Class TupleWritable

java.lang.Object

org.apache.hadoop.mapred.join.TupleWritable

All Implemented Interfaces:

java.lang.Iterable<org.apache.hadoop.io.Writable>, org.apache.hadoop.io.Writable

public class TupleWritable
extends java.lang.Object
implements org.apache.hadoop.io.Writable, java.lang.Iterable<org.apache.hadoop.io.Writable>

Writable type storing multiple Writables. This is *not* a general-purpose tuple type. In almost all cases, users are encouraged to implement their own serializable types, which can perform better validation and provide more efficient encodings than this class is capable. TupleWritable relies on the join framework for type safety and assumes its instances will rarely be persisted, assumptions not only incompatible with, but contrary to the general case.

See Also:

Writable

Constructor Summary

Constructors

Constructor and Description
TupleWritable() Create an empty tuple with no allocated storage for writables.
TupleWritable(org.apache.hadoop.io.Writable[] vals) Initialize tuple with storage; unknown whether any of them contain "written" values.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object other)
org.apache.hadoop.io.Writable	get(int i) Get ith Writable from Tuple.
boolean	has(int i) Return true if tuple has an element at the position provided.
int	hashCode()
java.util.Iterator<org.apache.hadoop.io.Writable>	iterator() Return an iterator over the elements in this tuple.
void	readFields(java.io.DataInput in)
int	size() The number of children in this Tuple.
java.lang.String	toString() Convert Tuple to String as in the following.
void	write(java.io.DataOutput out) Writes each Writable to out.

Methods inherited from class java.lang.Object

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

Constructor Detail

TupleWritable

public TupleWritable()

Create an empty tuple with no allocated storage for writables.

TupleWritable

public TupleWritable(org.apache.hadoop.io.Writable[] vals)

Initialize tuple with storage; unknown whether any of them contain "written" values.

Method Detail

has

public boolean has(int i)

Return true if tuple has an element at the position provided.

get

public org.apache.hadoop.io.Writable get(int i)

Get ith Writable from Tuple.

size

public int size()

The number of children in this Tuple.

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

iterator

public java.util.Iterator<org.apache.hadoop.io.Writable> iterator()

Return an iterator over the elements in this tuple. Note that this doesn't flatten the tuple; one may receive tuples from this iterator.

Specified by:

iterator in interface java.lang.Iterable<org.apache.hadoop.io.Writable>

toString

public java.lang.String toString()

Convert Tuple to String as in the following. [,,...,]

Overrides:

toString in class java.lang.Object

write

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

Writes each Writable to out. TupleWritable format: <count><type1><type2>...<typen><obj1><obj2>...<objn>

Specified by:

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

Throws:

java.io.IOException

readFields

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

Specified by:

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

Throws:

java.io.IOException