javax.print
類別 SimpleDoc

java.lang.Object
  javax.print.SimpleDoc

所有已實作的介面：

Doc

public final class SimpleDoc
extends Object
implements Doc

此類別是介面 Doc 的實作，可用於很多常見的列印請求中。它可處理目前作為 DocFlavor 類別中靜態變數所定義的所有“預定義” doc flavor。

特別是此類別實作了某些 Doc 規範所必需的語義：

• 如果請求了並且是合適的，則為服務建構串流。
• 確保對某個方法的每次調用都返回相同的物件。
• 確保多個執行緒可以存取 Doc。
• 對資料是否與 doc flavor 相符執行某種驗證。

希望在其他作業中重用該 doc 物件或需要 MultiDoc 的客戶端不希望使用此類別。

如果列印資料是一個串流，或者列印作業以串流的形式請求資料，那麼當資料傳輸完成或作業終止後服務正確地關閉該串流時，SimpleDoc 不再進行監視。客戶端可能優先使用其自己添加了偵聽器的 doc 實作，以監視作業的完成並驗證是否有諸如串流等的可用資源（即是否已關閉）。

建構子摘要

SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes)
建構具有指定列印資料、doc flavor 和 doc 屬性集的 SimpleDoc。

方法摘要

DocAttributeSet	getAttributes() 獲得此 doc 物件的列印屬性集。
DocFlavor	getDocFlavor() 確定其 doc 物件將提供其部分列印資料的 doc flavor。
Object	getPrintData() 獲得列印資料表示形式物件，該物件包含此 doc 物件的部分列印資料，其格式對應於受支持的 DocFlavor。
Reader	getReaderForText() 獲得一個從此 doc 中提取字元列印資料的 reader。
InputStream	getStreamForBytes() 獲得一個從此 doc 中提取 byte 列印資料的輸入串流。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

SimpleDoc

public SimpleDoc(Object printData,
                 DocFlavor flavor,
                 DocAttributeSet attributes)

建構具有指定列印資料、doc flavor 和 doc 屬性集的 SimpleDoc。

參數：

printData - 列印資料物件

flavor - DocFlavor 物件

attributes - DocAttributeSet，可以為 null

拋出：

IllegalArgumentException - 如果 flavor 或 printData 為 null，或者 printData 不對應於指定的 doc flavor--例如，資料不是 DocFlavor 中的表示形式所指定的型別。

方法詳細資訊

getDocFlavor

public DocFlavor getDocFlavor()

確定其 doc 物件將提供其部分列印資料的 doc flavor。

指定者：

介面 Doc 中的 getDocFlavor

返回：

DocFlavor。

getAttributes

public DocAttributeSet getAttributes()

獲得此 doc 物件的列印屬性集。如果返回的屬性集包括特定屬性 X 的實例，則印表機必須為此 doc 使用該屬性值，該值覆寫作業屬性集中屬性 X 的所有值。如果返回的屬性集不包括特定屬性 X 的實例，或者返回 null，則印表機必須參考該作業的屬性集來獲得屬性 X 的值，如果在該集合中未找到該屬性值，則印表機必須使用一個與實作相關的預設值。返回的屬性集是不可修改的。

指定者：

介面 Doc 中的 getAttributes

返回：

此 doc 不可修改的列印屬性集，或者為 null，以從該作業的屬性集中獲得所有屬性值。

getPrintData

public Object getPrintData()
                    throws IOException

從介面 Doc 複製的描述

獲得列印資料表示形式物件，該物件包含此 doc 物件的部分列印資料，其格式對應於受支持的 DocFlavor。getPrintData() 方法返回一個表示形式類別的實例，其名稱由 getDocFlavor()、getRepresentationClassName() 給定，可將返回值從類別 Object 強制轉換為該表示形式類別。

指定者：

介面 Doc 中的 getPrintData

返回：

列印資料表示形式物件。

拋出：

IOException - 如果表示形式類別是一個串流且在建構該串流時存在 I/O 錯誤。

getReaderForText

public Reader getReaderForText()
                        throws IOException

獲得一個從此 doc 中提取字元列印資料的 reader。如果 DocFlavor 具有以下列印資料表示形式類別之一，則需要 Doc 實作支持此方法，否則返回 null：

• char[]
• java.lang.String
• java.io.Reader

為了從列印資料表示形式物件中以字元串流的形式讀取列印資料，使用 doc 的列印資料表示形式物件來建構並返回一個 Reader。但是，如果列印資料表示形式物件本身就是一個 Reader，則只返回該列印資料表示形式物件。

指定者：

介面 Doc 中的 getReaderForText

返回：

從此 doc 中讀取列印資料字元的 Reader。如果因為此 doc 不符合上述標準而無法提供 reader，則返回 null。

拋出：

IOException - 如果創建 reader 時存在 I/O 錯誤。

getStreamForBytes

public InputStream getStreamForBytes()
                              throws IOException

獲得一個從此 doc 中提取 byte 列印資料的輸入串流。如果 DocFlavor 具有以下列印資料表示形式類別之一，則需要 Doc 實作支持此方法，否則此方法返回 null：

• byte[]
• java.io.InputStream

獲得該 doc 的列印資料表示形式物件。然後，為了從列印資料表示形式物件中以 byte 串流形式讀取列印資料，創建並返回一個輸入串流。但是，如果列印資料表示形式物件本身就是一個輸入串流，則只返回該列印資料表示形式物件。

指定者：

介面 Doc 中的 getStreamForBytes

返回：

從此 doc 中讀取列印資料 byte 的 InputStream。如果因為此 doc 不符合上述標準而無法提供輸入串流，則返回 null。

拋出：

IOException - 如果創建輸入串流時存在 I/O 錯誤。