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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в будущем выпуске.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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.