org.canova.api.writable

Interface Writable

All Superinterfaces:

Serializable

All Known Subinterfaces:

InputFormat, InputSplit, WritableComparable<T>

All Known Implementing Classes:

ArrayWritable, BaseInputFormat, BaseInputSplit, BooleanWritable, ByteWritable, CollectionInputSplit, Configuration, CSVInputFormat, DoubleWritable, FileSplit, FloatWritable, InputStreamInputSplit, IntWritable, LibSvmInputFormat, LimitFileSplit, LineInputFormat, LongWritable, MatlabInputFormat, NullWritable, NumberedFileInputSplit, StringSplit, SVMLightInputFormat, Text

public interface Writable
extends Serializable

A serializable object which implements a simple, efficient, serialization protocol, based on DataInput and DataOutput.

Any key or value type in the Hadoop Map-Reduce framework implements this interface.

Implementations typically implement a static read(DataInput) method which constructs a new instance, calls readFields(DataInput) and returns the instance.

Example:

     public class MyWritable implements Writable {
       // Some data     
       private int counter;
       private long timestamp;

       public void write(DataOutput out) throws IOException {
         out.writeInt(counter);
         out.writeLong(timestamp);
       }

       public void readFields(DataInput in) throws IOException {
         counter = in.readInt();
         timestamp = in.readLong();
       }

       public static MyWritable read(DataInput in) throws IOException {
         MyWritable w = new MyWritable();
         w.readFields(in);
         return w;
       }
     }
 

Method Summary

Modifier and Type	Method and Description
void	readFields(DataInput in) Deserialize the fields of this object from in.
double	toDouble() Convert Writable to double.
float	toFloat() Convert Writable to float.
int	toInt() Convert Writable to int.
long	toLong() Convert Writable to long.
void	write(DataOutput out) Serialize the fields of this object to out.

Method Detail

write

void write(DataOutput out)
    throws IOException

Serialize the fields of this object to out.

Parameters:

out - DataOuput to serialize this object into.

Throws:

IOException

readFields

void readFields(DataInput in)
         throws IOException

Deserialize the fields of this object from in.

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

Parameters:

in - DataInput to deseriablize this object from.

Throws:

IOException

toDouble

double toDouble()

Convert Writable to double. Whether this is supported depends on the specific writable.

toFloat

float toFloat()

Convert Writable to float. Whether this is supported depends on the specific writable.

toInt

int toInt()

Convert Writable to int. Whether this is supported depends on the specific writable.

toLong

long toLong()

Convert Writable to long. Whether this is supported depends on the specific writable.