|
Oracle® Globalization Development Kit Java API Reference 10g Release 1(10.1) B10971-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.i18n.net.URLEncoder
URLEncoder contains a utility method for converting a String
into a MIME format called x-www-form-urlencoded
format.
To convert a String
, each character is examined in turn:
a
' through 'z
',
'A
' through 'Z
', '0
' through
'9
', and ".", "-", "",
"_" remain the same.
' is converted into a plus sign
'+
'.
%xy
", where xy is the two-digit hexadecimal
representation of the lower 8-bits of the character.
When you encode a full set of URL string, e.g.,
http://www.acme.com/
, it is troublesome to encode special
meaning characters such as ':'
and '/'
. To avoid
encoding, you can set the parameter of escResChar
to
false
. The following characters will not be encoded:
;
- Semi-colon (U+003B)
/
- Forwad slash (U+002F)
?
- Question mark (U+003F)
:
- Colon (U+003A)
(
- At sign (U+0040)
&
- Ampersand (U+0026)
=
- Equal sign (U+002D)
+
- Plus sign (U+002B)
$
- Dollar sign (U+0024)
,
- Comma (U+002C)
By default, escResChar
is true.
For information about URL encode/decode, see RFC 1738.
Method Summary | |
static String |
encode(String s)
Encodes a String into x-www-form-urlencoded
format using UTF-8 character set encoding. |
static String |
encode(String s,
boolean escResChar)
Encodes a String into x-www-form-urlencoded
format using UTF-8 character set encoding. |
static String |
encode(String s,
boolean escResChar,
String enc)
Encodes a string into x-www-form-urlencoded format.
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
public static String encode(String s)
String
into x-www-form-urlencoded
format using UTF-8 character set encoding. Any reserved characters will
be encoded.
s
- a String
to be encoded.
String
public static String encode(String s, boolean escResChar)
String
into x-www-form-urlencoded
format using UTF-8 character set encoding. escResChar
determines whether it encodes the reserved characters or not.
s
- a String
to be translated.escResChar
- determines whether to encodes the reserved;
true
- encode (default), false
- don't
encode.
String
IllegalStateException
- if UTF-8 is not supported by JVMpublic static String encode(String s, boolean escResChar, String enc) throws UnsupportedEncodingException
x-www-form-urlencoded
format.
Currently AL16UTF16(aka. UTF-16BE) is not supported.
s
- a String
to be translated.escResChar
- determines whether to encodes the reserved;
true
- encode (default), false
- don't
encode.enc
- the name of an Oracle or IANA character set
String
.
UnsupportedEncodingException
- if the character set is not
supported.
|
Oracle® Globalization Development Kit Java API Reference 10g Release 1(10.1) B10971-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |