Класс 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. Имя класса должно иметь следующий вид:

{package-prefix}.{major}.{minor}
где {major}.{minor} формируется из строки типа содержимого: все символы косой черты заменяются на 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-соединения, установленный в начало представления объекта, этот метод считывает поток и создает объект, соответствующий одному из указанных типов.

Методы, объявленные в классе 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/ContentHandler.html