JobStateReason (Java Platform SE 8)

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

クラス 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として表された印刷データ・オブジェクトにアクセスできませんでした。この理由は、ファイルが存在しない、あるいはアクセス制御の問題でアクセスが拒否されたなどの、ファイル・アクセスに関するすべての問題に対応するためのものです。プリンタ側でジョブを中止し、ジョブの状態を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属性に追加します。
- コンストラクタの詳細
  - 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
    
    戻り値:
    
    印刷属性クラス(カテゴリ)、java.lang.Classクラスのインスタンス。
  - getName
```
public final String getName()
```
    属性値がインスタンスとなるカテゴリの名前を返します。
    JobStateReasonクラスおよびベンダー定義のサブクラスの場合、カテゴリ名は"job-state-reason"です。
    
    定義:
    
    getName、インタフェース: Attribute
    
    戻り値:
    
    属性カテゴリの名前

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスJobStateReason

フィールドのサマリー

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

メソッドのサマリー

クラス javax.print.attribute.EnumSyntaxから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

JOB_INCOMING

JOB_DATA_INSUFFICIENT

DOCUMENT_ACCESS_ERROR

SUBMISSION_INTERRUPTED

JOB_OUTGOING

JOB_HOLD_UNTIL_SPECIFIED

RESOURCES_ARE_NOT_READY

PRINTER_STOPPED_PARTLY

PRINTER_STOPPED

JOB_INTERPRETING

JOB_QUEUED

JOB_TRANSFORMING

JOB_QUEUED_FOR_MARKER

JOB_PRINTING

JOB_CANCELED_BY_USER

JOB_CANCELED_BY_OPERATOR

JOB_CANCELED_AT_DEVICE

ABORTED_BY_SYSTEM

UNSUPPORTED_COMPRESSION

COMPRESSION_ERROR

UNSUPPORTED_DOCUMENT_FORMAT

DOCUMENT_FORMAT_ERROR

PROCESSING_TO_STOP_POINT

SERVICE_OFF_LINE

JOB_COMPLETED_SUCCESSFULLY

JOB_COMPLETED_WITH_WARNINGS

JOB_COMPLETED_WITH_ERRORS

JOB_RESTARTABLE

QUEUED_IN_DEVICE

コンストラクタの詳細

JobStateReason

メソッドの詳細

getStringTable

getEnumValueTable

getCategory

getName