|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.hadoop.io.BinaryComparable org.apache.hadoop.io.BytesWritable
@InterfaceAudience.Public @InterfaceStability.Stable public class BytesWritable
A byte sequence that is usable as a key or value. It is resizable and distinguishes between the size of the sequence and the current capacity. The hash function is the front of the md5 of the buffer. The sort order is the same as memcmp.
Constructor Summary | |
---|---|
BytesWritable()
Create a zero-size sequence. |
|
BytesWritable(byte[] bytes)
Create a BytesWritable using the byte array as the initial value. |
|
BytesWritable(byte[] bytes,
int length)
Create a BytesWritable using the byte array as the initial value and length as the length. |
Method Summary | |
---|---|
byte[] |
copyBytes()
Get a copy of the bytes that is exactly the length of the data. |
boolean |
equals(Object right_obj)
Are the two byte sequences equal? |
byte[] |
get()
Deprecated. Use getBytes() instead. |
byte[] |
getBytes()
Get the data backing the BytesWritable. |
int |
getCapacity()
Get the capacity, which is the maximum size that could handled without resizing the backing storage. |
int |
getLength()
Get the current size of the buffer. |
int |
getSize()
Deprecated. Use getLength() instead. |
int |
hashCode()
Return a hash of the bytes returned from {#getBytes()}. |
void |
readFields(DataInput in)
Deserialize the fields of this object from in . |
void |
set(byte[] newData,
int offset,
int length)
Set the value to a copy of the given byte range |
void |
set(BytesWritable newData)
Set the BytesWritable to the contents of the given newData. |
void |
setCapacity(int new_cap)
Change the capacity of the backing storage. |
void |
setSize(int size)
Change the size of the buffer. |
String |
toString()
Generate the stream of bytes as hex pairs separated by ' '. |
void |
write(DataOutput out)
Serialize the fields of this object to out . |
Methods inherited from class org.apache.hadoop.io.BinaryComparable |
---|
compareTo, compareTo |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface java.lang.Comparable |
---|
compareTo |
Constructor Detail |
---|
public BytesWritable()
public BytesWritable(byte[] bytes)
bytes
- This array becomes the backing storage for the object.public BytesWritable(byte[] bytes, int length)
bytes
- This array becomes the backing storage for the object.length
- The number of bytes to use from array.Method Detail |
---|
public byte[] copyBytes()
getBytes()
for faster access to the underlying array.
public byte[] getBytes()
copyBytes()
if you need the returned array to be precisely the length of the data.
getBytes
in class BinaryComparable
@Deprecated public byte[] get()
getBytes()
instead.
public int getLength()
getLength
in class BinaryComparable
@Deprecated public int getSize()
getLength()
instead.
public void setSize(int size)
size
- The new number of bytespublic int getCapacity()
public void setCapacity(int new_cap)
new_cap
- The new capacity in bytes.public void set(BytesWritable newData)
newData
- the value to set this BytesWritable to.public void set(byte[] newData, int offset, int length)
newData
- the new values to copy inoffset
- the offset in newData to start atlength
- the number of bytes to copypublic void readFields(DataInput in) throws IOException
Writable
in
.
For efficiency, implementations should attempt to re-use storage in the existing object where possible.
readFields
in interface Writable
in
- DataInput
to deseriablize this object from.
IOException
public void write(DataOutput out) throws IOException
Writable
out
.
write
in interface Writable
out
- DataOuput
to serialize this object into.
IOException
public int hashCode()
BinaryComparable
hashCode
in class BinaryComparable
WritableComparator.hashBytes(byte[],int)
public boolean equals(Object right_obj)
equals
in class BinaryComparable
public String toString()
toString
in class Object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |