org.xhtmlrenderer.simple.extend

Class URLUTF8Encoder

java.lang.Object

org.xhtmlrenderer.simple.extend.URLUTF8Encoder

public class URLUTF8Encoder
extends java.lang.Object

Provides a method to encode any string into a URL-safe form. Non-ASCII characters are first encoded as sequences of two or three bytes, using the UTF-8 algorithm, before being encoded as %HH escapes.

Author:

Torbjoern Gannholm

Constructor Summary

Constructors

Constructor and Description
URLUTF8Encoder()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	encode(char[] chars) Description of the Method
static java.lang.String	encode(java.lang.String s) Encode a string to the "x-www-form-urlencoded" form, enhanced with the UTF-8-in-URL proposal.

Methods inherited from class java.lang.Object

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

Constructor Detail

URLUTF8Encoder

public URLUTF8Encoder()

Method Detail

encode

public static java.lang.String encode(java.lang.String s)

Encode a string to the "x-www-form-urlencoded" form, enhanced with the UTF-8-in-URL proposal. This is what happens:

• The ASCII characters 'a' through 'z', 'A' through 'Z', and '0' through '9' remain the same.

• The unreserved characters - _ . ! ~ * ' ( ) remain the same.

• The space character ' ' is converted into a plus sign '+'.

• All other ASCII characters are converted into the 3-character string "%xy", where xy is the two-digit hexadecimal representation of the character code

• All non-ASCII characters are encoded in two steps: first to a sequence of 2 or 3 bytes, using the UTF-8 algorithm; secondly each of these bytes is encoded as "%xx".

Parameters:

s - The string to be encoded

Returns:

The encoded string

encode

public static java.lang.String encode(char[] chars)

Description of the Method

Parameters:

chars - PARAM

Returns:

Returns