Класс URLEncoder

java.lang.Object
- java.net.URLEncoder

public class URLEncoder
extends Object

Утилитарный класс для кодирования HTML-форм. Этот класс содержит статические методы для преобразования строки в формат application/x-www-form-urlencoded MIME. Для получения дополнительной информации о кодировании HTML-форм обратитесь к спецификации HTML.

При кодировании строки применяются следующие правила:

Символы "a" до "z", "A" до "Z" и "0" до "9" остаются без изменений.
Специальные символы ".", "-", "*" и "_" остаются без изменений.
Пробел " " преобразуется в знак "+" "+".
Все остальные символы считаются небезопасными и сначала преобразуются в один или несколько байтов с использованием некоторого кодирования. Затем каждый байт представляется строкой из 3 символов "%xy", где xy — двухзначное шестнадцатеричное представление байта. Рекомендуемое кодирование — UTF-8. Однако по соображениям совместимости, если кодирование не указано, используется кодирование по умолчанию платформы.

Например, используя UTF-8 в качестве кодирования, строка "The string ü@foo-bar" будет преобразована в "The+string+%C3%BC%40foo-bar", так как в UTF-8 символ ü кодируется двумя байтами C3 (шестнадцатерично) и BC (шестнадцатерично), а символ @ — одним байтом 40 (шестнадцатерично).

С момента:: 1.0

Методы

Модификатор и тип Метод Описание

static String

encode(String s)

Устарело.

Полученная строка может отличаться в зависимости от кодировки по умолчанию платформы.

static String

encode(String s,
      String enc)

Преобразует строку в формат application/x-www-form-urlencoded с использованием определенного кодирования.

static String

encode(String s,
      Charset charset)

Преобразует строку в формат application/x-www-form-urlencoded с использованием определенного Charset.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы

encode

@Deprecated
public static String encode(String s)

Устарело.

Полученная строка может отличаться в зависимости от кодировки по умолчанию платформы. Вместо этого используйте метод encode(String,String) для указания кодирования.

Преобразует строку в формат x-www-form-urlencoded. Этот метод использует кодирование по умолчанию платформы для получения байтов небезопасных символов.

Параметры:: s - String для преобразования.
Возвращает:: преобразованную String.

encode

public static String encode(String s,
                            String enc)
                     throws UnsupportedEncodingException

Преобразует строку в формат application/x-www-form-urlencoded с использованием определенного кодирования.

Этот метод ведет себя так же, как encode(java.lang.String,java.nio.charset.Charset), за исключением того, что он будет искать кодировку по заданному имени кодирования.

Параметры:: s - String для преобразования.; enc - Имя поддерживаемого кодирования символов.
Возвращает:: преобразованную String.
Исключения:: UnsupportedEncodingException - Если заданное кодирование не поддерживается
С момента:: 1.4
См. также:: URLDecoder.decode(java.lang.String, java.lang.String)

encode

public static String encode(String s,
                            Charset charset)

Преобразует строку в формат application/x-www-form-urlencoded с использованием определенного Charset. Этот метод использует предоставленный charset для получения байтов небезопасных символов.

Примечание: Рекомендация Консорциума Всемирной паутины указывает на то, что следует использовать UTF-8. Использование другого кодирования может привести к несовместимости.

Параметры:: s - String для преобразования.; charset - заданный charset
Возвращает:: преобразованную String.
Исключения:: NullPointerException - если s или charset null.
С момента:: 10
См. также:: URLDecoder.decode(java.lang.String, java.nio.charset.Charset)