- 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
属性には、印刷ジョブのステータスに関連するJobStateReasonオブジェクトがまったく含まれない場合もあり、1つ以上含まれる場合もあります。 プリンタは印刷ジョブのJobStateReasonオブジェクトに対応する条件がtrueになったときに、JobStateReasonオブジェクトを印刷ジョブのJobStateReasons
属性に追加し、falseになったときにこのオブジェクトを削除します。印刷ジョブ全体のJobState
の変更とは無関係にこの処理が行われます。IPP互換性:
getName()
によって返されるカテゴリ名はIPP属性の名前です。 列挙の整数値はIPP列挙型値です。toString()
メソッドは、属性値のIPP文字列表現を返します。- 関連項目:
- 直列化された形式
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static JobStateReason
ABORTED_BY_SYSTEM
ジョブがシステム側で中止されました。static JobStateReason
COMPRESSION_ERROR
ドキュメント・データの圧縮解除中にプリンタがエラーを検出したため、ジョブがシステム側で中止されました。static JobStateReason
DOCUMENT_ACCESS_ERROR
参照で渡されたドキュメント、つまりURLとして表された印刷データ・オブジェクトにアクセスできませんでした。static JobStateReason
DOCUMENT_FORMAT_ERROR
ドキュメント・データの処理中にプリンタがエラーを検出したため、ジョブがシステム側で中止されました。static JobStateReason
JOB_CANCELED_AT_DEVICE
ジョブが未確認のローカル・ユーザー、つまりデバイスのコンソールからログインしたユーザーによって取り消されました。static JobStateReason
JOB_CANCELED_BY_OPERATOR
ジョブはoperator、つまりローカルまたはリモートのどちらかでoperator権限を持つユーザーによって取り消されました。static JobStateReason
JOB_CANCELED_BY_USER
ジョブは所有者、つまり認証IDが印刷ジョブを生成した発生元のユーザーと一致するユーザー、またはジョブ所有者のセキュリティ・グループのメンバーなどの、一定の権限を持つエンド・ユーザーによって取り消されました。static JobStateReason
JOB_COMPLETED_SUCCESSFULLY
ジョブが正常に完了しました。static JobStateReason
JOB_COMPLETED_WITH_ERRORS
ジョブは完了していますがエラーが(そしておそらく警告も)出されています。static JobStateReason
JOB_COMPLETED_WITH_WARNINGS
ジョブは完了していますが警告が出されています。static JobStateReason
JOB_DATA_INSUFFICIENT
プリンタ上に印刷ジョブが生成されていますが、ジョブの状態をPROCESSINGに変更するためには、さらに印刷データが必要です。static JobStateReason
JOB_HOLD_UNTIL_SPECIFIED
ジョブのJobHoldUntil
属性の値が未来の日付と時刻で指定されました。static JobStateReason
JOB_INCOMING
プリンタ上に印刷ジョブが生成されていますが、すべての印刷データへのアクセス、またはすべての印刷データの受け取りが終了していません。static JobStateReason
JOB_INTERPRETING
ジョブの状態はPROCESSINGであり、より具体的にはプリンタがドキュメント・データを解釈中です。static JobStateReason
JOB_OUTGOING
プリンタがジョブを出力デバイスに転送しています。static JobStateReason
JOB_PRINTING
出力デバイスが媒体をマーキングしています。static JobStateReason
JOB_QUEUED
ジョブの状態はPROCESSINGであり、より具体的にはプリンタがドキュメント・データをキューに送信中です。static JobStateReason
JOB_QUEUED_FOR_MARKER
ジョブの状態がPENDING_HELD、PENDING、またはPROCESSINGのいずれかであり、より具体的には、ドキュメントに対してマーキングのために十分な処理がプリンタで完了し、ジョブがマーカーを待っている状態です。static JobStateReason
JOB_RESTARTABLE
このジョブは削除されずに残っており、現在再開が可能です。static JobStateReason
JOB_TRANSFORMING
ジョブの状態はPROCESSINGであり、より具体的にはプリンタがドキュメント・データを解釈し、別の形態の電子情報を生成中です。static JobStateReason
PRINTER_STOPPED
プリンタのPrinterState
属性の値はSTOPPEDです。static JobStateReason
PRINTER_STOPPED_PARTLY
プリンタのPrinterStateReasons
属性の値にSTOPPED_PARTLYのPrinterStateReason
値が含まれています。static JobStateReason
PROCESSING_TO_STOP_POINT
要求側がジョブを取り消したか、またはプリンタがジョブを中止しましたが、指定された停止ポイントに到達するまで、またはジョブの終了およびクリーンアップが完了するまで、プリンタ側で何らかのアクションが実行されています。static JobStateReason
QUEUED_IN_DEVICE
ジョブがステータスを返すことのできないデバイスまたは印刷システムに転送されました。static JobStateReason
RESOURCES_ARE_NOT_READY
媒体、フォント、リソース・オブジェクトなどの、ジョブが必要とするリソースの少なくとも1つが、ジョブが印刷される予定になっているプリンタ上で準備できていません。static JobStateReason
SERVICE_OFF_LINE
プリンタがオフラインであり、ジョブを受け付けません。static JobStateReason
SUBMISSION_INTERRUPTED
ジョブが何らかの予期しないエラーで完全に送信されませんでした。static JobStateReason
UNSUPPORTED_COMPRESSION
ドキュメント・データの圧縮解除中に、圧縮形式がプリンタでサポートされていないものであると判定されたため、ジョブがシステム側で中止されました。static JobStateReason
UNSUPPORTED_DOCUMENT_FORMAT
ドキュメント・データの形式(doc flavor)をプリンタがサポートしていないため、ジョブはシステム側で中止されました。
-
コンストラクタのサマリー
コンストラクタ 修飾子 コンストラクタ 説明 protected
JobStateReason(int value)
指定された整数値を使用して新しいジョブ状態理由列挙値を構築します。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 Class<? extends Attribute>
getCategory()
この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。protected EnumSyntax[]
getEnumValueTable()
JobStateReasonクラスの列挙値テーブルを返します。String
getName()
属性値がインスタンスとなるカテゴリの名前を返します。protected String[]
getStringTable()
JobStateReasonクラスの文字列テーブルを返します。-
クラス javax.print.attribute.EnumSyntaxから継承されたメソッド
clone, getOffset, getValue, hashCode, readResolve, toString
-
-
-
-
フィールドの詳細
-
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として表された印刷データ・オブジェクトにアクセスできませんでした。 この理由は、ファイルが存在しない、あるいはアクセス制御の問題でアクセスが拒否されたなどの、ファイル・アクセスに関するすべての問題に対応するためのものです。 プリンタ側でジョブを中止し、ジョブの状態をABORTEDに変更する場合と、アクセス可能なドキュメントをすべて印刷し、ジョブの状態をCOMPLETEDに変更し、ジョブのJobStateReasons
属性にCOMPLETED_WITH_ERRORS理由を追加する場合があります。どちらになるかは実装のポリシーまたはサイトのポリシー、あるいはその両方で決定されます。 URLとして表される印刷データ・オブジェクトを持つドキュメント・フレーバをプリンタがサポートする場合、この値がサポートされている必要があります。
-
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
出力デバイスが媒体をマーキングしています。 この値は(1)マーキングが実際に行われていなくても、あたかも行われているように見せるとき、または(2)ジョブの取り消しまたは中断時に、ジョブがPROCESSINGのままで残り、マーキングが停止されず、印刷データまたはページ・カウントが増大し続けているときに、処理時間が非常に長くなるプリンタに対して有効です。
-
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に変更されたか、または(3)システム側で中止され、ユーザーまたはoperatorがマニュアルでジョブを再開できるように、状態が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
属性に追加します。
-
-
メソッドの詳細
-
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
- 戻り値:
- 印刷属性クラス(カテゴリ)、
java.lang.Class
クラスのインスタンス。
-
-