Package org.apache.hadoop.io

Class UTF8

java.lang.Object

org.apache.hadoop.io.UTF8

All Implemented Interfaces:

java.lang.Comparable<UTF8>, Writable, WritableComparable<UTF8>

@Deprecated
@LimitedPrivate({"HDFS","MapReduce"})
@Stable
public class UTF8
extends java.lang.Object
implements WritableComparable<UTF8>

Deprecated.

replaced by Text

A WritableComparable for strings that uses the UTF8 encoding.

Also includes utilities for efficiently reading and writing UTF-8. Note that this decodes UTF-8 but actually encodes CESU-8, a variant of UTF-8: see http://en.wikipedia.org/wiki/CESU-8

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	UTF8.Comparator	Deprecated. A WritableComparator optimized for UTF8 keys.

Constructor Summary

Constructors

Constructor	Description
UTF8()	Deprecated.
UTF8(java.lang.String string)	Deprecated. Construct from a given string.
UTF8(UTF8 utf8)	Deprecated. Construct from a given string.

Method Summary

Modifier and Type	Method	Description
int	compareTo(UTF8 o)	Deprecated. Compare two UTF8s.
boolean	equals(java.lang.Object o)	Deprecated. Returns true iff o is a UTF8 with the same contents.
static java.lang.String	fromBytes(byte[] bytes)	Deprecated.
byte[]	getBytes()	Deprecated.
static byte[]	getBytes(java.lang.String string)	Deprecated.
int	getLength()	Deprecated.
int	hashCode()	Deprecated.
void	readFields(java.io.DataInput in)	Deprecated. Deserialize the fields of this object from in.
static java.lang.String	readString(java.io.DataInput in)	Deprecated.
void	set(java.lang.String string)	Deprecated. Set to contain the contents of a string.
void	set(UTF8 other)	Deprecated. Set to contain the contents of a string.
static void	skip(java.io.DataInput in)	Deprecated. Skips over one UTF8 in the input.
java.lang.String	toString()	Deprecated. Convert to a String.
java.lang.String	toStringChecked()	Deprecated. Convert to a string, checking for valid UTF8.
void	write(java.io.DataOutput out)	Deprecated. Serialize the fields of this object to out.
static int	writeString(java.io.DataOutput out, java.lang.String s)	Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

UTF8

public UTF8()

Deprecated.

UTF8

public UTF8(java.lang.String string)

Deprecated.

Construct from a given string.

Parameters:

string - input string.

UTF8

public UTF8(UTF8 utf8)

Deprecated.

Construct from a given string.

Parameters:

utf8 - input utf8.

Method Detail

getBytes

public byte[] getBytes()

Deprecated.

Returns:

The raw bytes.

getLength

public int getLength()

Deprecated.

Returns:

The number of bytes in the encoded string.

set

public void set(java.lang.String string)

Deprecated.

Set to contain the contents of a string.

Parameters:

string - input string.

set

public void set(UTF8 other)

Deprecated.

Set to contain the contents of a string.

Parameters:

other - input other.

readFields

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

Deprecated.

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

Parameters:

in - DataInput to deseriablize this object from.

Throws:

java.io.IOException - any other problem for readFields.

skip

public static void skip(java.io.DataInput in)
                 throws java.io.IOException

Deprecated.

Skips over one UTF8 in the input.

Parameters:

in - datainput.

Throws:

java.io.IOException - raised on errors performing I/O.

write

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

Deprecated.

Description copied from interface: Writable

Serialize the fields of this object to out.

Specified by:

write in interface Writable

Parameters:

out - DataOuput to serialize this object into.

Throws:

java.io.IOException - any other problem for write.

compareTo

public int compareTo(UTF8 o)

Deprecated.

Compare two UTF8s.

Specified by:

compareTo in interface java.lang.Comparable<UTF8>

toString

public java.lang.String toString()

Deprecated.

Convert to a String.

Overrides:

toString in class java.lang.Object

toStringChecked

public java.lang.String toStringChecked()
                                 throws java.io.IOException

Deprecated.

Convert to a string, checking for valid UTF8.

Returns:

the converted string

Throws:

java.io.UTFDataFormatException - if the underlying bytes contain invalid UTF8 data.

java.io.IOException

equals

public boolean equals(java.lang.Object o)

Deprecated.

Returns true iff o is a UTF8 with the same contents.

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Deprecated.

Overrides:

hashCode in class java.lang.Object

getBytes

public static byte[] getBytes(java.lang.String string)

Deprecated.

Parameters:

string - input string.

Returns:

Convert a string to a UTF-8 encoded byte array.

See Also:

String.getBytes(String)

fromBytes

public static java.lang.String fromBytes(byte[] bytes)
                                  throws java.io.IOException

Deprecated.

Parameters:

bytes - input bytes.

Returns:

Convert a UTF-8 encoded byte array back into a string.

Throws:

java.io.IOException - if the byte array is invalid UTF8

readString

public static java.lang.String readString(java.io.DataInput in)
                                   throws java.io.IOException

Deprecated.

Parameters:

in - DataInput.

Returns:

Read a UTF-8 encoded string.

Throws:

java.io.IOException - raised on errors performing I/O.

See Also:

DataInput.readUTF()

writeString

public static int writeString(java.io.DataOutput out,
                              java.lang.String s)
                       throws java.io.IOException

Deprecated.

Parameters:

out - input out.

s - input s.

Returns:

Write a UTF-8 encoded string.

Throws:

java.io.IOException - raised on errors performing I/O.

See Also:

DataOutput.writeUTF(String)