webwork.util

Class URLCodec

java.lang.Object

webwork.util.URLCodec

public class URLCodec
extends Object

Implements the 'www-form-urlencoded' encoding scheme, also misleadingly known as URL encoding.

For more detailed information please refer to Chapter 17.13.4 'Form content types' of the HTML 4.01 Specification

This codec is meant to be a replacement for standard Java classes URLEncoder and URLDecoder on older Java platforms, as these classes in Java versions below 1.4 rely on the platform's default charset encoding.

This class was copied from Apache, with some modifications

Author:

Apache Software Foundation

Field Summary

Fields

Modifier and Type	Field and Description
protected static byte	ESCAPE_CHAR
protected static org.apache.commons.logging.Log	log
protected static BitSet	WWW_FORM_URL BitSet of www-form-url safe characters.

Constructor Summary

Constructors

Constructor and Description
URLCodec()

Method Summary

Methods

Modifier and Type	Method and Description
static byte[]	decode(byte[] bytes) Decodes an array of URL safe 7-bit characters into an array of original bytes.
static Object	decode(Object pObject) Decodes a URL safe object into its original form.
static String	decode(String pString) Decodes a URL safe string into its original form using the default string charset.
static String	decode(String pString, String charset) Decodes a URL safe string into its original form using the specified encoding.
static byte[]	decodeUrl(byte[] bytes) Decodes an array of URL safe 7-bit characters into an array of original bytes.
static byte[]	encode(byte[] bytes) Encodes an array of bytes into an array of URL safe 7-bit characters.
static Object	encode(Object pObject) Encodes an object into its URL safe form.
static String	encode(String pString) Encodes a string into its URL safe form using the default string charset.
static String	encode(String pString, String charset) Encodes a string into its URL safe form using the specified string charset.
static byte[]	encodeUrl(BitSet urlsafe, byte[] bytes) Encodes an array of bytes into an array of URL safe 7-bit characters.

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static org.apache.commons.logging.Log log

ESCAPE_CHAR

protected static byte ESCAPE_CHAR

WWW_FORM_URL

protected static final BitSet WWW_FORM_URL

BitSet of www-form-url safe characters.

Constructor Detail

URLCodec

public URLCodec()

Method Detail

encodeUrl

public static byte[] encodeUrl(BitSet urlsafe,
               byte[] bytes)

Encodes an array of bytes into an array of URL safe 7-bit characters. Unsafe characters are escaped.

Parameters:

urlsafe - bitset of characters deemed URL safe

bytes - array of bytes to convert to URL safe characters

Returns:

array of bytes containing URL safe characters

decodeUrl

public static byte[] decodeUrl(byte[] bytes)
                        throws UnsupportedEncodingException

Decodes an array of URL safe 7-bit characters into an array of original bytes. Escaped characters are converted back to their original representation.

Parameters:

bytes - array of URL safe characters

Returns:

array of original bytes

Throws:

UnsupportedEncodingException - Thrown if URL decoding is unsuccessful

encode

public static byte[] encode(byte[] bytes)

Encodes an array of bytes into an array of URL safe 7-bit characters. Unsafe characters are escaped.

Parameters:

bytes - array of bytes to convert to URL safe characters

Returns:

array of bytes containing URL safe characters

decode

public static byte[] decode(byte[] bytes)
                     throws UnsupportedEncodingException

Decodes an array of URL safe 7-bit characters into an array of original bytes. Escaped characters are converted back to their original representation.

Parameters:

bytes - array of URL safe characters

Returns:

array of original bytes

Throws:

UnsupportedEncodingException - Thrown if URL decoding is unsuccessful

encode

public static String encode(String pString,
            String charset)
                     throws UnsupportedEncodingException

Encodes a string into its URL safe form using the specified string charset. Unsafe characters are escaped.

Parameters:

pString - string to convert to a URL safe form

charset - the charset for pString

Returns:

URL safe string

Throws:

UnsupportedEncodingException - Thrown if charset is not supported

encode

public static String encode(String pString)

Encodes a string into its URL safe form using the default string charset. Unsafe characters are escaped.

Parameters:

pString - string to convert to a URL safe form

Returns:

URL safe string

Throws:

UnsupportedEncodingException - Thrown if URL encoding is unsuccessful

See Also:

getWebworkDefaultCharset()

decode

public static String decode(String pString,
            String charset)
                     throws UnsupportedEncodingException

Decodes a URL safe string into its original form using the specified encoding. Escaped characters are converted back to their original representation.

Parameters:

pString - URL safe string to convert into its original form

charset - the original string charset

Returns:

original string

Throws:

UnsupportedEncodingException - Thrown if charset is not supported

decode

public static String decode(String pString)
                     throws UnsupportedEncodingException

Decodes a URL safe string into its original form using the default string charset. Escaped characters are converted back to their original representation.

Parameters:

pString - URL safe string to convert into its original form

Returns:

original string

Throws:

UnsupportedEncodingException - Thrown if URL decoding is unsuccessful

See Also:

getWebworkDefaultCharset()

encode

public static Object encode(Object pObject)
                     throws UnsupportedEncodingException

Encodes an object into its URL safe form. Unsafe characters are escaped.

Parameters:

pObject - string to convert to a URL safe form

Returns:

URL safe object

Throws:

UnsupportedEncodingException - Thrown if URL encoding is not applicable to objects of this type or if encoding is unsuccessful

decode

public static Object decode(Object pObject)
                     throws UnsupportedEncodingException

Decodes a URL safe object into its original form. Escaped characters are converted back to their original representation.

Parameters:

pObject - URL safe object to convert into its original form

Returns:

original object

Throws:

UnsupportedEncodingException - Thrown if the argument is not a String or byte[]. Thrown if a failure condition is encountered during the decode process.