org.camunda.bpm.engine.impl.digest._apacheCommonsCodec
Class StringUtils

java.lang.Object
  org.camunda.bpm.engine.impl.digest._apacheCommonsCodec.StringUtils

public class StringUtils
extends Object

Converts String to and from bytes using the encodings required by the Java specification. These encodings are specified in Standard charsets

Since:

1.4

Version:

$Id: StringUtils.java 801391 2009-08-05 19:55:54Z ggregory $

Author:

Gary Gregory

See Also:

CharEncoding, Standard charsets

Field Summary

static String

UTF_8

Constructor Summary

StringUtils()

Method Summary

static byte[]	getBytesUnchecked(String string, String charsetName) Encodes the given string into a sequence of bytes using the named charset, storing the result into a new byte array.
static byte[]	getBytesUtf8(String string) Encodes the given string into a sequence of bytes using the UTF-8 charset, storing the result into a new byte array.
static String	newString(byte[] bytes, String charsetName) Constructs a new String by decoding the specified array of bytes using the given charset.
static String	newStringUtf8(byte[] bytes) Constructs a new String by decoding the specified array of bytes using the UTF-8 charset.

Methods inherited from class java.lang.Object

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

Field Detail

UTF_8

public static final String UTF_8

See Also:

Constant Field Values

Constructor Detail

StringUtils

public StringUtils()

Method Detail

newString

public static String newString(byte[] bytes,
                               String charsetName)

Constructs a new String by decoding the specified array of bytes using the given charset.

This method catches UnsupportedEncodingException and re-throws it as IllegalStateException, which should never happen for a required charset name. Use this method when the encoding is required to be in the JRE.

Parameters:

bytes - The bytes to be decoded into characters

charsetName - The name of a required Charset

Returns:

A new String decoded from the specified array of bytes using the given charset.

Throws:

IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen for a required charset name.

See Also:

CharEncoding, String.String(byte[], String)

newStringUtf8

public static String newStringUtf8(byte[] bytes)

Constructs a new String by decoding the specified array of bytes using the UTF-8 charset.

Parameters:

bytes - The bytes to be decoded into characters

Returns:

A new String decoded from the specified array of bytes using the given charset.

Throws:

IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the charset is required.

getBytesUtf8

public static byte[] getBytesUtf8(String string)

Encodes the given string into a sequence of bytes using the UTF-8 charset, storing the result into a new byte array.

Parameters:

string - the String to encode

Returns:

encoded bytes

Throws:

IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.

See Also:

Standard charsets, getBytesUnchecked(String, String)

getBytesUnchecked

public static byte[] getBytesUnchecked(String string,
                                       String charsetName)

Encodes the given string into a sequence of bytes using the named charset, storing the result into a new byte array.

This method catches UnsupportedEncodingException and rethrows it as IllegalStateException, which should never happen for a required charset name. Use this method when the encoding is required to be in the JRE.

Parameters:

string - the String to encode

charsetName - The name of a required Charset

Returns:

encoded bytes

Throws:

IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen for a required charset name.

See Also:

CharEncoding, String.getBytes(String)