com.basho.riak.client.core.util

Class CharsetUtils

java.lang.Object

com.basho.riak.client.core.util.CharsetUtils

public class CharsetUtils
extends Object

Utils for dealing with byte, String charset issues This code is mainly from the Trifork fork of the original HTTP client and was written by Krestan Krab and/or Erik Søe Sørensen.

Author:

Russell Brown

Field Summary

Fields

Modifier and Type	Field and Description
static Charset	ASCII
static Charset	ISO_8859_1
static Charset	UTF_8

Constructor Summary

Constructors

Constructor and Description
CharsetUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static String	addCharset(Charset charset, String contentType)
static String	addCharset(String charset, String contentType) Adds the charset to a content type.
static String	addUtf8Charset(String contentType) Adds the utf-8 charset to a content type.
static String	asASCIIString(byte[] bytes)
static byte[]	asBytes(String string, Charset charset) Turn a string into an array of bytes using the passed Charset
static String	asString(byte[] bytes, Charset charset) Turns a byte[] array into a string in the provided Charset
static String	asUTF8String(byte[] bytes) Turns a byte[] array into a UTF8 string
static Charset	getCharset(String contentType) Attempts to parse the Charset from a contentType string.
static String	getDeclaredCharset(String contentType) Get the actual string value declared as the charset in a content-type string, regardless of its validity.
static boolean	hasCharset(String ctype) Check if a content-type string has a charset field appended.
static byte[]	utf8StringToBytes(String string) Turn a UTF-8 encoded string into an array of bytes

Methods inherited from class java.lang.Object

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

Field Detail

ASCII

public static Charset ASCII

ISO_8859_1

public static Charset ISO_8859_1

UTF_8

public static Charset UTF_8

Constructor Detail

CharsetUtils

public CharsetUtils()

Method Detail

getCharset

public static Charset getCharset(String contentType)

Attempts to parse the Charset from a contentType string. If contentType is null or no charset declaration found, then UTF-8 is returned. If the found Charset declaration is unknown on this platform then a runtime exception is thrown.

Parameters:

contentType -

Returns:

a Charset parsed from a charset declaration in a contentType String.

getDeclaredCharset

public static String getDeclaredCharset(String contentType)

Get the actual string value declared as the charset in a content-type string, regardless of its validity.

NOTE: this is different from getCharset, which will always return a default value.

Parameters:

contentType - the content-type string

Returns:

the verbatim charset declared or null if non-exists

addUtf8Charset

public static String addUtf8Charset(String contentType)

Adds the utf-8 charset to a content type.

Parameters:

contentType -

Returns:

the contentType with ;charset=utf-8 appended.

addCharset

public static String addCharset(String charset,
                String contentType)

Adds the charset to a content type.

Parameters:

contentType -

Returns:

the contentType with charset.name() appended.

addCharset

public static String addCharset(Charset charset,
                String contentType)

asString

public static String asString(byte[] bytes,
              Charset charset)

Turns a byte[] array into a string in the provided Charset

Parameters:

bytes -

charset -

Returns:

a String

asUTF8String

public static String asUTF8String(byte[] bytes)

Turns a byte[] array into a UTF8 string

Parameters:

bytes -

Returns:

a String

asASCIIString

public static String asASCIIString(byte[] bytes)

asBytes

public static byte[] asBytes(String string,
             Charset charset)

Turn a string into an array of bytes using the passed Charset

Parameters:

string -

charset -

Returns:

a byte[] array

utf8StringToBytes

public static byte[] utf8StringToBytes(String string)

Turn a UTF-8 encoded string into an array of bytes

Parameters:

string -

Returns:

the bytes for the supplied String

hasCharset

public static boolean hasCharset(String ctype)

Check if a content-type string has a charset field appended.

Parameters:

ctype - the content-type string

Returns:

true if ctype has a charset, false otherwise