Класс 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. Имя класса должно иметь вид:
{префикс-пакета}.{major}.{minor}Если пользовательский обработчик содержимого не найден, система пытается загрузить обработчик типа содержимого из одного из встроенных обработчиков, если он существует.где {major}.{minor} формируется путем взятия строки типа содержимого, замены всех слешей на
period('.') и всех других символов, не являющихся буквенно-цифровыми, на символ подчёркивания '_'. Буквенно-цифровые символы представляют собой 26 прописных ASCII букв от 'A' до 'Z', 26 строчных ASCII букв от 'a' до 'z', и 10 ASCII цифр от '0' до '9'.Например: YoyoDyne.experimental.text.plain
Если загрузка класса обработчика содержимого будет выполнена загрузчиком классов, который находится вне цепочки делегирования вызывающей стороны, JVM потребуется разрешение RuntimePermission "getClassLoader".
- Since:
- 1.0
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
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, 2023, 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/21/docs/api/java.base/java/net/ContentHandler.html