モジュール java.desktop

パッケージ javax.print

クラスStreamPrintServiceFactory

java.lang.Object

javax.print.StreamPrintServiceFactory

public abstract class StreamPrintServiceFactory extends Object

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

このクラスは、サービスによって実装され、ServiceLoader機能を使用して実装によって配置されます。

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

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

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

コンストラクタ

修飾子	コンストラクタ	説明
protected	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

protected 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を作成することは有効ではありません。 構築にリソースを割り当てる実装では、ストリームを調べて、ストリームがnon-nullの場合にのみリソースを割り当てたいことがあります。

パラメータ:

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

戻り値:

このファクトリでサポートされているDocFlavorで指定されたフォーマットを生成するPrintService