org.bson.io

Class UTF8Encoding

java.lang.Object

org.bson.io.UTF8Encoding

class UTF8Encoding
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
private char[]	decoderArray
private static int	MAX_CODE_POINT
private static int	MIN_2_BYTES
private static int	MIN_3_BYTES
private static int	MIN_4_BYTES

Constructor Summary

Constructors

Constructor and Description
UTF8Encoding()

Method Summary

Modifier and Type	Method and Description
private static void	checkByte(int ch, int pos, int len)
private static void	checkMinimal(int ch, int minValue)
java.lang.String	decode(byte[] data, int offset, int length) Custom byte[] -> String conversion routine for UTF-8 only.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MIN_2_BYTES

private static final int MIN_2_BYTES

See Also:

Constant Field Values

MIN_3_BYTES

private static final int MIN_3_BYTES

See Also:

Constant Field Values

MIN_4_BYTES

private static final int MIN_4_BYTES

See Also:

Constant Field Values

MAX_CODE_POINT

private static final int MAX_CODE_POINT

See Also:

Constant Field Values

decoderArray

private char[] decoderArray

Constructor Detail

UTF8Encoding

UTF8Encoding()

Method Detail

checkByte

private static final void checkByte(int ch,
                                    int pos,
                                    int len)
                             throws java.io.IOException

Throws:

java.io.IOException

checkMinimal

private static final void checkMinimal(int ch,
                                       int minValue)
                                throws java.io.IOException

Throws:

java.io.IOException

decode

public java.lang.String decode(byte[] data,
                               int offset,
                               int length)
                        throws java.io.IOException

Custom byte[] -> String conversion routine for UTF-8 only. This is about twice as fast as using the String(byte[],int,int,String) ctor, at least under JDK 1.4.2. The extra checks for illegal representations add about 10-15% overhead, but they seem worth it given the number of SQL_ASCII databases out there.

Parameters:

data - the array containing UTF8-encoded data

offset - the offset of the first byte in data to decode from

length - the number of bytes to decode

Returns:

a decoded string

Throws:

java.io.IOException - if something goes wrong