DataHandler (Платформа Java SE 7)

java.lang. Объект
- javax.activation. DataHandler

Все Реализованные Интерфейсы:

Передаваемый
```
public class DataHandler
extends Object
implements Transferable
```
Класс DataHandler обеспечивает непротиворечивый интерфейс для доступных данных во многих различных источниках и форматах. Это управляет простым потоком к преобразованиям строк и связанному использованию операций DataContentHandlers. Это обеспечивает доступ к командам, которые могут работать на данных. Команды находятся, используя CommandMap.
DataHandler и Передаваемый Интерфейс
DataHandler реализует Передаваемый интерфейс так, чтобы данные могли использоваться в операциях передачи данных AWT, такой как сокращено и вставить и перетаскивать и отбрасывать. Реализация Передаваемого интерфейса полагается на доступность установленного соответствия объекта DataContentHandler типу MIME данных, представленных в определенном экземпляре DataHandler.
DataHandler и CommandMaps
DataHandler отслеживает текущий CommandMap, который он использует для запросов на обслуживание на команды (getCommand, getAllCommands, getPreferredCommands). Каждому экземпляру DataHandler можно было связать CommandMap с этим использующий setCommandMap метод. Если CommandMap не был установлен, DataHandler вызывает getDefaultCommandMap метод в CommandMap и использовании значение это возвращается. См. CommandMap для получения дополнительной информации.
DataHandler и URL
Текущая реализация DataHandler создает частный экземпляр URLDataSource, когда это создается с URL.

С тех пор:

1.6

См. Также:
CommandMap, DataContentHandler, DataSource, URLDataSource

Сводка конструктора

Конструкторы
Конструктор и Описание
`DataHandler(DataSource ds)` Создайте a `DataHandler` экземпляр, ссылающийся на указанный DataSource.
`DataHandler(Object obj, String mimeType)` Создайте a `DataHandler` экземпляр, представляющий объект этого типа MIME.
`DataHandler(URL url)` Создайте a `DataHandler` экземпляр, ссылающийся на URL.

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

Методы
Модификатор и Тип	Метод и Описание
`CommandInfo[]`	`getAllCommands()` Возвратите все команды для этого типа данных.
`Объект`	`getBean(CommandInfo cmdinfo)` Метод удобства, который берет CommandInfo, возражает, и инстанцирует соответствующей команды, обычно компонент JavaBean.
`CommandInfo`	`getCommand(String cmdName)` Получите команду cmdName.
`Объект`	`getContent()` Возвратите данные в его привилегированной Объектной форме.
`Строка`	`getContentType()` Возвратите тип MIME этого объекта как получено от исходного объекта.
`DataSource`	`getDataSource()` Возвратите DataSource, связанный с этим экземпляром DataHandler.
`InputStream`	`getInputStream()` Получите InputStream для этого объекта.
`Строка`	`getName()` Возвратите имя объекта данных.
`OutputStream`	`getOutputStream()` Заставьте OutputStream для этого DataHandler позволять перезаписывать базовые данные.
`CommandInfo[]`	`getPreferredCommands()` Возвратите привилегированные команды для этого типа данных.
`Объект`	`getTransferData(DataFlavor flavor)` Возвращает объект, который представляет данные, которые будут переданы.
`DataFlavor[]`	`getTransferDataFlavors()` Возвратите DataFlavors, в котором эти данные доступны.
`boolean`	`isDataFlavorSupported(DataFlavor flavor)` Возвраты, поддерживается ли указанная разновидность данных для этого объекта.
`void`	`setCommandMap(CommandMap commandMap)` Установите CommandMap для использования этим DataHandler.
`static void`	`setDataContentHandlerFactory(DataContentHandlerFactory newFactory)` Устанавливает DataContentHandlerFactory.
`void`	`writeTo(OutputStream os)` Запишите данные в `OutputStream`.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - DataHandler
```
public DataHandler(DataSource ds)
```
    Создайте a DataHandler экземпляр, ссылающийся на указанный DataSource. Данные существуют в форме потока байтов. DataSource предоставит InputStream, чтобы получить доступ к данным.
    
    Параметры:
    ds - DataSource
  - DataHandler
```
public DataHandler(Object obj,
           String mimeType)
```
    Создайте a DataHandler экземпляр, представляющий объект этого типа MIME. Этот конструктор используется, когда у приложения уже есть представление в памяти данных в форме Объекта Java.
    
    Параметры:
    obj - Объект Java
    mimeType - тип MIME объекта
  - DataHandler
```
public DataHandler(URL url)
```
    Создайте a DataHandler экземпляр, ссылающийся на URL. DataHandler внутренне создает a URLDataSource экземпляр, чтобы представить URL.
    
    Параметры:
    url - объект URL
- Деталь метода
  - getDataSource
```
public DataSource getDataSource()
```
    Возвратите DataSource, связанный с этим экземпляром DataHandler.
    Для DataHandlers, которые инстанцировали с DataSource, этот метод возвращает DataSource, который использовался, чтобы создать объект DataHandler. В других случаях DataHandler создает DataSource из данных, используемых, чтобы создать DataHandler. DataSources, создаваемые для DataHandlers, который не инстанцируют с DataSource, кэшируются по причинам производительности.
    
    Возвраты:
    допустимый DataSource возражает для этого DataHandler
  - getName
