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 - 寫入串流時出現錯誤