Класс 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 (шестнадцатерично).

Since:: JDK1.0

Методы

Модификатор и тип	Метод и описание
`static String`	`encode(String s)` Устарело. Результат может отличаться в зависимости от кодировки по умолчанию платформы. Вместо этого используйте метод encode(String,String) для указания кодировки.
`static String`	`encode(String s, String enc)` Преобразует строку в формат `application/x-www-form-urlencoded` используя определённую схему кодирования.

Наследованные методы из класса 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 используя определённую схему кодирования. Этот метод использует указанную схему кодирования для получения байтов небезопасных символов.

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

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

© 1993, 2020, 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.