Класс 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(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, то некорректный вход будет заменен на значение по умолчанию Charset замены.

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

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

Параметры:

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

charset - заданный 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/net/URLEncoder.html