javax.activation

Интерфейс DataContentHandler

public interface DataContentHandler

Интерфейс DataContentHandler реализуется объектами, которые могут использоваться, чтобы расширить возможности реализации DataHandler Передаваемого интерфейса. Через DataContentHandlers платформа может быть расширена, чтобы преобразовать потоки в в объекты, и записать объекты в потоки.

Приложения обычно не вызывают методы в DataContentHandlers непосредственно. Вместо этого приложение вызывает эквивалентные методы в DataHandler. DataHandler попытается найти соответствующий DataContentHandler, который соответствует его типу MIME, используя текущий DataContentHandlerFactory. DataHandler тогда вызывает через к методам в DataContentHandler.

С тех пор:

1.6

Сводка метода

Модификатор и Тип	Метод и Описание
Объект	getContent(DataSource ds) Возвратите объект, представляющий данные в его наиболее привилегированной форме.
Объект	getTransferData(DataFlavor df, DataSource ds) Возвращает объект, который представляет данные, которые будут переданы.
DataFlavor[]	getTransferDataFlavors() Возвращает массив объектов DataFlavor, указывающих на разновидности, в которых могут быть обеспечены данные.
void	writeTo(Object obj, String mimeType, OutputStream os) Преобразуйте объект в поток байтов указанного типа MIME и запишите это в поток вывода.

Деталь метода

getTransferDataFlavors

DataFlavor[] getTransferDataFlavors()

Возвращает массив объектов DataFlavor, указывающих на разновидности, в которых могут быть обеспечены данные. Массиву нужно упорядочить согласно предпочтению обеспечению данных (от наиболее богато дескриптивного к наименее дескриптивному).

Возвраты:

DataFlavors.

getTransferData

Object getTransferData(DataFlavor df,
                       DataSource ds)
                throws UnsupportedFlavorException,
                       IOException

Возвращает объект, который представляет данные, которые будут переданы. class возвращенного объекта определяется представлением class разновидности.

Параметры:

df - DataFlavor, представляющий требуемый тип.

ds - DataSource, представляющий данные, которые будут преобразованы.

Возвраты:

Созданный Объект.

Броски:

UnsupportedFlavorException - если обработчик не поддерживает требуемую разновидность

IOException - если к данным нельзя получить доступ

getContent

Object getContent(DataSource ds)
           throws IOException

Возвратите объект, представляющий данные в его наиболее привилегированной форме. Обычно это будет формой, описанной первым DataFlavor, возвращенным getTransferDataFlavors метод.

Параметры:

ds - DataSource, представляющий данные, которые будут преобразованы.

Возвраты:

Созданный Объект.

Броски:

IOException - если к данным нельзя получить доступ

writeTo

void writeTo(Object obj,
             String mimeType,
             OutputStream os)
      throws IOException

Преобразуйте объект в поток байтов указанного типа MIME и запишите это в поток вывода.

Параметры:

obj - Объект, который будет преобразован.

mimeType - Требуемый тип MIME получающегося потока байтов.

os - Поток вывода, в который можно записать преобразованный поток байтов.

Броски:

IOException - ошибки, пишущие в поток