org.odata4j.repack.org.apache.commons.codec.binary
Class StringUtils

java.lang.Object
  extended by org.odata4j.repack.org.apache.commons.codec.binary.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

Constructor Summary
StringUtils()
           
 
Method Summary
static byte[] getBytesIso8859_1(String string)
          Encodes the given string into a sequence of bytes using the ISO-8859-1 charset, storing the result into a new byte array.
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[] getBytesUsAscii(String string)
          Encodes the given string into a sequence of bytes using the US-ASCII charset, storing the result into a new byte array.
static byte[] getBytesUtf16(String string)
          Encodes the given string into a sequence of bytes using the UTF-16 charset, storing the result into a new byte array.
static byte[] getBytesUtf16Be(String string)
          Encodes the given string into a sequence of bytes using the UTF-16BE charset, storing the result into a new byte array.
static byte[] getBytesUtf16Le(String string)
          Encodes the given string into a sequence of bytes using the UTF-16LE 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 newStringIso8859_1(byte[] bytes)
          Constructs a new String by decoding the specified array of bytes using the ISO-8859-1 charset.
static String newStringUsAscii(byte[] bytes)
          Constructs a new String by decoding the specified array of bytes using the US-ASCII charset.
static String newStringUtf16(byte[] bytes)
          Constructs a new String by decoding the specified array of bytes using the UTF-16 charset.
static String newStringUtf16Be(byte[] bytes)
          Constructs a new String by decoding the specified array of bytes using the UTF-16BE charset.
static String newStringUtf16Le(byte[] bytes)
          Constructs a new String by decoding the specified array of bytes using the UTF-16LE 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
 

Constructor Detail

StringUtils

public StringUtils()
Method Detail

getBytesIso8859_1

public static byte[] getBytesIso8859_1(String string)
Encodes the given string into a sequence of bytes using the ISO-8859-1 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)

getBytesUsAscii

public static byte[] getBytesUsAscii(String string)
Encodes the given string into a sequence of bytes using the US-ASCII 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)

getBytesUtf16

public static byte[] getBytesUtf16(String string)
Encodes the given string into a sequence of bytes using the UTF-16 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)

getBytesUtf16Be

public static byte[] getBytesUtf16Be(String string)
Encodes the given string into a sequence of bytes using the UTF-16BE 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)

getBytesUtf16Le

public static byte[] getBytesUtf16Le(String string)
Encodes the given string into a sequence of bytes using the UTF-16LE 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)

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)

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)

newStringIso8859_1

public static String newStringIso8859_1(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the ISO-8859-1 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.

newStringUsAscii

public static String newStringUsAscii(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the US-ASCII 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.

newStringUtf16

public static String newStringUtf16(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-16 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.

newStringUtf16Be

public static String newStringUtf16Be(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-16BE 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.

newStringUtf16Le

public static String newStringUtf16Le(byte[] bytes)
Constructs a new String by decoding the specified array of bytes using the UTF-16LE 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.

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.


http://odata4j.org