| java.lang.Object
 org.apache.catalina.util.RequestUtil
| RequestUtil | | final public class RequestUtil (Code) | | General purpose request parsing and encoding utility methods.
author:
Craig R. McClanahan
author:
Tim Tye
version:
$Revision: 1.8 $ $Date: 2004/05/26 16:26:10 $ |
| Method Summary | |
| public static String | URLDecode(String str)
Decode and return the specified URL-encoded String.
When the byte array is converted to a string, the system default
character encoding is used... | | public static String | URLDecode(String str, String enc)
Decode and return the specified URL-encoded String. | | public static String | URLDecode(byte[] bytes)
Decode and return the specified URL-encoded byte array. | | public static String | URLDecode(byte[] bytes, String enc)
Decode and return the specified URL-encoded byte array. | | public static String | encodeCookie(Cookie cookie)
Encode a cookie as per RFC 2109. | | public static String | filter(String message)
Filter the specified message string for characters that are sensitive
in HTML. | | public static String | normalize(String path)
Normalize a relative URI path that may have relative values ("/./",
"/../", and so on ) it it. | | public static String | parseCharacterEncoding(String contentType)
Parse the character encoding from the specified content type header. | | public static Cookie[] | parseCookieHeader(String header)
Parse a cookie header into an array of cookies according to RFC 2109. | | public static void | parseParameters(Map map, String data, String encoding)
Append request parameters from the specified String to the specified
Map. | | public static void | parseParameters(Map map, byte[] data, String encoding)
Append request parameters from the specified String to the specified
Map. |
| URLDecode | | public static String URLDecode(String str)(Code) | | Decode and return the specified URL-encoded String.
When the byte array is converted to a string, the system default
character encoding is used... This may be different than some other
servers.
Parameters:
str - The url-encoded string
exception:
IllegalArgumentException - if a '%' character is not followedby a valid 2-digit hexadecimal number |
| URLDecode | | public static String URLDecode(String str, String enc)(Code) | | Decode and return the specified URL-encoded String.
Parameters:
str - The url-encoded string
Parameters:
enc - The encoding to use; if null, the default encoding is used
exception:
IllegalArgumentException - if a '%' character is not followedby a valid 2-digit hexadecimal number |
| URLDecode | | public static String URLDecode(byte[] bytes)(Code) | | Decode and return the specified URL-encoded byte array.
Parameters:
bytes - The url-encoded byte array
exception:
IllegalArgumentException - if a '%' character is not followedby a valid 2-digit hexadecimal number |
| URLDecode | | public static String URLDecode(byte[] bytes, String enc)(Code) | | Decode and return the specified URL-encoded byte array.
Parameters:
bytes - The url-encoded byte array
Parameters:
enc - The encoding to use; if null, the default encoding is used
exception:
IllegalArgumentException - if a '%' character is not followedby a valid 2-digit hexadecimal number |
| encodeCookie | | public static String encodeCookie(Cookie cookie)(Code) | | Encode a cookie as per RFC 2109. The resulting string can be used
as the value for a Set-Cookie header.
Parameters:
cookie - The cookie to encode. A string following RFC 2109. |
| filter | | public static String filter(String message)(Code) | | Filter the specified message string for characters that are sensitive
in HTML. This avoids potential attacks caused by including JavaScript
codes in the request URL that is often reported in error messages.
Parameters:
message - The message string to be filtered |
| normalize | | public static String normalize(String path)(Code) | | Normalize a relative URI path that may have relative values ("/./",
"/../", and so on ) it it. WARNING - This method is
useful only for normalizing application-generated paths. It does not
try to perform security checks for malicious input.
Parameters:
path - Relative path to be normalized |
| parseCharacterEncoding | | public static String parseCharacterEncoding(String contentType)(Code) | | Parse the character encoding from the specified content type header.
If the content type is null, or there is no explicit character encoding,
null is returned.
Parameters:
contentType - a content type header |
| parseCookieHeader | | public static Cookie[] parseCookieHeader(String header)(Code) | | Parse a cookie header into an array of cookies according to RFC 2109.
Parameters:
header - Value of an HTTP "Cookie" header |
| parseParameters | | public static void parseParameters(Map map, String data, String encoding) throws UnsupportedEncodingException(Code) | | Append request parameters from the specified String to the specified
Map. It is presumed that the specified Map is not accessed from any
other thread, so no synchronization is performed.
IMPLEMENTATION NOTE: URL decoding is performed
individually on the parsed name and value elements, rather than on
the entire query string ahead of time, to properly deal with the case
where the name or value includes an encoded "=" or "&" character
that would otherwise be interpreted as a delimiter.
Parameters:
map - Map that accumulates the resulting parameters
Parameters:
data - Input string containing request parameters
exception:
IllegalArgumentException - if the data is malformed |
| parseParameters | | public static void parseParameters(Map map, byte[] data, String encoding) throws UnsupportedEncodingException(Code) | | Append request parameters from the specified String to the specified
Map. It is presumed that the specified Map is not accessed from any
other thread, so no synchronization is performed.
IMPLEMENTATION NOTE: URL decoding is performed
individually on the parsed name and value elements, rather than on
the entire query string ahead of time, to properly deal with the case
where the name or value includes an encoded "=" or "&" character
that would otherwise be interpreted as a delimiter.
NOTE: byte array data is modified by this method. Caller beware.
Parameters:
map - Map that accumulates the resulting parameters
Parameters:
data - Input string containing request parameters
Parameters:
encoding - Encoding to use for converting hex
exception:
UnsupportedEncodingException - if the data is malformed |
|
|