モジュール java.desktop

パッケージ javax.print.attribute.standard

クラスJobStateReason

java.lang.Object

javax.print.attribute.EnumSyntax

javax.print.attribute.standard.JobStateReason

すべての実装されたインタフェース:

Serializable, Cloneable, Attribute

public class JobStateReason extends EnumSyntax implements Attribute

クラスJobStateReasonは、印刷属性クラス(列挙)で、ジョブの現在の状態に関する追加情報、つまりジョブのJobState属性の値を補強する情報を提供します。 クラスJobStateReasonは、標準ジョブ状態の理由値を定義します。 印刷サービスを実装する場合、通知する必要があるジョブ状態理由は特定の実装に適応するものだけです。

JobStateReasonのインスタンスは、印刷ジョブの属性セットに直接表示されません。 JobStateReasons属性が使用されます。 JobStateReasons属性には、印刷ジョブのステータスに関連するゼロ、1または複数のJobStateReasonオブジェクトが含まれます。 プリンタは、印刷ジョブのJobState全体が変更されたかどうかに関係なく、対応する条件がtrueになると、印刷ジョブのJobStateReasons属性にJobStateReasonオブジェクトを追加し、対応する条件がfalseになると、プリンタはJobStateReasonオブジェクトを再度削除します。

IPP互換性: getName()によって返されるカテゴリ名はIPP属性の名前です。 列挙の整数値はIPP列挙型値です。 toString()メソッドは、属性値のIPP文字列表現を返します。

関連項目:

• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final JobStateReason	ABORTED_BY_SYSTEM	ジョブがシステム側で中止されました。
static final JobStateReason	COMPRESSION_ERROR	ドキュメント・データの圧縮解除中にプリンタがエラーを検出したため、ジョブがシステム側で中止されました。
static final JobStateReason	DOCUMENT_ACCESS_ERROR	プリンタは、参照(すなわち、印刷データ表現オブジェクトは、URL)によって渡された1つ以上のドキュメントにアクセスできませんでした。
static final JobStateReason	DOCUMENT_FORMAT_ERROR	ドキュメント・データの処理中にプリンタがエラーを検出したため、ジョブがシステム側で中止されました。
static final JobStateReason	JOB_CANCELED_AT_DEVICE	ジョブが未確認のローカル・ユーザー、つまりデバイスのコンソールからログインしたユーザーによって取り消されました。
static final JobStateReason	JOB_CANCELED_BY_OPERATOR	ジョブはoperator、つまりローカルまたはリモートのどちらかでoperator権限を持つユーザーによって取り消されました。
static final JobStateReason	JOB_CANCELED_BY_USER	ジョブは所有者、つまり認証IDが印刷ジョブを生成した発生元のユーザーと一致するユーザー、またはジョブ所有者のセキュリティ・グループのメンバーなどの、一定の権限を持つエンド・ユーザーによって取り消されました。
static final JobStateReason	JOB_COMPLETED_SUCCESSFULLY	ジョブが正常に完了しました。
static final JobStateReason	JOB_COMPLETED_WITH_ERRORS	ジョブは完了していますがエラーが(そしておそらく警告も)出されています。
static final JobStateReason	JOB_COMPLETED_WITH_WARNINGS	ジョブは完了していますが警告が出されています。
static final JobStateReason	JOB_DATA_INSUFFICIENT	プリンタは印刷ジョブを作成しましたが、ジョブをPROCESSING状態に移行する前に、プリンタは追加の印刷データを必要としています。
static final JobStateReason	JOB_HOLD_UNTIL_SPECIFIED	ジョブのJobHoldUntil属性の値が未来の日付と時刻で指定されました。
static final JobStateReason	JOB_INCOMING	プリンタ上に印刷ジョブが生成されていますが、すべての印刷データへのアクセス、またはすべての印刷データの受け取りが終了していません。
static final JobStateReason	JOB_INTERPRETING	ジョブはPROCESSING状態にありますが、具体的にはプリンタが文書データを解釈しています。
static final JobStateReason	JOB_OUTGOING	プリンタがジョブを出力デバイスに転送しています。
static final JobStateReason	JOB_PRINTING	出力デバイスが媒体をマーキングしています。
static final JobStateReason	JOB_QUEUED	ジョブはPROCESSING状態ですが、具体的にはプリンタがドキュメント・データをキューに入れました。
static final JobStateReason	JOB_QUEUED_FOR_MARKER	ジョブはPENDING_HELD、PENDING、またはPROCESSING状態にありますが、具体的には、プリンタはマーキングを開始できる十分な文書処理を完了しており、ジョブはマーカーを待っています。
static final JobStateReason	JOB_RESTARTABLE	このジョブは削除されずに残っており、現在再開が可能です。
static final JobStateReason	JOB_TRANSFORMING	ジョブはPROCESSING状態にありますが、具体的にはプリンタが文書データを解釈して別の電子表現を生成しています。
static final JobStateReason	PRINTER_STOPPED	プリンタのPrinterState属性の値はSTOPPEDです。
static final JobStateReason	PRINTER_STOPPED_PARTLY	プリンタのPrinterStateReasons属性の値には、STOPPED_PARTLYのPrinterStateReason値が含まれます。
static final JobStateReason	PROCESSING_TO_STOP_POINT	要求側がジョブを取り消したか、またはプリンタがジョブを中止しましたが、指定された停止ポイントに到達するまで、またはジョブの終了およびクリーンアップが完了するまで、プリンタ側で何らかのアクションが実行されています。
static final JobStateReason	QUEUED_IN_DEVICE	ジョブがステータスを返すことのできないデバイスまたは印刷システムに転送されました。
static final JobStateReason	RESOURCES_ARE_NOT_READY	媒体、フォント、リソース・オブジェクトなどの、ジョブが必要とするリソースの少なくとも1つが、ジョブが印刷される予定になっているプリンタ上で準備できていません。
static final JobStateReason	SERVICE_OFF_LINE	プリンタがオフラインであり、ジョブを受け付けません。
static final JobStateReason	SUBMISSION_INTERRUPTED	ジョブが何らかの予期しないエラーで完全に送信されませんでした。
static final JobStateReason	UNSUPPORTED_COMPRESSION	ドキュメント・データの圧縮解除中に、圧縮形式がプリンタでサポートされていないものであると判定されたため、ジョブがシステム側で中止されました。
static final JobStateReason	UNSUPPORTED_DOCUMENT_FORMAT	ドキュメント・データの形式(doc flavor)をプリンタがサポートしていないため、ジョブはシステム側で中止されました。

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

