java.net

Class URLEncoder

java.lang.Object

java.net.URLEncoder

public class URLEncoder
extends Object

This class is used to encode a string using the format required by application/x-www-form-urlencoded MIME content type.

All characters except letters ('a'..'z', 'A'..'Z') and numbers ('0'..'9') and characters '.', '-', '*', '_' are converted into their hexadecimal value prepended by '%'. For example: '#' -> %23. In addition, spaces are substituted by '+'.

Method Summary

Modifier and Type	Method and Description
static String	encode(String s) Deprecated. Use encode(String, String) instead.
static String	encode(String s, Charset charset) Translates a string into application/x-www-form-urlencoded format using a specific Charset.
static String	encode(String s, String charsetName) Encodes s using the Charset named by charsetName.

Methods inherited from class java.lang.Object

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

Method Detail

encode

@Deprecated
public static String encode(String s)

Deprecated. Use encode(String, String) instead.

Equivalent to encode(s, "UTF-8").

encode

public static String encode(String s,
                            String charsetName)
                     throws UnsupportedEncodingException

Encodes s using the Charset named by charsetName.

Throws:

UnsupportedEncodingException

encode

public static String encode(String s,
                            Charset charset)

Translates a string into application/x-www-form-urlencoded format using a specific Charset. This method uses the supplied charset to obtain the bytes for unsafe characters.

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

Parameters:

s - String to be translated.

charset - the given charset

Returns:

the translated String.

Throws:

NullPointerException - if s or charset is null.

Since:

10

See Also:

URLDecoder.decode(java.lang.String, java.nio.charset.Charset)