- java.lang.Object
-
- javax.print.StreamPrintServiceFactory
-
public abstract class StreamPrintServiceFactory extends Object
StreamPrintServiceFactory
は、StreamPrintService
インスタンスのファクトリです。これにより、MIMEタイプに記述された特定のドキュメント形式で出力ストリームを印刷することが可能になります。 一般的な出力ドキュメント形式は、Postscript(TM)です。このクラスは、サービスによって実装され、
ServiceLoader
機能を使用して実装によって配置されます。アプリケーションは、
lookupStreamPrintServiceFactories(DocFlavor, String)
メソッドを呼び出して、このクラスのインスタンスを検出します。アプリケーションは、物理プリンタ・デバイスを表す
PrintService
の代わりに、ファクトリから取得したStreamPrintService
を使用できます。
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 StreamPrintServiceFactory()
-
メソッドのサマリー
すべてのメソッド staticメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 abstract String
getOutputFormat()
このファクトリから取得されたプリンタが出力するドキュメント形式のファクトリ照会します。abstract StreamPrintService
getPrintService(OutputStream out)
指定された出力ストリームに印刷可能なStreamPrintService
を返します。abstract DocFlavor[]
getSupportedDocFlavors()
このファクトリから取得されたプリンタが受け入れ可能なドキュメント・フレーバのファクトリを照会します。static StreamPrintServiceFactory[]
lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType)
データ・ストリームをoutputMimeType
で指定された形式で出力するために、印刷ジョブで使用可能な印刷サービス用ファクトリを検出します。
-
-
-
メソッドの詳細
-
lookupStreamPrintServiceFactories
public static StreamPrintServiceFactory[] lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType)
データ・ストリームをoutputMimeType
で指定された形式で出力するために、印刷ジョブで使用可能な印刷サービス用ファクトリを検出します。outputMimeType
パラメータは、作成するドキュメント・タイプを記述します。一方、flavor
パラメータは、入力データがアプリケーションによってStreamPrintService
に渡されるときの形式を記述します。ストリーム印刷サービスの検索では
null
を使用することができますが、Postscript(TM)などの特定のフォーマットを検索するのが一般的です。- パラメータ:
flavor
- 入力ドキュメント・タイプの -null
はすべてのタイプに一致することを意味outputMimeType
-要求された出力形式を表し、適切なストリーム・プリンタ・ファクトリの識別に使用される。null
の値は、すべての形式に一致することを意味します。- 戻り値:
- ストリーム・プリント・サービス・インスタンスのためのファクトリの照合、適切なファクトリを配置できなかった場合は空
-
getOutputFormat
public abstract String getOutputFormat()
このファクトリから取得されたプリンタが出力するドキュメント形式のファクトリ照会します。- 戻り値:
- MIMEタイプで記述された出力形式
-
getSupportedDocFlavors
public abstract DocFlavor[] getSupportedDocFlavors()
このファクトリから取得されたプリンタが受け入れ可能なドキュメント・フレーバのファクトリを照会します。- 戻り値:
- サポートされるdocフレーバの配列
-
getPrintService
public abstract StreamPrintService getPrintService(OutputStream out)
指定された出力ストリームに印刷可能なStreamPrintService
を返します。 出力ストリームは、アプリケーションにより作成および管理されます。 ストリームを閉じて、このPrinter
が再使用されないようにするのはアプリケーションの責任です。 アプリケーションは、プリンタから作成された印刷ジョブがすべて完了するまで、このストリームを閉じてはなりません。 完了前にストリームを閉じると、PrinterException
およびジョブが失敗したことを示すイベントが生成される場合があります。物理プリンタに接続された
PrintService
は再利用可能ですが、ストリームに接続されたStreamPrintService
は再利用できません。 印刷システムでは、DocPrintJob
のprint
メソッドから戻る前に、dispose
メソッドを使用して基本となるStreamPrintService
を破棄することがあります。これにより、印刷システムはこのプリンタが使用可能な状態にないことを認識できます。 これは、物理プリンタを恒久的にオフラインにすることと同じです。 アプリケーションは、問合せ可能なサービスを作成するためにnull
プリント・ストリームを提供することができます。 このようなストリームに対してPrintJob
を作成することは有効ではありません。 構築にリソースを割り当てる実装では、ストリームを調べて、ストリームがnon-null
の場合にのみリソースを割り当てたいことがあります。- パラメータ:
out
- 生成された出力の転送先ストリーム- 戻り値:
- このファクトリでサポートされている
DocFlavor
で指定されたフォーマットを生成するPrintService
-
-