コンストラクタ

修飾子	コンストラクタ	説明
protected	JobStateReason(int value)	指定された整数値を使用して新しいジョブ状態理由列挙値を構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
final Class<? extends Attribute>	getCategory()	この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
protected EnumSyntax[]	getEnumValueTable()	JobStateReasonクラスの列挙値表を返します。
final String	getName()	属性値がインスタンスとなるカテゴリの名前を返します。
protected String[]	getStringTable()	クラスJobStateReasonの文字列表を返します。

クラスjavax.print.attribute.EnumSyntaxで宣言されたメソッド

clone, getOffset, getValue, hashCode, readResolve, toString

クラスjava.lang.Objectで宣言されたメソッド

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

フィールド詳細

JOB_INCOMING

public static final JobStateReason JOB_INCOMING

プリンタ上に印刷ジョブが生成されていますが、すべての印刷データへのアクセス、またはすべての印刷データの受け取りが終了していません。

JOB_DATA_INSUFFICIENT

public static final JobStateReason JOB_DATA_INSUFFICIENT

プリンタは印刷ジョブを作成しましたが、ジョブをPROCESSING状態に移行する前に、プリンタは追加の印刷データを必要としています。 プリンタがすべてのデータを受信する前に処理を開始すると、プリンタはJOB_DATA_INSUFFICIENTの理由を取り除きますが、JOB_INCOMINGの理由は残ります。 すべてのデータを受信した後にプリンタが処理を開始すると、プリンタはJOB_DATA_INSUFFICIENTとJOB_INCOMINGの理由を同時に削除します。

