javax.print

クラス StreamPrintServiceFactory

java.lang.Object

javax.print.StreamPrintServiceFactory

public abstract class StreamPrintServiceFactory
extends Object

StreamPrintServiceFactory は、StreamPrintService インスタンスのファクトリです。これにより、MIME タイプに記述された特定のドキュメント形式で出力ストリームを印刷することが可能になります。一般的な出力ドキュメント形式は、Postscript(TM) です。

このクラスは、サービスによって実装され、「SPI JAR ファイル仕様」を使用する実装により検出されます。

アプリケーションは、lookupStreamPrintServiceFactories(DocFlavor, String) メソッドを呼び出して、このクラスのインスタンスを検出します。

アプリケーションは、物理プリンタデバイスを表す PrintService の代わりに、ファクトリから取得した StreamPrintService を使用できます。

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
StreamPrintServiceFactory()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract String	getOutputFormat() このファクトリから取得されたプリンタが出力するドキュメント形式のファクトリ照会します。
abstract StreamPrintService	getPrintService(OutputStream out) 指定された出力ストリームに印刷可能な StreamPrintService を返します。
abstract DocFlavor[]	getSupportedDocFlavors() このファクトリから取得されたプリンタが受け入れ可能なドキュメントフレーバのファクトリを照会します。
static StreamPrintServiceFactory[]	lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType) データストリームを outputMimeType で指定された形式で出力するために、印刷ジョブで使用可能な印刷サービス用ファクトリを検出します。

クラス 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)

データストリームを 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 は作成できません。構築にリソースを割り当てる実装では、ストリームを検査し、ストリームが null でない場合だけにリソースを割り当てるようにできます。

パラメータ:

out - 生成された出力の転送先ストリーム。

戻り値:

この Factory がサポートする DocFlavor により指定された形式を生成する PrintService