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

クラスJobHoldUntil

  • すべての実装されたインタフェース:
    Serializable, Cloneable, Attribute, PrintJobAttribute, PrintRequestAttribute
    public final class JobHoldUntil
extends DateTimeSyntax
implements PrintRequestAttribute, PrintJobAttribute
    クラスJobHoldUntilは、ジョブが印刷候補になる必要がある正確な日時を指定する出力属性クラス(日時属性)です。

    この属性の値に将来の日時が指定されている場合、プリンタはジョブのJobStateReasons属性にJOB_HOLD_UNTIL_SPECIFIEDのJobStateReason値を追加し、ジョブをPENDING_HELD状態に移行する必要があり、指定された日時が到着するまでジョブを印刷するようにスケジュールしないでください。

    指定された日時が到着すると、プリンタはジョブのJobStateReasons属性(存在する場合)からJOB_HOLD_UNTIL_SPECIFIEDのJobStateReason値を削除する必要があります。 ジョブをPENDING_HELD状態に維持する他のジョブ状態理由がない場合、プリンタはジョブをPENDING状態に移行して、そのジョブを処理候補とみなす必要があります。

    指定された日付と時刻をすでに過ぎた場合、ジョブはただちに処理対象の候補にしなければいけません。 したがって、ジョブをすぐに処理候補にする方法の1つは、次のように構築されたJobHoldUntil属性を指定することです(1970年1月1日、00:00:00 GMTの日時を示します)。 

         JobHoldUntil immediately = new JobHoldUntil (new Date (0L));

    クライアントが印刷要求でこの属性を指定せず、プリンタがこの属性をサポートする場合、プリンタはジョブ発行時にその(実装に依存する)デフォルトのJobHoldUntil値を使用する必要があります(ジョブ処理時に必要に応じて使用されるほとんどのジョブ・テンプレート属性とは異なり)。

    年、月、日、時間、分などの個別の値からJobHoldUntil属性を構築するには、Calendarオブジェクトを使用してDateオブジェクトを構築してから、Dateオブジェクトを使用してJobHoldUntil属性を構築します。 JobHoldUntil属性を年、月、日、時間、分などの個別の値に変換するには、Calendarオブジェクトを作成し、JobHoldUntil属性からDateに設定します。

    IPP互換性: IPPはキーワードとして指定された「job-hold-until」属性をサポートしますが、IPPは日付と時間として指定された「job-hold-until」属性を現在サポートしていません。 ただし、日付と時刻は、精度が失われる標準のIPPキーワードの1つに変換できます。たとえば、今日の日付と現地時間の9:00pmのJobHoldUntil値は、標準のIPPキーワードnightに変換できます。 getName()によって返されるカテゴリ名はIPP属性の名前を示します。

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

    • コンストラクタの詳細

      • JobHoldUntil

        public JobHoldUntil​(Date dateTime)
        指定されたDateの値で、新しいジョブ保留日時属性を構築します。
        パラメータ:
        dateTime - Date値
        例外:
        NullPointerException - dateTimeがnullの場合

    • メソッドの詳細

      • equals

        public boolean equals​(Object object)
        このジョブ保留属性がオブジェクトに渡された属性と等しいかどうかを返します。 次の条件がすべてtrueの場合に同等とみなされます。
        1. objectはnullではありません。
        2. objectは、クラスJobHoldUntilのインスタンスです。
        3. このジョブ保留属性のDate値とobjectのDate値が等しい。
        オーバーライド:
        equals、クラスDateTimeSyntax
        パラメータ:
        object - 比較するObject
        戻り値:
        objectが属性までこのジョブ保持と同等である場合はtrue、そうでない場合はfalse
        関連項目:
        Object.hashCode()、HashMap

      • getCategory

        public final Class<? extends Attribute> getCategory()
        この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

        クラスJobHoldUntilの場合、カテゴリはクラスJobHoldUntil自体です。

        定義:
        getCategory、インタフェースAttribute
        戻り値:
        属性クラス(カテゴリ)の出力、クラスjava.lang.Classのインスタンス

      • getName

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

        クラスJobHoldUntilの場合、カテゴリ名は"job-hold-until"です。

        定義:
        getName、インタフェースAttribute
        戻り値:
        属性カテゴリ名