|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.net.URLEncoder
public class URLEncoder
Utility class for HTML form encoding. This class contains static methods
for converting a String to the application/x-www-form-urlencoded
MIME
format. For more information about HTML form encoding, consult the HTML
specification.
When encoding a String, the following rules apply:
a
" through
"z
", "A
" through
"Z
" and "0
"
through "9
" remain the same.
.
",
"-
", "*
", and
"_
" remain the same.
" is
converted into a plus sign "+
".
%xy
", where xy is the
two-digit hexadecimal representation of the byte.
The recommended encoding scheme to use is UTF-8. However,
for compatibility reasons, if an encoding is not specified,
then the default encoding of the platform is used.
For example using UTF-8 as the encoding scheme the string "The string ü@foo-bar" would get converted to "The+string+%C3%BC%40foo-bar" because in UTF-8 the character ü is encoded as two bytes C3 (hex) and BC (hex), and the character @ is encoded as one byte 40 (hex).
Method Summary | |
---|---|
static String |
encode(String s)
Deprecated. The resulting string may vary depending on the platform's default encoding. Instead, use the encode(String,String) method to specify the encoding. |
static String |
encode(String s,
String enc)
Translates a string into application/x-www-form-urlencoded
format using a specific encoding scheme. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
@Deprecated public static String encode(String s)
x-www-form-urlencoded
format. This method uses the platform's default encoding
as the encoding scheme to obtain the bytes for unsafe characters.
s
- String
to be translated.
String
.public static String encode(String s, String enc) throws UnsupportedEncodingException
application/x-www-form-urlencoded
format using a specific encoding scheme. This method uses the
supplied encoding scheme 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 incompatibilites.
s
- String
to be translated.enc
- The name of a supported
character
encoding.
String
.
UnsupportedEncodingException
- If the named encoding is not supportedURLDecoder.decode(java.lang.String, java.lang.String)
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.