javax.activation
接口 DataContentHandler

public interface DataContentHandler

DataContentHandler 接口由可用于扩展 Transferable 接口的 DataHandler 实现性能的对象来实现。通过 DataContentHandlers 可扩展该框架，使它能够将流转入对象，并能将对象写入流。

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

从以下版本开始：

1.6

---

方法摘要
Object	getContent(DataSource ds)           返回一个对象，该对象表示其首选形式的数据。
Object	getTransferData(DataFlavor df, DataSource ds)           返回一个对象，该对象表示将要传输的数据。
DataFlavor[]	getTransferDataFlavors()           返回一个 DataFlavor 对象数组，这些对象指示可用于提供数据的 flavor。
void	writeTo(Object obj, String mimeType, OutputStream os)           将对象转换为指定 MIME 类型的字节流，并将其写入输出流。

 

方法详细信息

getTransferDataFlavors

DataFlavor[] getTransferDataFlavors()

返回一个 DataFlavor 对象数组，这些对象指示可用于提供数据的 flavor。该数组应该根据提供数据的首选项来排序（从描述最多的到描述最少的）。

返回：

DataFlavor。

---

getTransferData

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

返回一个对象，该对象表示将要传输的数据。返回的对象的类是由该 flavor 的表示形式类定义的。

参数：

df - 表示所请求类型的 DataFlavor。

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

返回：

构造的对象

抛出：

UnsupportedFlavorException - 如果处理程序不支持所请求的 flavor

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 - 写入流时出现错误