org.apache.commons.httpclient.util
Class EncodingUtil
java.lang.Object
org.apache.commons.httpclient.util.EncodingUtil
public class EncodingUtil
extends java.lang.Object
The home for utility methods that handle various encoding tasks.
static String | formUrlEncode(NameValuePair[] pairs, String charset) - Form-urlencoding routine.
|
static byte[] | getAsciiBytes(String data) - Converts the specified string to byte array of ASCII characters.
|
static String | getAsciiString(byte[] data) - Converts the byte array of ASCII characters to a string.
|
static String | getAsciiString(byte[] data, int offset, int length) - Converts the byte array of ASCII characters to a string.
|
static byte[] | getBytes(String data, String charset) - Converts the specified string to a byte array.
|
static String | getString(byte[] data, String charset) - Converts the byte array of HTTP content characters to a string.
|
static String | getString(byte[] data, int offset, int length, String charset) - Converts the byte array of HTTP content characters to a string.
|
formUrlEncode
public static String formUrlEncode(NameValuePair[] pairs,
String charset)
Form-urlencoding routine.
The default encoding for all forms is `application/x-www-form-urlencoded'.
A form data set is represented in this media type as follows:
The form field names and values are escaped: space characters are replaced
by `+', and then reserved characters are escaped as per [URL]; that is,
non-alphanumeric characters are replaced by `%HH', a percent sign and two
hexadecimal digits representing the ASCII code of the character. Line breaks,
as in multi-line text field values, are represented as CR LF pairs, i.e. `%0D%0A'.
if the given charset is not supported, ISO-8859-1 is used instead.
pairs
- the values to be encodedcharset
- the character set of pairs to be encoded
getAsciiBytes
public static byte[] getAsciiBytes(String data)
Converts the specified string to byte array of ASCII characters.
data
- the string to be encoded
- The string as a byte array.
getAsciiString
public static String getAsciiString(byte[] data)
Converts the byte array of ASCII characters to a string. This method is
to be used when decoding content of HTTP elements (such as response
headers)
data
- the byte array to be encoded
- The string representation of the byte array
getAsciiString
public static String getAsciiString(byte[] data,
int offset,
int length)
Converts the byte array of ASCII characters to a string. This method is
to be used when decoding content of HTTP elements (such as response
headers)
data
- the byte array to be encodedoffset
- the index of the first byte to encodelength
- the number of bytes to encode
- The string representation of the byte array
getBytes
public static byte[] getBytes(String data,
String charset)
Converts the specified string to a byte array. If the charset is not supported the
default system charset is used.
data
- the string to be encodedcharset
- the desired character encoding
- The resulting byte array.
getString
public static String getString(byte[] data,
String charset)
Converts the byte array of HTTP content characters to a string. If
the specified charset is not supported, default system encoding
is used.
data
- the byte array to be encodedcharset
- the desired character encoding
- The result of the conversion.
getString
public static String getString(byte[] data,
int offset,
int length,
String charset)
Converts the byte array of HTTP content characters to a string. If
the specified charset is not supported, default system encoding
is used.
data
- the byte array to be encodedoffset
- the index of the first byte to encodelength
- the number of bytes to encodecharset
- the desired character encoding
- The result of the conversion.
Copyright (c) 1999-2005 - Apache Software Foundation