Класс URLEncoder

java.lang.Object

java.net.URLEncoder

public final class URLEncoder extends Object

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

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

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

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

С версии:

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.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс среды выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством вызова notify или interrupt, либо пока не истечет определенное время.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством вызова notify или interrupt, либо пока не истечет определенное время.

Подробное описание методов

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(String s, Charset charset), за исключением того, что он будет искать кодировку по указанному имени.

Параметры:

s — String для преобразования.

enc — имя поддерживаемой кодировки символов.

Возвращает:

преобразованное String.

Вызывает:

UnsupportedEncodingException — если указанная кодировка не поддерживается

С версии:

1.4

См. также:

encode

public static String encode(String s, Charset charset)

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

Если входная строка имеет некорректный формат или входные данные не могут быть сопоставлены допустимой последовательности байтов в указанном Charset, ошибочные входные данные будут заменены значениями замены для Charset.

Примечание API:

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

Параметры:

s — String для преобразования.

charset — указанная кодировка

Возвращает:

преобразованное String.

Вызывает:

NullPointerException — если s или charset равно null.

С версии:

Внешние спецификации

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.