Класс ContentHandler
public abstract class ContentHandler extends Object
ContentHandler является суперклассом всех классов, которые считывают Object из URLConnection. Приложение обычно не вызывает метод getContent в этом классе напрямую. Вместо этого приложение вызывает метод getContent в классе URL или в URLConnection. Фабрика обработчиков содержимого приложения (экземпляр класса, реализующего интерфейс ContentHandlerFactory, настроенный вызовом setContentHandlerFactory) вызывается с String, указывающим MIME-тип объекта, получаемого по сокету. Фабрика возвращает экземпляр подкласса ContentHandler, и вызывается его метод getContent для создания объекта.
Если обработчик содержимого не был найден, URLConnection будет искать обработчик содержимого в настраиваемом набором мест. Пользователи могут определить набор префиксов класса, разделенных вертикальной чертой, для поиска, определив свойство "java.content.handler.pkgs". Имя класса должно быть в формате:
{префикс-пакета}.{главная}.{дополнительная}Если не найден пользовательский обработчик содержимого, система пытается загрузить обработчик определённого типа содержимого (content-type) из одного из встроенных обработчиков, если он существует.где {главная}.{дополнительная} формируется путем взятия строки типа содержимого, замены всех символов косой черты на
period('.') и всех других символов, не являющихся буквенно-цифровыми, на символ подчеркивания '_'. Буквенно-цифровые символы - это 26 прописных ASCII-букв 'A' до 'Z', 26 строчных ASCII-букв 'a' до 'z', и 10 ASCII-цифр '0' до '9'.Например, YoyoDyne.experimental.text.plain
Если загрузка класса обработчика содержимого будет выполняться загрузчиком классов, который находится вне цепочки делегирования вызывающего класса, JVM потребуется разрешение RuntimePermission "getClassLoader".
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
ContentHandler() |
Конструктор для вызова подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract Object |
getContent |
Учитывая поток подключения к URL, расположенный в начале представления объекта, этот метод считывает этот поток и создает объект из него. |
Object |
getContent |
Учитывая поток подключения к URL, расположенный в начале представления объекта, этот метод считывает этот поток и создает объект, соответствующий одному из указанных типов. |
Подробное описание конструкторов
ContentHandler
public ContentHandler()
Подробное описание методов
getContent
public abstract Object getContent(URLConnection urlc) throws IOException
- Параметры:
-
urlc- подключение к URL. - Возвращает:
- объект, считанный методом
ContentHandler. - Исключения:
-
IOException- если при чтении объекта произошла ошибка ввода-вывода.
getContent
public Object getContent(URLConnection urlc, Class[] classes) throws IOException
getContent(URLConnection) и проверять тип возвращаемого значения на соответствие предложенным типам.- Параметры:
-
urlc- подключение к URL. -
classes- массив затребованных типов - Возвращает:
- объект, считанный методом
ContentHandler, который является первым совпадением с предложенными типами, илиnull, если ни один из затребованных типов не поддерживается. - Исключения:
-
IOException- если при чтении объекта произошла ошибка ввода-вывода. - Since:
- 1.3
© 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/ContentHandler.html