co.codewizards.cloudstore.core.util

Class UrlDecoder

java.lang.Object

co.codewizards.cloudstore.core.util.UrlDecoder

public final class UrlDecoder
extends Object

URL-decoder corresponding to UrlEncoder.

In contrast to the URLDecoder, this class therefore does not decode '+' (plus) into ' ' (space)!

Additionally, this class does not use the default encoding, but always UTF-8, if not specified otherwise.

The reason for this class is that File.toURI() does not encode a "+" sign. Therefore, our URL-encoding and decoding must not handle the "+" specifically.

Another reason is JERSEY-417. I originally used org.glassfish.jersey.uri.UriComponent.encode(String, Type) at some code locations, but since not all code locations have a dependency on Jersey, I decided to switch consistently everywhere to UrlEncoder and UrlDecoder.

This class was copied from URLDecoder and changed to fit our needs.

Author:

Marco หงุ่ยตระกูล-Schulze - marco at codewizards dot co

See Also:

UrlEncoder

Method Summary

Modifier and Type	Method and Description
static String	decode(String s) Decodes a application/x-www-form-urlencoded string using UTF-8.
static String	decode(String s, Charset charset) Deprecated. UTF-8 should be used; it is thus recommended to invoke decode(String) instead.
static String	decode(String s, String enc) Deprecated. UTF-8 should be used; it is thus recommended to invoke decode(String) instead.

Methods inherited from class java.lang.Object

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

Method Detail

decode

public static String decode(String s)

Decodes a application/x-www-form-urlencoded string using UTF-8.

Parameters:

s - the String to decode

Returns:

the newly decoded String

See Also:

UrlEncoder.encode(String)

decode

@Deprecated
public static String decode(String s,
                                        String enc)
                                 throws UnsupportedEncodingException

Deprecated. UTF-8 should be used; it is thus recommended to invoke decode(String) instead.

Decodes a application/x-www-form-urlencoded string using a specific encoding scheme. The supplied encoding is used to determine what characters are represented by any consecutive sequences of the form "%xy".

Note: The World Wide Web Consortium Recommendation states that UTF-8 should be used. Not doing so may introduce incompatibilities.

Parameters:

s - the String to decode

enc - The name of a supported character encoding.

Returns:

the newly decoded String

Throws:

UnsupportedEncodingException - If character encoding needs to be consulted, but named character encoding is not supported

See Also:

UrlEncoder.encode(String, String)

decode

@Deprecated
public static String decode(String s,
                                        Charset charset)

Deprecated. UTF-8 should be used; it is thus recommended to invoke decode(String) instead.

Decodes a application/x-www-form-urlencoded string using a specific encoding scheme. The supplied encoding is used to determine what characters are represented by any consecutive sequences of the form "%xy".

Note: The World Wide Web Consortium Recommendation states that UTF-8 should be used. Not doing so may introduce incompatibilities.

Parameters:

s - the String to decode

charset - The character encoding.

Returns:

the newly decoded String

Throws:

UnsupportedEncodingException - If character encoding needs to be consulted, but named character encoding is not supported

See Also:

UrlEncoder.encode(String, Charset)