Module java.activation

软件包 javax.activation

Interface DataContentHandler

public interface DataContentHandler

DataContentHandler接口由可用于扩展DataHandler实现可传输接口的功能的对象实现。 通过DataContentHandlers框架可以扩展，将DataContentHandlers对象，并将对象写入到流中。

DataContentHandler的实现应该是一个带有public no-arg构造函数的公共类。 如果实现类在一个命名模块中，那么它应该在一个导出到模块java.activation的API包中。

应用程序通常不直接在DataContentHandlers中调用方法。 相反，应用程序调用DataHandler中的等效方法。 DataHandler将尝试使用当前的DataContentHandlerFactory找到与其MIME类型相对应的适当的DataContentHandler。 DataHandler然后调用DataContentHandler中的方法。

从以下版本开始：

1.6

方法摘要

Modifier and Type	方法	描述
Object	getContent(DataSource ds)	以最优选的形式返回表示数据的对象。
Object	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

返回表示要传输的数据的对象。 返回的对象的类由flavor的表示类定义。

参数

df - 表示请求类型的DataFlavor。

ds - 表示要转换的数据的DataSource。

结果

构造的对象。

异常

UnsupportedFlavorException - 如果处理程序不支持请求的风味

IOException - 如果无法访问数据

getContent

Object getContent(DataSource ds)
           throws IOException

以最优选的形式返回表示数据的对象。 通常这将是getTransferDataFlavors方法返回的第一个DataFlavor描述的形式。

参数

ds - 表示要转换的数据的DataSource。

结果

构造的对象。

异常

IOException - 如果无法访问数据

writeTo

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

将对象转换为指定MIME类型的字节流，并将其写入输出流。

参数

obj - 要转换的对象。

mimeType - 生成的字节流所请求的MIME类型。

os - 写入转换后的字节流的输出流。

异常

IOException - 写入流的错误