Класс 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), за исключением того, что он будет искать 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.

С момента:

См. также:

URLDecoder.decode(java.lang.String, java.nio.charset.Charset)

© 1993, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/URLEncoder.html