com.google.gwt.http.client
Class URL

java.lang.Object
  extended by com.google.gwt.http.client.URL

public final class URL
extends java.lang.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>


Method Summary
static java.lang.String decode(java.lang.String encodedURL)
          Returns a string where all URL escape sequences have been converted back to their original character representations.
static java.lang.String decodeComponent(java.lang.String encodedURLComponent)
          Returns a string where all URL component escape sequences have been converted back to their original character representations.
static java.lang.String encode(java.lang.String decodedURL)
          Returns a string where all characters that are not valid for a complete URL have been escaped.
static java.lang.String encodeComponent(java.lang.String decodedURLComponent)
          Returns a string where all characters that are not valid for a URL component have been escaped.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

decode

public static java.lang.String decode(java.lang.String encodedURL)
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
Returns:
string with no encoded URL encoded sequences

decodeComponent

public static java.lang.String decodeComponent(java.lang.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
Returns:
string with no encoded URL component encoded sequences

encode

public static java.lang.String encode(java.lang.String decodedURL)
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:

Parameters:
decodedURL - a string containing URL characters that may require encoding
Returns:
a string with all invalid URL characters escaped

encodeComponent

public static java.lang.String encodeComponent(java.lang.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:

Notice that this method does encode the URL component delimiter characters:

 ; / ? : & = + $ , #
 

Parameters:
decodedURLComponent - a string containing invalid URL characters
Returns:
a string with all invalid URL characters escaped