クラスJobHoldUntil

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

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

指定された日時が到着すると、プリンタはジョブのJobStateReasons属性からJOB_HOLD_UNTIL_SPECIFIEDのJobStateReason値を削除する必要があります(存在する場合)。 ジョブをPENDING_HELD状態に保つ他のジョブ状態の理由がない場合、プリンタは、ジョブをPENDING状態に移動させることによってジョブを処理の候補と見なさなければなりません。

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

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

クライアントが印刷リクエストでこの属性を提供せず、プリンタがこの属性をサポートしている場合、プリンタはジョブ送信時間(ジョブ処理時に必要に応じて使用されるほとんどのジョブ・テンプレート属性とは異なります)で(implementation-dependent)デフォルトJobHoldUntil値を使用する必要があります。

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

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

関連項目:

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

    コンストラクタ
    コンストラクタ
    説明
    JobHoldUntil(Date dateTime)
    指定されたDateの値で、新しいジョブ保留日時属性を構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    boolean
    equals(Object object)
    このジョブ保留属性がオブジェクトに渡された属性と等しいかどうかを返します。
    final Class<? extends Attribute>
    getCategory()
    この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
    final String
    getName()
    属性値がインスタンスとなるカテゴリの名前を返します。

    クラスで宣言されたメソッド DateTimeSyntax

    getValue, hashCode, toString
    修飾子と型
    メソッド
    説明
    Date
    getValue()
    この日付と時刻属性のjava.util.Dateの値を返します。
    int
    hashCode()
    日付と時刻属性のハッシュ・コードの値を返します。
    String
    toString()
    日付と時刻属性に対応する文字列値を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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
      戻り値:
      true objectがこのジョブの保留属性に相当する場合はfalse、それ以外の場合はfalse
      関連項目:

    • getCategory

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

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

      定義:
      getCategory、インタフェースAttribute
      戻り値:
      印刷属性クラス(category)、クラスjava.lang.Classのインスタンス

    • getName

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

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

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