Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.google.gwt.http.client
Class URL

    java.lang.Object
      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`.

>     <!--                                                                        -->
>     <!-- Copyright 2007 Google Inc.                                             -->
>     <!-- Licensed under the Apache License, Version 2.0 (the "License"); you    -->
>     <!-- may not use this file except in compliance with the License. You may   -->
>     <!-- may obtain a copy of the License at                                    -->
>     <!--                                                                        -->
>     <!-- http://www.apache.org/licenses/LICENSE-2.0                             -->
>     <!--                                                                        -->
>     <!-- Unless required by applicable law or agreed to in writing, software    -->
>     <!-- distributed under the License is distributed on an "AS IS" BASIS,      -->
>     <!-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or        -->
>     <!-- implied. License for the specific language governing permissions and   -->
>     <!-- limitations under the License.                                         -->

>     <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
  Throws:
    `java.lang.NullPointerException` - if encodedURL is `null`

### 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
  Throws:
    `java.lang.NullPointerException` - if encodedURLComponent is `null`

### 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:

  - ASCII digits or letters
  - ASCII punctuation characters:

         - _ . ! ~ * ' ( )

  - URL component delimiter characters:

         ; / ? : & = + $ , #

  Parameters:
    `decodedURL` - a string containing URL characters that may require encoding
  Returns:
    a string with all invalid URL characters escaped
  Throws:
    `java.lang.NullPointerException` - if decodedURL is `null`

### 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:

  - 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
  Returns:
    a string with all invalid URL characters escaped
  Throws:
    `java.lang.NullPointerException` - if decodedURLComponent is `null`

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD