javax.print
インタフェース DocPrintJob

既知のサブインタフェースの一覧:

CancelablePrintJob, MultiDocPrintJob

public interface DocPrintJob

このインタフェースは、ジョブ属性セットを保持する指定されたドキュメントを印刷可能な印刷ジョブを表します。このインタフェースを実装するオブジェクトは、印刷サービスから取得できます。

メソッドの概要

void	addPrintJobAttributeListener(PrintJobAttributeListener listener, PrintJobAttributeSet attributes) 指定された属性の変更用のリスナーを登録します。
void	addPrintJobListener(PrintJobListener listener) この印刷ジョブ時に発生するイベントのリスナーを登録します。
PrintJobAttributeSet	getAttributes() この Print Job の印刷属性セットを取得します。
PrintService	getPrintService() この印刷ジョブがバインドされている PrintService オブジェクトを判別します。
void	print(Doc doc, PrintRequestAttributeSet attributes) ドキュメントを指定されたジョブ属性で印刷します。
void	removePrintJobAttributeListener(PrintJobAttributeListener listener) この印刷ジョブから属性リスナーを削除します。
void	removePrintJobListener(PrintJobListener listener) この印刷ジョブからリスナーを削除します。

メソッドの詳細

getPrintService

public PrintService getPrintService()

この印刷ジョブがバインドされている PrintService オブジェクトを判別します。

戻り値:

PrintService オブジェクト

getAttributes

public PrintJobAttributeSet getAttributes()

この Print Job の印刷属性セットを取得します。返される属性セットオブジェクトは変更できません。返される属性セットオブジェクトは、この Print Job の属性セットの getAttributes() メソッド呼び出し時の「スナップショット」です。つまり、この Print Job の属性セットの内容が将来変更されても、返される属性セットオブジェクトの内容は更新されません。属性値の変更を検出するには、getAttributes() を再度呼び出して、新規属性セットを以前の属性セットと比較します。もう 1 つの方法として、印刷ジョブイベントのリスナーを登録することもできます。返される値は、空のセットでもかまいませんが、null にすることはできません。

戻り値:

印刷ジョブ属性

addPrintJobListener

public void addPrintJobListener(PrintJobListener listener)

この印刷ジョブ時に発生するイベントのリスナーを登録します。リスナーが null の場合、例外はスローされず、アクションは実行されません。リスナーが登録済みの場合は、再度登録されます。

パラメータ:

listener - リスナーインタフェースを実装するオブジェクト

関連項目:

removePrintJobListener(javax.print.event.PrintJobListener)

removePrintJobListener

public void removePrintJobListener(PrintJobListener listener)

この印刷ジョブからリスナーを削除します。引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。リスナーが null の場合、例外はスローされず、アクションは実行されません。リスナーが複数回登録されている場合、登録の 1 つだけが削除されます。

パラメータ:

listener - リスナーインタフェースを実装するオブジェクト

関連項目:

addPrintJobListener(javax.print.event.PrintJobListener)

addPrintJobAttributeListener

public void addPrintJobAttributeListener(PrintJobAttributeListener listener,
                                         PrintJobAttributeSet attributes)

指定された属性の変更用のリスナーを登録します。リスナーが null の場合、例外はスローされず、アクションは実行されません。このジョブが報告する属性更新を判別するため、クライアントは getAttributes()/ を呼び出して、リスナーに報告するような関心のあるサブセットを識別できます。特定のジョブ属性の変更更新を期待しているクライアントは、該当するセットであることを確認する必要があります。ただし、属性の更新は、実際に変更が行われ、ジョブがそれを検出した場合だけに実行されます。更新はまた、ジョブによるバッチ処理の対象になる場合があります。印刷ジョブの処理で発生するオーバーヘッドを最小限に抑えるため、変更が行われる可能性の高い属性のサブセットだけで待機を行うことをお勧めします。指定されたセットが空の場合、属性の更新はリスナーに報告されません。属性セットが null の場合、ジョブがサポートするすべての動的属性で待機することを意味します。このため、ジョブが属性更新を 1 つも報告できない場合、更新通知は一切行われません。 リスナーが登録済みの場合、再度登録されます。

パラメータ:

listener - リスナーインタフェースを実装するオブジェクト

attributes - ジョブによって決定された待機対象の属性、または変更可能なすべての属性を意味する null

関連項目:

removePrintJobAttributeListener(javax.print.event.PrintJobAttributeListener)

removePrintJobAttributeListener

public void removePrintJobAttributeListener(PrintJobAttributeListener listener)

この印刷ジョブから属性リスナーを削除します。引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。リスナーが null の場合、例外はスローされず、アクションは実行されません。リスナーが複数回登録されている場合 (それが異なる属性セットに対してであっても)、どのリスナーが削除されるかは保証されません。

パラメータ:

listener - リスナーインタフェースを実装するオブジェクト

関連項目:

addPrintJobAttributeListener(javax.print.event.PrintJobAttributeListener, javax.print.attribute.PrintJobAttributeSet)

print

public void print(Doc doc,
                  PrintRequestAttributeSet attributes)
           throws PrintException

ドキュメントを指定されたジョブ属性で印刷します。このメソッドは、指定された印刷ジョブごとに一度だけ呼び出す必要があります。このメソッドを再度呼び出しても、新規ジョブがプリンタにスプールされることはありません。サービス実装は、サービスの割り込みおよび復元用のポリシーを定義します。印刷メソッドの復帰時に、異なるスレッドで印刷が非同期に発生したなどの理由で、印刷が完了していない場合があります。このため、成功または失敗を監視するアプリケーションクライアントを PrintJobListener に登録する必要があります。

印刷サービスの実装者は、クライアント doc から取得したすべての印刷データストリーム (Reader または InputStream 実装) を閉じる必要があります。堅牢なクライアントの中には、これを検証するものもあります。DocFlavor を出力できない場合、常に例外が生成されます。

パラメータ:

doc - 印刷するドキュメント。この PrintJob がサポートするフレーバでなければならない

attributes - この印刷ジョブに適用するジョブ属性。このパラメータが null の場合、デフォルト属性が使用される

例外:

PrintException - 例外は、その原因をより厳密に記述する次のインタフェースを実装することもできる

• FlavorException -- この印刷ジョブがサポートしないフレーバをドキュメントが保持する場合
• AttributeException -- この印刷ジョブでは 1 つまたは複数の属性が有効でない場合