Spec-Zone.ru › OpenJDK 21

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

{префикс-пакета}.{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
См. также:
  • getContent(java.net.URLConnection)
  • ContentHandlerFactory
  • URL.getContent()
  • URLConnection
  • URLConnection.getContent()
  • URLConnection.setContentHandlerFactory(java.net.ContentHandlerFactory)

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

Конструктор Описание
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 - если при чтении объекта произошла ошибка ввода/вывода.
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API