モジュール java.desktop
パッケージ javax.print.attribute.standard

クラスJobStateReason

  • すべての実装されたインタフェース:
    Serializable, Cloneable, Attribute
    public class JobStateReason
extends EnumSyntax
implements Attribute
    クラスJobStateReasonは、ジョブの現在の状態、つまりジョブのJobState属性の値を強化する情報に関する追加情報を提供する出力属性クラス(列挙)です。 クラスJobStateReasonは、標準のジョブ状態理由の値を定義します。 印刷サービスを実装する場合、通知する必要があるジョブ状態理由は特定の実装に適応するものだけです。

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

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

    関連項目:
    直列化された形式

    • フィールドの詳細

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

      • JOB_INTERPRETING

        public static final JobStateReason JOB_INTERPRETING
        ジョブはPROCESSING状態ですが、具体的にはプリンタiaがドキュメント・データを解釈しています。

      • 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)システムによって中止されて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
        このジョブは削除されずに残っており、現在再開が可能です。 ジョブのJobStateReasons属性にJOB_RESTARTABLEが含まれている場合、プリンタはそのジョブを再起動するリクエストを受け入れる必要があります。 ジョブの再開機能は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
        戻り値:
        属性カテゴリ名