com.devexperts.qd.util
Class CompactChar

java.lang.Object
  extended by com.devexperts.qd.util.CompactChar

Deprecated. Use IOUtil class instead.

public class CompactChar
extends java.lang.Object

The CompactChar utility class provides algorithms for compact serialization of characters and strings. It uses CESU-8 format (the format close to UTF-8 but with special handling of surrogate characters). This is generally the same format as used by standard Java I/O streams, though Java uses modified CESU-8 (Java represents character with code 0 using 2-byte encoding, not 1-byte as required).

When encoding character sequences, the CompactChar uses CompactInt to encode character sequence length first, then serializes characters themselves. The value -1 for length is used as a marker to distinguish 'null' sequence from empty sequence.

See CESU-8 for format basics.

Note: this class is deprecated and is replaced by IOUtil class. See IOUtil class, section UTF APU, and individual methods for documentation.


Method Summary
static char readChar(java.io.DataInput in)
          Deprecated. Use IOUtil.readUTFChar(java.io.DataInput) method instead.
static char[] readChars(java.io.DataInput in)
          Deprecated. Use IOUtil.readCharArray(java.io.DataInput) method instead.
static java.lang.String readString(java.io.DataInput in)
          Deprecated. Use IOUtil.readCharArrayString(java.io.DataInput) method instead.
static java.lang.String readUTF(java.io.DataInput in)
          Deprecated. Use IOUtil.readUTFString(java.io.DataInput) method instead.
static void writeChar(java.io.DataOutput out, char c)
          Deprecated. Use IOUtil.writeUTFChar(java.io.DataOutput, int) method instead.
static void writeChars(java.io.DataOutput out, char[] chars)
          Deprecated. Use IOUtil.writeCharArray(DataOutput, char[]) method instead.
static void writeString(java.io.DataOutput out, java.lang.String str)
          Deprecated. Use IOUtil.writeCharArray(DataOutput, String) method instead.
static void writeUTF(java.io.DataOutput out, java.lang.String str)
          Deprecated. Use IOUtil.writeUTFString(java.io.DataOutput, java.lang.String) method instead.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

writeChar

public static void writeChar(java.io.DataOutput out,
                             char c)
                      throws java.io.IOException
Deprecated. Use IOUtil.writeUTFChar(java.io.DataOutput, int) method instead.

Writes specified character to the specified data output in a compact form.

Throws:
java.io.IOException

readChar

public static char readChar(java.io.DataInput in)
                     throws java.io.IOException
Deprecated. Use IOUtil.readUTFChar(java.io.DataInput) method instead.

Reads character from specified data input in a compact form.

Throws:
java.io.IOException

writeChars

public static void writeChars(java.io.DataOutput out,
                              char[] chars)
                       throws java.io.IOException
Deprecated. Use IOUtil.writeCharArray(DataOutput, char[]) method instead.

Writes specified characters to the specified data output in a compact form. Accepts null array as a valid value.

Throws:
java.io.IOException

readChars

public static char[] readChars(java.io.DataInput in)
                        throws java.io.IOException
Deprecated. Use IOUtil.readCharArray(java.io.DataInput) method instead.

Reads characters from specified data input in a compact form. Returns null if such value was written to the stream.

Throws:
java.io.IOException

writeString

public static void writeString(java.io.DataOutput out,
                               java.lang.String str)
                        throws java.io.IOException
Deprecated. Use IOUtil.writeCharArray(DataOutput, String) method instead.

Writes specified string to the specified data output in a compact form as a sequence of characters. Accepts null string as a valid value.

Throws:
java.io.IOException

readString

public static java.lang.String readString(java.io.DataInput in)
                                   throws java.io.IOException
Deprecated. Use IOUtil.readCharArrayString(java.io.DataInput) method instead.

Reads string from specified data input in a compact form as a sequence of characters. Returns null if such value was written to the stream.

Throws:
java.io.IOException

writeUTF

public static void writeUTF(java.io.DataOutput out,
                            java.lang.String str)
                     throws java.io.IOException
Deprecated. Use IOUtil.writeUTFString(java.io.DataOutput, java.lang.String) method instead.

Writes specified string to the specified data output in a compact form using it's bytes in UTF-8. Accepts null string as a valid value.

Throws:
java.io.IOException

readUTF

public static java.lang.String readUTF(java.io.DataInput in)
                                throws java.io.IOException
Deprecated. Use IOUtil.readUTFString(java.io.DataInput) method instead.

Reads string from specified data input in a compact form as UTF-8 bytes. Returns null if such value was written to the stream.

Throws:
java.io.IOException