DOCUMENT_ACCESS_ERROR

public static final JobStateReason DOCUMENT_ACCESS_ERROR

プリンタは、参照(すなわち、印刷データ表現オブジェクトは、URL)によって渡された1つ以上のドキュメントにアクセスできませんでした。 この理由は、ファイルが存在しないことや、アクセス制御の問題のためにアクセスが拒否されたことなど、ファイル・アクセスの問題を対象にしています。 プリンタがジョブを中断してジョブをABORTEDジョブ状態に移動するか、アクセス可能なすべてのドキュメントを出力してジョブをCOMPLETEDジョブ状態に移動し、COMPLETED_WITH_ERRORS理由をジョブのJobStateReasons属性に追加するかは、実装またはサイト・ポリシー(あるいはその両方)によって異なります。 この値は、プリンタがURL印刷データ表現オブジェクトを含むdocフレーバをサポートしている場合にサポートされる必要があります。

SUBMISSION_INTERRUPTED

public static final JobStateReason SUBMISSION_INTERRUPTED

ジョブが何らかの予期しないエラーで完全に送信されませんでした。 理由として考えられるのは、(1)ジョブがクライアントから完全に送信される前にプリンタがクラッシュした、(2)ドキュメント・データが完全にプリンタに転送される前に、プリンタまたはドキュメント転送メソッドで回復不可能な障害が発生した、(3)ジョブが完全に送信される前にクライアントがクラッシュした、などです。

JOB_OUTGOING

public static final JobStateReason JOB_OUTGOING

プリンタがジョブを出力デバイスに転送しています。

JOB_HOLD_UNTIL_SPECIFIED

public static final JobStateReason JOB_HOLD_UNTIL_SPECIFIED

ジョブのJobHoldUntil属性の値が未来の日付と時刻で指定されました。 この指定を変更するまでジョブは処理対象になりません。またジョブが保持されている理由はこれのみです。 JobHoldUntilジョブ・テンプレート属性がサポートされている場合にこの値がサポートされている必要があります。

RESOURCES_ARE_NOT_READY

public static final JobStateReason RESOURCES_ARE_NOT_READY

媒体、フォント、リソース・オブジェクトなどの、ジョブが必要とするリソースの少なくとも1つが、ジョブが印刷される予定になっているプリンタ上で準備できていません。 この状態がいつ検出されるかは実装によって異なり、ジョブの状態がACCEPTED、またはその後のPENDINGあるいはPROCESSINGの場合です。 ジョブは、実装および/またはジョブ・スケジューリング方針に応じて、現在の状態を維持するか、またはPENDING_HELD状態に移動することができます。

PRINTER_STOPPED_PARTLY

public static final JobStateReason PRINTER_STOPPED_PARTLY

プリンタのPrinterStateReasons属性の値には、STOPPED_PARTLYのPrinterStateReason値が含まれます。

PRINTER_STOPPED

public static final JobStateReason PRINTER_STOPPED

プリンタのPrinterState属性の値はSTOPPEDです。

JOB_INTERPRETING

public static final JobStateReason JOB_INTERPRETING

ジョブはPROCESSING状態にありますが、具体的にはプリンタが文書データを解釈しています。

JOB_QUEUED

public static final JobStateReason JOB_QUEUED

ジョブはPROCESSING状態ですが、具体的にはプリンタがドキュメント・データをキューに入れました。

JOB_TRANSFORMING

public static final JobStateReason JOB_TRANSFORMING

ジョブはPROCESSING状態にありますが、具体的にはプリンタが文書データを解釈して別の電子表現を生成しています。

JOB_QUEUED_FOR_MARKER

public static final JobStateReason JOB_QUEUED_FOR_MARKER

ジョブはPENDING_HELD、PENDING、またはPROCESSING状態にありますが、具体的には、プリンタはマーキングを開始できる十分な文書処理を完了しており、ジョブはマーカーを待っています。 ジョブを解放するために人間の介入を必要とするシステムでは、ジョブをPENDING_HELDジョブ状態に入れます。 マーカーを使用するジョブを自動的に選択するシステムでは、PENDINGジョブ状態にジョブを入れたり、実装に応じて、マーカーを待つ間ジョブをPROCESSINGジョブ状態に保ちます。 すべての実装では、マーキングが開始されたときにPROCESSING状態に(または)にジョブを入れます。