```
public String getName()
```
    Возвратите имя объекта данных. Если этот DataHandler создавался с DataSource, это вызовы метода через DataSource.getName метод, иначе это возвращает нуль.
    
    Возвраты:
    имя объекта
  - getContentType
```
public String getContentType()
```
    Возвратите тип MIME этого объекта как получено от исходного объекта. Отметьте, что это - полный тип с параметрами.
    
    Возвраты:
    тип MIME
  - getInputStream
```
public InputStream getInputStream()
                           throws IOException
```
    Получите InputStream для этого объекта.
    Для DataHandlers, который инстанцируют с DataSource, DataHandler вызывает DataSource.getInputStream метод и возвраты результат к вызывающей стороне.
    Для DataHandlers, который инстанцируют с Объектом, DataHandler сначала пытается найти DataContentHandler для Объекта. Если DataHandler не может найти DataContentHandler для этого типа MIME, он бросает UnsupportedDataTypeException. Если это успешно, это создает канал и поток. Поток использует DataContentHandler writeTo метод, чтобы записать потоковые данные в один конец канала. Другой конец канала возвращается к вызывающей стороне. Поскольку поток создается, чтобы скопировать данные, IOExceptions, который может произойти во время копии, не может быть распространен назад к вызывающей стороне. Результатом является пустой поток.
    
    Возвраты:
    InputStream, представляющий эти данные
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит
    См. Также:
    DataContentHandler.writeTo(java.lang.Object, java.lang.String, java.io.OutputStream), UnsupportedDataTypeException
  - writeTo
```
public void writeTo(OutputStream os)
             throws IOException
```
    Запишите данные в OutputStream.
    Если DataHandler создавался с DataSource, writeTo получает InputStream и копирует байты от InputStream до OutputStream, в котором передают.
    Если DataHandler создавался с объектом, writeTo получает DataContentHandler для типа объекта. Если DataContentHandler был найден, он вызывает writeTo метод на DataContentHandler.
    
    Параметры:
    os - OutputStream, чтобы записать в
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит
  - getOutputStream
```
public OutputStream getOutputStream()
                             throws IOException
```
    Заставьте OutputStream для этого DataHandler позволять перезаписывать базовые данные. Если DataHandler создавался с DataSource, DataSource getOutputStream метод вызывают. Иначе, null возвращается.
    
    Возвраты:
    OutputStream
    
    Броски:
    
    IOException
    См. Также:
    DataSource.getOutputStream(), URLDataSource
  - getTransferDataFlavors
```
public DataFlavor[] getTransferDataFlavors()
```
    Возвратите DataFlavors, в котором эти данные доступны.
    Возвращает массив объектов DataFlavor, указывающих на разновидности, в которых могут быть обеспечены данные. Массиву обычно упорядочивают согласно предпочтению обеспечению данных, от наиболее богато дескриптивного к наименее богато дескриптивному.
    DataHandler пытается найти DataContentHandler, который соответствует типу MIME данных. Если Вы располагаетесь, DataHandler вызывает DataContentHandler getTransferDataFlavors метод.
    Если DataContentHandler не может быть расположен, и если DataHandler создавался с DataSource (или URL), один DataFlavor возвращается, который представляет тип MIME этого объекта и java.io.InputStream класс. Если DataHandler создавался с объектом, и тип MIME, getTransferDataFlavors возвращает один DataFlavor, который представляет тип MIME этого объекта и класс объекта.
    
    Определенный:
    
    getTransferDataFlavors в интерфейсе Transferable
    
    Возвраты:
    массив разновидностей данных, в которых могут быть переданы эти данные
    См. Также:
    DataContentHandler.getTransferDataFlavors()
  - isDataFlavorSupported
```
public boolean isDataFlavorSupported(DataFlavor flavor)
```
    Возвраты, поддерживается ли указанная разновидность данных для этого объекта.
    Этот метод выполняет итерации через DataFlavors, возвращенный из getTransferDataFlavors, сравнение каждого с указанной разновидностью.
    
    Определенный:
    
    isDataFlavorSupported в интерфейсе Transferable
    
    Параметры:
    flavor - требуемая разновидность для данных
    
    Возвраты:
    истина, если разновидность данных поддерживается
    См. Также:
    getTransferDataFlavors()
  - getTransferData
