Интерфейс DataContentHandler

public interface DataContentHandler

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

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

Методы

getTransferDataFlavors

DataFlavor[] getTransferDataFlavors()

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

Возвращает:

DataFlavors.

getTransferData

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

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

Параметры:

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 - ошибки записи в поток