Класс ContentHandler

public abstract class ContentHandler
extends Object

Абстрактный класс ContentHandler является суперклассом всех классов, которые считывают Object из URLConnection.

Приложение обычно не вызывает метод getContent в этом классе напрямую. Вместо этого приложение вызывает метод getContent в классе URL или в URLConnection. Фабрика обработчика содержимого приложения (экземпляр класса, реализующего интерфейс ContentHandlerFactory, настроенный вызовом setContentHandler) вызывается с String, указывающим MIME-тип получаемого объекта по сокету. Фабрика возвращает экземпляр подкласса ContentHandler, и его метод getContent вызывается для создания объекта.

Если обработчик содержимого не найден, URLConnection будет искать его в пользовательском настраиваемом наборе мест. По умолчанию он ищет в sun.net.www.content, но пользователи могут определить вертикально-разделительный набор префиксов классов для поиска дополнительно, определив свойство java.content.handler.pkgs. Имя класса должно иметь вид:

{package-prefix}.{major}.{minor}
 e.g.
     YoyoDyne.experimental.text.plain

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

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

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() и проверить возвращаемый тип на соответствие предложенным типам.

Параметры:

urlc - подключение к URL.

classes - массив запрошенных типов

Возвращает:

объект, считанный ContentHandler , который является первым соответствием предложенным типам. null, если ни один из запрошенных типов не поддерживается.

Исключения:

IOException - если при чтении объекта произошла ошибка ввода-вывода.

Since:

1.3