```
public Object getTransferData(DataFlavor flavor)
                       throws UnsupportedFlavorException,
                              IOException
```
    Возвращает объект, который представляет данные, которые будут переданы. Класс возвращенного объекта определяется классом представления разновидности данных.
    Для DataHandler, создаваемого с DataSources или URL:
    DataHandler пытается определить местоположение DataContentHandler для этого типа MIME. Если Вы находитесь, переданные в DataFlavor и типе данных передают к getTransferData метод. Если DataHandler не в состоянии определить местоположение DataContentHandler, и разновидность определяет тип MIME этого объекта и java.io.InputStream класс, InputStream этого объекта возвращается. Иначе это бросает UnsupportedFlavorException.
    Для DataHandler, создаваемого с Объектами:
    DataHandler пытается определить местоположение DataContentHandler для этого типа MIME. Если Вы находитесь, переданные в DataFlavor и типе данных передают к его getTransferData методу. Если DataHandler не в состоянии определить местоположение DataContentHandler, и разновидность определяет тип MIME этого объекта и его класс, объект этого DataHandler, на который ссылаются, возвращается. Иначе это бросает UnsupportedFlavorException.
    
    Определенный:
    
    getTransferData в интерфейсе Transferable
    
    Параметры:
    flavor - требуемая разновидность для данных
    
    Возвраты:
    объект
    
    Броски:
    
    UnsupportedFlavorException - если данные не могли бы быть преобразованы в требуемую разновидность
    
    IOException - если ошибка ввода-вывода происходит
    См. Также:
    ActivationDataFlavor
  - setCommandMap
```
public void setCommandMap(CommandMap commandMap)
```
    Установите CommandMap для использования этим DataHandler. Установка этого к null заставляет CommandMap возвращаться в CommandMap, возвращенный CommandMap.getDefaultCommandMap метод. Изменение CommandMap, или установка этого к null, убирает любые данные, кэшируемые от предыдущего CommandMap.
    
    Параметры:
    commandMap - CommandMap, чтобы использовать в этом DataHandler
    См. Также:
    CommandMap.setDefaultCommandMap(javax.activation.CommandMap)
  - getPreferredCommands
```
public CommandInfo[] getPreferredCommands()
```
    Возвратите привилегированные команды для этого типа данных. Это вызовы метода getPreferredCommands метод в CommandMap связался с этим экземпляром DataHandler. Этот метод возвращает массив, который представляет подмножество доступных команд. В случаях, где многократные команды для типа MIME, представленного этим DataHandler, присутствуют, установленный CommandMap выбирает соответствующие команды.
    
    Возвраты:
    объекты CommandInfo, представляющие привилегированные команды
    См. Также:
    CommandMap.getPreferredCommands(java.lang.String)
  - getAllCommands
```
public CommandInfo[] getAllCommands()
```
    Возвратите все команды для этого типа данных. Этот метод возвращает массив, содержащий все команды для типа данных, представленных этим DataHandler. Тип MIME для базовых данных, представленных этим DataHandler, используется, чтобы вызвать через к getAllCommands метод CommandMap связался с этим DataHandler.
    
    Возвраты:
    объекты CommandInfo, представляющие все команды
    См. Также:
    CommandMap.getAllCommands(java.lang.String)
  - getCommand
```
public CommandInfo getCommand(String cmdName)
```
    Получите команду cmdName. Используйте поисковую семантику как определено CommandMap, установленным в этом DataHandler. Тип MIME для базовых данных, представленных этим DataHandler, используется, чтобы вызвать через к getCommand метод CommandMap связался с этим DataHandler.
    
    Параметры:
    cmdName - название команды
    
    Возвраты:
    CommandInfo, соответствующий команде
    См. Также:
    CommandMap.getCommand(java.lang.String, java.lang.String)
  - getContent
```
public Object getContent()
                  throws IOException
```
    Возвратите данные в его привилегированной Объектной форме.
    Если DataHandler инстанцировали с объектом, возвратите объект.
    Если DataHandler инстанцировали с DataSource, этот метод использует DataContentHandler, чтобы возвратить объект контента для данных, представленных этим DataHandler. Если нет DataContentHandler может быть найден для тип этих данных, DataHandler возвращает InputStream для данных.
    
    Возвраты:
    контент.
    
    Броски:
    
    IOException - если IOException происходит во время этой работы.
  - getBean
```
public Object getBean(CommandInfo cmdinfo)
```
    Метод удобства, который берет CommandInfo, возражает, и инстанцирует соответствующей команды, обычно компонент JavaBean.
    Это вызовы метода CommandInfo getCommandObject метод с ClassLoader используемый, чтобы загрузиться javax.activation.DataHandler класс непосредственно.
    
    Параметры:
    cmdinfo - CommandInfo, соответствующий команде
    
    Возвраты:
    инстанцированный объект команды
  - setDataContentHandlerFactory
```
public static void setDataContentHandlerFactory(DataContentHandlerFactory newFactory)
```
    Устанавливает DataContentHandlerFactory. DataContentHandlerFactory вызывают сначала, чтобы найти DataContentHandlers. Однажды может только быть установлен DataContentHandlerFactory.
    Если DataContentHandlerFactory был уже установлен, этот метод бросает Ошибку.
    
    Параметры:
    newFactory - DataContentHandlerFactory
    
    Броски:
    
    Error - если фабрика была уже определена.
    См. Также:
    DataContentHandlerFactory

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс DataHandler

Сводка конструктора

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

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

DataHandler

DataHandler

DataHandler

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

getDataSource

getName

getContentType

getInputStream

writeTo

getOutputStream

getTransferDataFlavors

isDataFlavorSupported

getTransferData

setCommandMap

getPreferredCommands

getAllCommands

getCommand

getContent

getBean

setDataContentHandlerFactory