Java javax.print.attribute.standard 类 JobHoldUntil（JDK5）

所有类

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 属性（表示的日期-时间为 GMT 时间 1970 年 1 月 1 日，00:00:00）：

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

如果客户机没有在 Print Request 中提供此属性，且打印机支持此属性，则打印机必须使用其（与实现有关的）默认的作业提交时的 JobHoldUntil 值（与作业处理时必要时所使用的大多数作业模板属性不同）。

要从独立的 year、month、day、hour、minute 等值构造 JobHoldUntil 属性，请使用 Calendar 对象来构造一个 Date 对象，然后使用该 Date 对象来构造 JobHoldUntil 属性。要将 JobHoldUntil 属性转换为独立的 year、month、day、hour、minute 等值，请创建一个 Calendar 对象，并根据 JobHoldUntil 属性将它设置为 Date。

IPP Compatibility: 虽然 IPP 支持指定为关键字的 "job-hold-until" 属性，但此处 IPP 不支持指定为日期和时间的 "job-hold-until" 属性。但是，可以在丢失一定精度的情况下，将日期和时间转换为标准 IPP 关键字之一；例如，日期为今天、时间为本地时间 9:00pm 的 JobHoldUntil 值可以转换为标准的 IPP 关键字 "night"。getName() 所返回的类别名称给出了 IPP 属性名称。

另请参见：

序列化表格

JobHoldUntil

public JobHoldUntil(Date dateTime)

构造具有给定 Date 值新 JobHoldUntil 属性。

参数：

dateTime - Date 值。

抛出：

NullPointerException（未检查的异常）如果 - dateTime 为 null，则抛出此异常。

equals

public boolean equals(Object object)

返回此 JobHoldUntil 属性是否等于传入的对象。若要相等，以下所有条件都必须为 true：

1. object 不为 null。
2. object 为 JobHoldUntil 类的实例。
3. 此 JobHoldUntil 属性的 Date 值与 object 的 Date 值相等。

覆盖：

类 DateTimeSyntax 中的 equals

参数：

object - 要比较的 Object。

返回：

如果 object 等于此 JobHoldUntil 属性，则返回 true，否则返回 false。

另请参见：

Object.hashCode(), Hashtable

getCategory

public final Class<? extends Attribute> getCategory()

获取将被用作此打印属性值的“类别”的打印属性类。

对于 JobHoldUntil 类，类别为 JobHoldUntil 类本身。

指定者：

接口 Attribute 中的 getCategory

返回：

打印属性类（类别），它是 java.lang.Class 类的实例。

getName

public final String getName()

获取类别名称，此属性值为该类别的实例。

对于 JobHoldUntil 类，类别名称为 "job-hold-until"。

指定者：

接口 Attribute 中的 getName

返回：

属性类别名称。