Класс 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" остаются без изменений.
Специальные символы ".", "-", "*" и "_" остаются без изменений.
Символ пробела " " преобразуется в знак плюса "+".
Все остальные символы небезопасны и сначала преобразуются в один или несколько байтов с использованием некоторой схемы кодирования. Затем каждый байт представляется строкой из 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` с использованием указанной кодировки.

Методы, объявленные в классе 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 значениями замены.

Примечание 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/URLEncoder.html