# URLEncoder

public class **URLEncoder** extends [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)  
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](http://www.w3.org/TR/html4/).


When encoding a String, the following rules apply:

- The alphanumeric characters "`a`" through "`z`", "`A`" through "`Z`" and "`0`" through "`9`" remain the same.
- The special characters "`.`", "`-`", "`*`", and "`_`" remain the same.
- The space character " " is converted into a plus sign "`+`".
- All other characters are unsafe and are first converted into one or more bytes using some encoding scheme. Then each byte is represented by the 3-character string "*`%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).

### Public Method Summary

|---|---|
| static [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [encode](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/URLEncoder.html#encode(java.lang.String,%20java.lang.String))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) s, [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) enc) Translates a string into `application/x-www-form-urlencoded` format using a specific encoding scheme. |
| static [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [encode](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/URLEncoder.html#encode(java.lang.String))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) s) *This method is deprecated. The resulting string may vary depending on the platform's default encoding. Instead, use the encode(String,String) method to specify the encoding.* |

### Inherited Method Summary

From class [java.lang.Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)

|---|---|
| [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) | [clone](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#clone())() Creates and returns a copy of this `Object`. |
| boolean | [equals](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#equals(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj) Compares this instance with the specified object and indicates if they are equal. |
| void | [finalize](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#finalize())() Invoked when the garbage collector has detected that this instance is no longer reachable. |
| final [Class](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html)\<?\> | [getClass](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#getClass())() Returns the unique instance of `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html` that represents this object's class. |
| int | [hashCode](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#hashCode())() Returns an integer hash code for this object. |
| final void | [notify](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notify())() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| final void | [notifyAll](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notifyAll())() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [toString](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#toString())() Returns a string containing a concise, human-readable description of this object. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long,%20int))(long timeout, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long))(long timeout) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait())() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object. |

## Public Methods

#### public static [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html)
**encode**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) s, [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) enc)

Translates a string into `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](http://www.w3.org/TR/html40/appendix/notes.html#non-ascii-chars) states that
UTF-8 should be used. Not doing so may introduce
incompatibilities.*

##### Parameters

| s | `String` to be translated. |
| enc | The name of a supported [character encoding](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/package-summary.html#charenc). |
|---|---|

##### Returns

- the translated `String`.

##### Throws

| [UnsupportedEncodingException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/UnsupportedEncodingException.html) | If the named encoding is not supported |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/java/net/URLDecoder.html#decode(java.lang.String,%20java.lang.String)`

#### public static [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html)
**encode**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) s)


**This method is deprecated.**   
The resulting string may vary depending on the platform's
default encoding. Instead, use the encode(String,String)
method to specify the encoding.
Translates a string into `x-www-form-urlencoded`
format. This method uses the platform's default encoding
as the encoding scheme to obtain the bytes for unsafe characters.

##### Parameters

| s | `String` to be translated. |
|---|---|

##### Returns

- the translated `String`.