Класс 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
Конструкторы
| Конструктор и описание |
|---|
URLDecoder() |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
static String |
decode(String s) Устаревшее. Результат может отличаться в зависимости от кодировки по умолчанию платформы. Вместо этого используйте метод decode(String,String) для указания кодировки. |
static String |
decode(String s,
String enc) Декодирует строку |
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait Конструкторы
URLDecoder
public URLDecoder()
Методы
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 с использованием определенной схемы кодирования. Указанная кодировка используется для определения того, какие символы представлены любыми последовательными последовательностями вида "%xy".
Примечание: Рекомендация Консорциума Всемирной паутины www.w3.org/TR/html40/appendix/notes.html#non-ascii-chars гласит, что следует использовать UTF-8. Невыполнение этого требования может привести к несовместимости.
- Параметры:
-
s- декодируемаяString -
enc- Имя поддерживаемой кодировки символов. - Возвращает:
- новую декодированную
String - Исключения:
-
UnsupportedEncodingException- Если необходима кодировка символов, но указанная кодировка символов не поддерживается - Since:
- 1.4
- См. также:
URLEncoder.encode(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.