Класс 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 в качестве схемы кодирования, строка "Строка ü@foo-bar" будет преобразована в "Строка+ü@foo-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. Этот метод использует указанную кодировку для получения байтов для небезопасных символов.

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

Параметры:

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

charset - заданная кодировка

Возвращает:

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

Исключения:

NullPointerException - если s или charset null.

С момента:

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

См. также:

© 1993, 2023, 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/21/docs/api/java.base/java/net/URLEncoder.html