モジュール java.desktop

クラス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)
      指定された整数値を使用して新しいジョブ状態理由列挙値を構築します。
    • フィールドの詳細

      • 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に変わる場合もあります。これは実装またはジョブ・スケジューリング・ポリシー、あるいはその両方で決定されます。
      • 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
        戻り値:
        属性カテゴリの名前