java.lang.Object
org.apache.wicket.util.crypt.StringUtils
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$
- Author:
- Gary Gregory
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic 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
Constructs a newString
by decoding the specified array of bytes using the given charset.static String
newStringIso8859_1
(byte[] bytes) Constructs a newString
by decoding the specified array of bytes using the ISO-8859-1 charset.static String
newStringUsAscii
(byte[] bytes) Constructs a newString
by decoding the specified array of bytes using the US-ASCII charset.static String
newStringUtf16
(byte[] bytes) Constructs a newString
by decoding the specified array of bytes using the UTF-16 charset.static String
newStringUtf16Be
(byte[] bytes) Constructs a newString
by decoding the specified array of bytes using the UTF-16BE charset.static String
newStringUtf16Le
(byte[] bytes) Constructs a newString
by decoding the specified array of bytes using the UTF-16LE charset.static String
newStringUtf8
(byte[] bytes) Constructs a newString
by decoding the specified array of bytes using the UTF-8 charset.
-
Constructor Details
-
StringUtils
public StringUtils()
-
-
Method Details
-
getBytesIso8859_1
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:
-
getBytesUsAscii
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:
-
getBytesUtf16
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:
-
getBytesUtf16Be
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:
-
getBytesUtf16Le
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:
-
getBytesUtf8
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:
-
getBytesUnchecked
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 asIllegalStateException
, 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 encodecharsetName
- The name of a requiredCharset
- Returns:
- encoded bytes
- Throws:
IllegalStateException
- Thrown when aUnsupportedEncodingException
is caught, which should never happen for a required charset name.- See Also:
-
newString
Constructs a newString
by decoding the specified array of bytes using the given charset.This method catches
UnsupportedEncodingException
and re-throws it asIllegalStateException
, 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 characterscharsetName
- The name of a requiredCharset
- Returns:
- A new
String
decoded from the specified array of bytes using the given charset. - Throws:
IllegalStateException
- Thrown when aUnsupportedEncodingException
is caught, which should never happen for a required charset name.- See Also:
-
newStringIso8859_1
Constructs a newString
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 aUnsupportedEncodingException
is caught, which should never happen since the charset is required.
-
newStringUsAscii
Constructs a newString
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 aUnsupportedEncodingException
is caught, which should never happen since the charset is required.
-
newStringUtf16
Constructs a newString
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 aUnsupportedEncodingException
is caught, which should never happen since the charset is required.
-
newStringUtf16Be
Constructs a newString
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 aUnsupportedEncodingException
is caught, which should never happen since the charset is required.
-
newStringUtf16Le
Constructs a newString
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 aUnsupportedEncodingException
is caught, which should never happen since the charset is required.
-
newStringUtf8
Constructs a newString
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 aUnsupportedEncodingException
is caught, which should never happen since the charset is required.
-