Класс ContentHandler

java.lang.Object

java.net.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. Имя класса должно иметь вид:

{префикс-пакета}.{главная_версия}.{дополнительная_версия}
где {главная_версия}.{дополнительная_версия} формируется путем взятия строки типа содержимого, замены всех символов косой черты на period ('.'), а все остальные символы, не являющиеся буквенно-цифровыми, заменяются символом подчеркивания '_'. Буквенно-цифровые символы — это конкретно 26 прописных ASCII-букв от 'A' до 'Z', 26 строчных ASCII-букв от 'a' до 'z' и 10 ASCII-цифр от '0' до '9'.

Пример: YoyoDyne.experimental.text.plain

Если обработчик содержимого, определенный пользователем, не найден, система пытается загрузить обработчик определенного типа содержимого из одного из встроенных обработчиков, если он существует.

С момента:

1.0

См. также:

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

Конструктор	Описание
`ContentHandler()`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`abstract Object`	`getContent(URLConnection urlc)`	Учитывая поток соединения URL, размещённый в начале представления объекта, этот метод считывает этот поток и создаёт объект из него.
`Object`	`getContent(URLConnection urlc, Class[] classes)`	Учитывая поток соединения URL, размещённый в начале представления объекта, этот метод считывает этот поток и создаёт объект, соответствующий одному из указанных типов.

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

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

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

ContentHandler

public ContentHandler()

Конструктор для вызова подклассами.

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

getContent

public abstract Object getContent(URLConnection urlc) throws IOException

Учитывая поток соединения URL, размещённый в начале представления объекта, этот метод считывает этот поток и создаёт объект из него.

Параметры:: urlc - соединение URL.
Возвращает:: объект, считанный с помощью ContentHandler.
Исключение:: IOException - если при чтении объекта произошла ошибка ввода/вывода.

getContent

public Object getContent(URLConnection urlc, Class[] classes) throws IOException

Учитывая поток соединения URL, размещённый в начале представления объекта, этот метод считывает этот поток и создаёт объект, соответствующий одному из указанных типов. Реализация по умолчанию этого метода должна вызвать getContent(URLConnection) и проверить тип возвращаемого значения на соответствие предложенным типам.

Параметры:: urlc - соединение URL.; classes - массив запрашиваемых типов
Возвращает:: объект, считанный с помощью ContentHandler, который является первым совпадением среди предложенных типов, или null, если ни один из запрошенных типов не поддерживается.
Исключение:: IOException - если при чтении объекта произошла ошибка ввода/вывода.
С момента:: 1.3

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/net/ContentHandler.html