モジュール java.desktop
パッケージ javax.print

クラスStreamPrintServiceFactory


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

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

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

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

    • コンストラクタの詳細

      • 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