com.sleepycat.utilint

Class StringUtils

java.lang.Object

com.sleepycat.utilint.StringUtils

public class StringUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
StringUtils()

Method Summary

Modifier and Type	Method and Description
static String	fromASCII(byte[] bytes)
static String	fromASCII(byte[] bytes, int offset, int len)
static CharBuffer	fromASCII(ByteBuffer bytes)
static String	fromUTF8(byte[] bytes)
static String	fromUTF8(byte[] bytes, int offset, int len)
static CharBuffer	fromUTF8(ByteBuffer bytes)
static ByteBuffer	toASCII(CharBuffer chars)
static byte[]	toASCII(String str)
static ByteBuffer	toUTF8(CharBuffer chars)
static byte[]	toUTF8(String str) In all src and test code, the String(byte[], ...) constructor and String.getBytes method must always be passed a Charset, to avoid portability issues.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtils

public StringUtils()

Method Detail

toUTF8

public static byte[] toUTF8(String str)

In all src and test code, the String(byte[], ...) constructor and String.getBytes method must always be passed a Charset, to avoid portability issues. Otherwise, portability issues will occur when running on a JVM plataform with a non-western default charset, the EBCDIC encoding (on z/OS), etc. [#20967]

In most cases, the UTF8 or ASCII charset should be used for portability. UTF8 should be used when any character may be represented. ASCII can be used when all characters are in the ASCII range. The default charset should only be used when handling user-input data directly, e.g., console input/output or user-visible files.

Rather than passing the charset as a string (getBytes("UTF-8")), the Charset objects defined here should be passed (getBytes(UTF8)). Not only is using a Charset object slightly more efficient because it avoids a lookup, even more importantly it avoids having to clutter code with a catch for java.io.UnsupportedEncodingException, which should never be thrown for the "UTF-8" or "US-ASCII" charsets.

toUTF8

public static ByteBuffer toUTF8(CharBuffer chars)

Returns:

a buffer with position set to 0

fromUTF8

public static String fromUTF8(byte[] bytes)

fromUTF8

public static String fromUTF8(byte[] bytes,
                              int offset,
                              int len)

fromUTF8

public static CharBuffer fromUTF8(ByteBuffer bytes)

Returns:

a buffer with position set to 0

toASCII

public static byte[] toASCII(String str)

toASCII

public static ByteBuffer toASCII(CharBuffer chars)

Returns:

a buffer with position set to 0

fromASCII

public static String fromASCII(byte[] bytes)

fromASCII

public static String fromASCII(byte[] bytes,
                               int offset,
                               int len)

fromASCII

public static CharBuffer fromASCII(ByteBuffer bytes)

Returns:

a buffer with position set to 0