Class URL
public final
class
URL
extends
Object
Utility class for the encoding and decoding URLs in their entirety or by
their individual components.
Required Module
Modules that use this class should inherit
com.google.gwt.http.HTTP
.
<?xml version="1.0" encoding="UTF-8"?>
<module>
<!-- other inherited modules, such as com.google.gwt.user.User -->
<inherits name="com.google.gwt.http.HTTP"/>
<!-- additional module settings -->
</module>
Methods
decode(String) | Returns a string where all URL escape sequences have been converted back to
their original character representations. |
decodeComponent(String) | Returns a string where all URL component escape sequences have been
converted back to their original character representations. |
encode(String) | Returns a string where all characters that are not valid for a complete URL
have been escaped. |
encodeComponent(String) | Returns a string where all characters that are not valid for a URL
component have been escaped. |
Method Detail
decode
Returns a string where all URL escape sequences have been converted back to
their original character representations.
Parameters
- encodedURL
- string containing encoded URL encoded sequences
Return Value
string with no encoded URL encoded sequences
decodeComponent
public static
String decodeComponent(
String encodedURLComponent)
Returns a string where all URL component escape sequences have been
converted back to their original character representations.
Parameters
- encodedURLComponent
- string containing encoded URL component
sequences
Return Value
string with no encoded URL component encoded sequences
encode
Returns a string where all characters that are not valid for a complete URL
have been escaped. The escaping of a character is done by converting it
into its UTF-8 encoding and then encoding each of the resulting bytes as a
%xx hexadecimal escape sequence.
The following character sets are not escaped by this method:
- ASCII digits or letters
- ASCII punctuation characters:
- _ . ! ~ * ' ( )
- URL component delimiter characters:
; / ? : & = + $ , #
Parameters
- decodedURL
- a string containing URL characters that may require
encoding
Return Value
a string with all invalid URL characters escaped
encodeComponent
public static
String encodeComponent(
String decodedURLComponent)
Returns a string where all characters that are not valid for a URL
component have been escaped. The escaping of a character is done by
converting it into its UTF-8 encoding and then encoding each of the
resulting bytes as a %xx hexadecimal escape sequence.
The following character sets are not escaped by this method:
- ASCII digits or letters
- ASCII punctuation characters:
- _ . ! ~ * ' ( )
Notice that this method does encode the URL component delimiter
characters:
; / ? : & = + $ , #
Parameters
- decodedURLComponent
- a string containing invalid URL characters
Return Value
a string with all invalid URL characters escaped