javax.print
類別 StreamPrintServiceFactory

java.lang.Object
  javax.print.StreamPrintServiceFactory

public abstract class StreamPrintServiceFactory
extends Object

StreamPrintServiceFactory 是 StreamPrintService 實例的處理器，StreamPrintService 可以 mime 型別所描述的特定文檔格式向輸出串流中列印資料。典型的輸出文檔格式為 Postscript(TM)。

此類別由服務實作，並通過服從 SPI JAR File specification 的實作尋找。

應用程序可調用 lookupStreamPrintServiceFactories(DocFlavor, String) 方法來尋找此類別的實例。

應用程序可使用從處理器獲得的 StreamPrintService 來代替表示物理印表機設備的 PrintService。

建構子摘要

StreamPrintServiceFactory()

方法摘要

abstract String	getOutputFormat() 查詢該處理器，瞭解從此處理器獲得的印表機所發出的文檔的格式。
abstract StreamPrintService	getPrintService(OutputStream out) 返回可列印到指定輸出串流的 StreamPrintService。
abstract DocFlavor[]	getSupportedDocFlavors() 查詢該處理器，瞭解從此處理器所獲得印表機可接受的 doc flavor。
static StreamPrintServiceFactory[]	lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType) 尋找 PrintService 的處理器，PrintJob 可使用它來輸出資料串流，資料格式由 flavor 指定。

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

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

建構子詳細資訊

StreamPrintServiceFactory

public StreamPrintServiceFactory()

方法詳細資訊

lookupStreamPrintServiceFactories

public static StreamPrintServiceFactory[] lookupStreamPrintServiceFactories(DocFlavor flavor,
                                                                            String outputMimeType)

尋找 PrintService 的處理器，PrintJob 可使用它來輸出資料串流，資料格式由 flavor 指定。例如，doc flavor 是使用者希望創建的文檔型別，不是列印前的文檔 flavor。

雖然在 StreamPrintService 的尋找中使用 null 是可接受的值，但是通常要搜尋所需的特定格式，如 Postscript(TM)。

參數：

flavor - 輸入文檔的型別 - null 意味著比對全部類別型。

outputMimeType - 表示所需的輸出格式，用於標識適合的串流印表機處理器。null 值意味著比對所有格式。

返回：

用於 StreamPrintService 實例的比對處理器，如果無法找到適合的處理器，則返回一個空處理器。

getOutputFormat

public abstract String getOutputFormat()

查詢該處理器，瞭解從此處理器獲得的印表機所發出的文檔的格式。

返回：

以 mime 型別描述的輸出格式。

getSupportedDocFlavors

public abstract DocFlavor[] getSupportedDocFlavors()

查詢該處理器，瞭解從此處理器所獲得印表機可接受的 doc flavor。

返回：

受支持的 doc flavor 的陣列。

getPrintService

public abstract StreamPrintService getPrintService(OutputStream out)

返回可列印到指定輸出串流的 StreamPrintService。由應用程序創建並管理該輸出串流。應用程序負責關閉該串流，並確保不再使用此印表機。從印表機創建的所有 PrintJob 完成前，應用程序不應關閉此串流。提前關閉此串流可能產生 PrinterException 和一個指示作業失敗的事件。

儘管可以重用連接到物理印表機的 PrintService，但不能重用連接到串流的 StreamPrintService。從 DocPrintJob 的 print 方法返回前，列印系統可使用 dispose 方法處置底層的 StreamPrintService，這樣該列印系統就知道此印表機不再是可使用的。這等效於從此轉至脫機狀態的物理印表機。應用程序可以提供一個 null 列印串流來創建可查詢的服務。為這種串流創建一個 PrintJob 是無效的。在建構時分派資源的實作應該檢查該串流，並且僅在該串流不為 null 時才分派資源。

參數：

out - 已產生輸出的目標串流。

返回：

一個 PrintService，它將產生由此處理器所支持的 DocFlavor 所指定的格式。