JOB_PRINTING

public static final JobStateReason JOB_PRINTING

出力デバイスが媒体をマーキングしています。 This value is useful for printers which spend a great deal of time processing (1) when no marking is happening and then want to show that marking is now happening or (2) when the job is in the process of being canceled or aborted while the job remains in the PROCESSING state, but the marking has not yet stopped so that impression or sheet counts are still increasing for the job.

JOB_CANCELED_BY_USER

public static final JobStateReason JOB_CANCELED_BY_USER

ジョブは所有者、つまり認証IDが印刷ジョブを生成した発生元のユーザーと一致するユーザー、またはジョブ所有者のセキュリティ・グループのメンバーなどの、一定の権限を持つエンド・ユーザーによって取り消されました。 この値はサポートする必要があります。

JOB_CANCELED_BY_OPERATOR

public static final JobStateReason JOB_CANCELED_BY_OPERATOR

ジョブはoperator、つまりローカルまたはリモートのどちらかでoperator権限を持つユーザーによって取り消されました。 セキュリティ・ポリシーですべてのユーザーがすべてのユーザーのジョブを取消し可能になっている場合は、ジョブがその所有者以外のユーザーによって削除された場合に、この値を使用できます。 このようなセキュリティ・ポリシーの下では、事実上すべてのユーザーがジョブの取消しに関してoperator権限を持つことになります。 ジョブの所有者以外のユーザーによるジョブの取消しが実装で許可されている場合は、この値をサポートする必要があります。

JOB_CANCELED_AT_DEVICE

public static final JobStateReason JOB_CANCELED_AT_DEVICE

ジョブが未確認のローカル・ユーザー、つまりデバイスのコンソールからログインしたユーザーによって取り消されました。 この値はコンソールからのジョブ取消しが実装でサポートされている場合にサポートする必要があります。

ABORTED_BY_SYSTEM

public static final JobStateReason ABORTED_BY_SYSTEM

ジョブがシステム側で中止されました。 ジョブ(1)が中断されているか、(2)がシステムによって中止されてABORTED状態になっているか、またはPENDING_HELD状態に置かれているため、ユーザーまたはオペレータが手動で試すことができます再び仕事。 この値はサポートする必要があります。

UNSUPPORTED_COMPRESSION

public static final JobStateReason UNSUPPORTED_COMPRESSION

ドキュメント・データの圧縮解除中に、圧縮形式がプリンタでサポートされていないものであると判定されたため、ジョブがシステム側で中止されました。 Compressionは必須ドキュメント記述属性であるため、この値がサポートされる必要があります。

COMPRESSION_ERROR

public static final JobStateReason COMPRESSION_ERROR

ドキュメント・データの圧縮解除中にプリンタがエラーを検出したため、ジョブがシステム側で中止されました。 プリンタがこの理由を通知すると、文書データはすでにUNSUPPORTED_COMPRESSIONジョブ状態の理由につながったはずのテストに合格しています。

UNSUPPORTED_DOCUMENT_FORMAT

public static final JobStateReason UNSUPPORTED_DOCUMENT_FORMAT

ドキュメント・データの形式(doc flavor)をプリンタがサポートしていないため、ジョブはシステム側で中止されました。 MIMEタイプが"application/octet-stream"のドキュメント・フレーバをクライアントが指定している場合、ドキュメント・データの実際の形式をプリンタが自動検知できなければ、たとえ明示的に指定されていればサポートしている形式でも、ジョブは中止されることがあります。 ドキュメント・フレーバは各ドキュメントに必ず指定する必要があるため、この値はサポートする必要があります。

DOCUMENT_FORMAT_ERROR

public static final JobStateReason DOCUMENT_FORMAT_ERROR

