Spec-Zone.ru › OpenJDK 8

Класс 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)

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

Методы, унаследованные от класса 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API