模块 java.desktop
包 javax.print.attribute.standard

类 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 状态来将该作业视为处理的候选对象。

如果指定的日期时间已经过去，则作业必须立即成为处理的候选对象。因此，使作业立即成为处理候选对象的一种方法是指定一个像这样构造的 JobHoldUntil 属性（表示日期时间为格林威治标准时间 1970 年 1 月 1 日 00:00:00）：

   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 关键字之一，但会损失一些精度；例如，具有今天日期和当地时间晚上 9:00 的 JobHoldUntil 值可能会转换为标准 IPP 关键字“night”。 getName() 返回的类别名称给出了 IPP 属性名称。

参见：

  • 构造方法详细信息

    • JobHoldUntil

      public JobHoldUntil(Date  dateTime)
      使用给定的 Date 值构造一个新的作业保留直到日期时间属性。
      参数：
      dateTime - Date 值
      抛出：
      NullPointerException - 如果 dateTime 是 null

  • 方法详情

    • equals

      public boolean equals(Object  object)
      返回此作业是否保持直到属性等同于传入的对象。要等效，必须满足以下所有条件：
      1. object 不是 null。
      2. object 是类 JobHoldUntil 的实例。
      3. 这项工作一直持续到属性的 Date 值和 object 的 Date 值相等为止。
      重写：
      equals 在类 DateTimeSyntax 中
      参数：
      object - Object 比较
      返回：
      true 如果 object 等同于此作业 hold until 属性，false 否则
      参见：

    • 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 中
      返回：
      属性类别名称