Класс URLDecoder

java.lang.Object

java.net.URLDecoder

public class URLDecoder extends Object

Утилитарный класс для декодирования HTML-форм. Этот класс содержит статические методы для декодирования строки из формата application/x-www-form-urlencoded MIME.

Процесс преобразования является обратным тому, который используется классом URLEncoder. Предполагается, что все символы в закодированной строке являются одним из следующих: "a" по "z", "A" по "Z", "0" по "9", и "-", "_", ".", и "*". Символ "%" разрешен, но интерпретируется как начало специальной эскейпированной последовательности.

Применяются следующие правила преобразования:

Алфавитно-цифровые символы "a" по "z", "A" по "Z" и "0" по "9" остаются неизменными.
Специальные символы ".", "-", "*", и "_" остаются неизменными.
Знак плюс "+" преобразуется в пробел " " .
Последовательность вида "%xy" будет интерпретироваться как представляющая байт, где xy является двухзначным шестнадцатеричным представлением 8 битов. Затем все подстроки, содержащие одну или более из этих последовательностей байтов, будут заменены символом(ами), кодирование которого привело бы к этим последовательным байтам. Схема кодирования для декодирования этих символов может быть указана, или, если не указано, используется по умолчанию кодировка платформы.

Существуют два возможных способа, которыми этот декодер может обрабатывать неверные строки. Он может либо оставить неверные символы без изменений, либо выбросить исключение IllegalArgumentException. Какой подход использует декодер, остается на усмотрение реализации.

Since:: 1.2

Краткое описание методов

Модификатор и тип	Метод	Описание
`static String`	`decode(String s)`	Устарело. Результирующая строка может отличаться в зависимости от кодировки по умолчанию платформы.
`static String`	`decode(String s, String enc)`	Декодирует строку `application/x-www-form-urlencoded` используя определённую схему кодирования.
`static String`	`decode(String s, Charset charset)`	Декодирует строку `application/x-www-form-urlencoded` используя определённый Charset.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание методов

decode

@Deprecated public static String decode(String s)

Устарело.

Результирующая строка может отличаться в зависимости от кодировки по умолчанию платформы. Вместо этого используйте метод decode(String,String) для указания кодировки.

Декодирует строку x-www-form-urlencoded. Кодировка по умолчанию платформы используется для определения символов, представленных любыми последовательными последовательностями вида "%xy".

Параметры:: s - строка String для декодирования
Возвращает:: новая декодированная строка String

decode

public static String decode(String s, String enc) throws UnsupportedEncodingException

Декодирует строку application/x-www-form-urlencoded используя определённую схему кодирования.

Этот метод работает так же, как decode(java.lang.String,java.nio.charset.Charset), за исключением того, что он будет искать кодировку по заданному имени кодировки.

Описание реализации:

Эта реализация выбросит исключение IllegalArgumentException при обнаружении неверных строк.

Параметры:

s - строка String для декодирования

enc - Название поддерживаемой кодировки символов.

Возвращает:

новая декодированная строка String

Исключения:

UnsupportedEncodingException - Если требуется обращение к кодировке символов, но указанная кодировка символов не поддерживается

Since:

1.4

См. также:

URLEncoder.encode(java.lang.String, java.lang.String)

decode

public static String decode(String s, Charset charset)

Декодирует строку application/x-www-form-urlencoded используя определённый Charset. Предоставленный charset используется для определения символов, представленных любыми последовательными последовательностями вида "%xy".

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

Описание реализации:

Эта реализация выбросит исключение IllegalArgumentException при обнаружении неверных строк.

Параметры:

s - строка String для декодирования

charset - заданный charset

Возвращает:

новая декодированная строка String

Исключения:

NullPointerException - если s или charset является null

IllegalArgumentException - если реализация обнаруживает неверные символы

Since:

См. также:

URLEncoder.encode(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/URLDecoder.html