ドキュメント・データの処理中にプリンタがエラーを検出したため、ジョブがシステム側で中止されました。 プリンタがこの理由を通知すると、文書データはすでにUNSUPPORTED_DOCUMENT_FORMATジョブ状態の理由につながったはずのテストに合格しています。

PROCESSING_TO_STOP_POINT

public static final JobStateReason PROCESSING_TO_STOP_POINT

要求側がジョブを取り消したか、またはプリンタがジョブを中止しましたが、指定された停止ポイントに到達するまで、またはジョブの終了およびクリーンアップが完了するまで、プリンタ側で何らかのアクションが実行されています。

ジョブがPROCESSINGまたはPROCESSING_STOPPEDジョブ状態でジョブを取消するために測定可能な時間が必要な場合、プリンタはこの理由を使用して、ジョブがPROCESSINGまたはPROCESSING_STOPPED状態のままジョブで何らかのアクションを実行していることを示す必要があります。 すべてのジョブのジョブ記述属性が増分を停止すると、プリンタはジョブをPROCESSING状態からCANCELEDまたはABORTEDジョブ状態に移動します。

SERVICE_OFF_LINE

public static final JobStateReason SERVICE_OFF_LINE

プリンタがオフラインであり、ジョブを受け付けません。 すべてのPENDINGジョブは、PENDING_HELD状態になります。 サービスまたはドキュメント変換の入力機能が完全に動作していない場合、または故障している場合がこれに該当します。

JOB_COMPLETED_SUCCESSFULLY

public static final JobStateReason JOB_COMPLETED_SUCCESSFULLY

ジョブが正常に完了しました。 この値はサポートする必要があります。

JOB_COMPLETED_WITH_WARNINGS

public static final JobStateReason JOB_COMPLETED_WITH_WARNINGS

ジョブは完了していますが警告が出されています。 警告が検出される実装の場合はこの値をサポートする必要があります。

JOB_COMPLETED_WITH_ERRORS

public static final JobStateReason JOB_COMPLETED_WITH_ERRORS

ジョブは完了していますがエラーが(そしておそらく警告も)出されています。 エラーが検出される実装の場合はこの値をサポートする必要があります。

JOB_RESTARTABLE

public static final JobStateReason JOB_RESTARTABLE

このジョブは削除されずに残っており、現在再開が可能です。 JOB_RESTARTABLEがジョブのJobStateReasons属性に含まれている場合、プリンタはそのジョブを再起動するリクエストを受け入れる必要があります。 ジョブの再開機能はJavaの印刷サービスAPIには現在は用意されていません。

QUEUED_IN_DEVICE

public static final JobStateReason QUEUED_IN_DEVICE

ジョブがステータスを返すことのできないデバイスまたは印刷システムに転送されました。 プリンタは、ジョブのJobState属性をCOMPLETEDに設定し、QUEUED_IN_DEVICEの理由をジョブのJobStateReasons属性に追加して、プリンタにジョブに関する追加情報がなく、それ以上の情報がないことを示します。

コンストラクタの詳細

JobStateReason

protected JobStateReason(int value)

指定された整数値を使用して新しいジョブ状態理由列挙値を構築します。

パラメータ:

value - 整数値

メソッドの詳細

getStringTable

protected String[] getStringTable()

クラスJobStateReasonの文字列表を返します。

オーバーライド:

getStringTable、クラスEnumSyntax

戻り値:

文字列テーブル

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

JobStateReasonクラスの列挙値表を返します。

オーバーライド:

getEnumValueTable、クラスEnumSyntax

戻り値:

値テーブル

getCategory

public final Class<? extends Attribute> getCategory()

この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

クラスJobStateReasonおよびベンダー定義のサブクラスの場合、カテゴリはクラスJobStateReason自体です。

定義:

getCategory、インタフェースAttribute

戻り値:

印刷属性クラス(category)、クラスjava.lang.Classのインスタンス

getName

public final String getName()

属性値がインスタンスとなるカテゴリの名前を返します。

クラスJobStateReasonおよびベンダー定義のサブクラスでは、カテゴリ名は"job-state-reason"です。

定義:

getName、インタフェースAttribute

戻り値:

属性カテゴリ名