java.lang.Object
javax.print.SimpleDoc
- すべての実装されたインタフェース:
Doc
public final class SimpleDoc extends Object implements Doc
このクラスは、一般的な多くの印刷要求で使用可能な
Doc
インタフェースの実装です。 これは、DocFlavor
クラスの静的変数として定義されている現在定義されている"pre-defined" docバーのすべてを処理できます。
特に、このクラスは、次のように、Doc
仕様の特定の必要なセマンティクスを実装します:
- 要求されていて適切な場合に、サービス用のストリームを構築する
- メソッドに対する各呼出しで、同じオブジェクトが返されるようにする
- 複数のスレッドが
Doc
にアクセスできるようにします - データとdocフレーバの一致確認をいくつか実行する
MultiDoc
を必要とするクライアントは、このクラスを使用したくないでしょう。
印刷データがストリームの場合、または印刷ジョブがデータをストリームとして要求する場合、SimpleDoc
は、データ転送やジョブの完了後にサービスがストリームを適切に閉じるかどうかを監視しません。 クライアントは、リスナーを追加する独自のdoc実装を提供して、ジョブの完了を監視したり、ストリームなどのリソースの解放(クローズ)を確認することもできます。
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes)
指定された印刷データ、docフレーバ、およびdoc属性セットを使用して、SimpleDoc
を構築します。 -
メソッドのサマリー
修飾子と型 メソッド 説明 DocAttributeSet
getAttributes()
このdocオブジェクトの印刷属性セットを取得します。DocFlavor
getDocFlavor()
このdocオブジェクトが印刷データの一部を提供するdocフレーバを判別します。Object
getPrintData()
このdocオブジェクトの印刷データの一部を含む印刷データ表現オブジェクトを、サポートするdocフレーバに対応する形式で取得します。Reader
getReaderForText()
このdocから文字印刷データを抽出するためのリーダーを取得します。InputStream
getStreamForBytes()
このdocからバイト印刷データを抽出するための入力ストリームを取得します。
-
コンストラクタの詳細
-
SimpleDoc
public SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes)指定された印刷データ、docフレーバ、およびdoc属性セットを使用して、SimpleDoc
を構築します。- パラメータ:
printData
- 印刷データ・オブジェクト。flavor
-DocFlavor
オブジェクトattributes
-DocAttributeSet
(null
の場合あり)- 例外:
IllegalArgumentException
-flavor
またはprintData
がnull
の場合、またはprintData
が指定されたdocフレーバに対応しない場合-たとえば、DocFlavor
の表現として指定されたタイプのデータではない
-
-
メソッドの詳細
-
getDocFlavor
public DocFlavor getDocFlavor()このdocオブジェクトが印刷データの一部を提供するdocフレーバを判別します。- 定義:
getDocFlavor
、インタフェース:Doc
- 戻り値:
- doc flavor (ドキュメント・フレーバ)
-
getAttributes
public DocAttributeSet getAttributes()このdocオブジェクトの印刷属性セットを取得します。 返される属性セットに特定の属性Xのインスタンスが含まれる場合、プリンタはその属性値をこのdocに使用して、ジョブの属性セット内の属性Xの値をすべてオーバーライドする必要があります。 返された属性セットに特定の属性Xのインスタンスが含まれていない場合、またはnull
が返された場合、プリンタは「バツ、」属性の値を取得するためにジョブ属性セットを調べ、見つからなければ実装依存デフォルト値。 返された属性セットは変更できません。- 定義:
getAttributes
、インタフェース:Doc
- 戻り値:
- このdocの印刷属性の変更不可能なセット、またはジョブ属性セットからすべての属性値を取得する
null
-
getPrintData
public Object getPrintData() throws IOExceptionこのdocオブジェクトの印刷データの一部を含む印刷データ表現オブジェクトを、サポートするdocフレーバに対応する形式で取得します。getPrintData()
メソッドは、名前がgetDocFlavor()
.getRepresentationClassName()
で与えられる表現クラスのインスタンスを返し、戻り値はクラスObject
からその表現クラスにキャストできます。- 定義:
getPrintData
、インタフェース:Doc
- 戻り値:
- 印刷データ表現オブジェクト
- 例外:
IOException
- 表現クラスがストリームであり、ストリームの作成中にI/Oエラーが発生した場合
-
getReaderForText
public Reader getReaderForText() throws IOExceptionこのdocから文字印刷データを抽出するためのリーダーを取得します。DocFlavor
が次の印刷データ表現クラスのどれかを保持する場合、Doc
実装がこのメソッドをサポートする必要があります。保持しない場合、null
が返されます。char[]
java.lang.String
java.io.Reader
Reader
を構築して返します。 ただし、印刷データ表現オブジェクト自体がReader
の場合、印刷データ表現オブジェクトが返されるだけです。- 定義:
getReaderForText
、インタフェース:Doc
- 戻り値:
- このdocから印刷データ文字を読み取るための
Reader
。 このdocが上記の基準を満たさないためにリーダーを使用できない場合、null
が返される。 - 例外:
IOException
- リーダーの作成時に入出力エラーが発生した場合
-
getStreamForBytes
public InputStream getStreamForBytes() throws IOExceptionこのdocからバイト印刷データを抽出するための入力ストリームを取得します。DocFlavor
が次の印刷データ表現クラスのどれかを保持する場合、Doc
実装がこのメソッドをサポートする必要があります。そうでない場合はこのメソッドからnull
が返されます。byte[]
java.io.InputStream
- 定義:
getStreamForBytes
、インタフェース:Doc
- 戻り値:
- このdocから印刷データ・バイトを読み取るための
InputStream
。 このdocが上記の基準を満たさないために入力ストリームを使用できない場合、null
が返される。 - 例外:
IOException
- 入力ストリームの作成中に入出力エラーが発生した場合
-