javax.print.attribute.standard

Class JobHoldUntil

java.lang.Object

javax.print.attribute.DateTimeSyntax

javax.print.attribute.standard.JobHoldUntil

All Implemented Interfaces:

Serializable ， Cloneable ， Attribute ， PrintJobAttribute ， PrintRequestAttribute

public final class JobHoldUntil
extends DateTimeSyntax
implements PrintRequestAttribute, PrintJobAttribute

JobHoldUntil类是一个打印属性类，一个日期时间属性，用于指定作业必须成为打印候选者的确切日期和时间。

如果此属性的值指定将来的日期时间，则打印机应将作业JobStateReasons属性的值为884981419565的JOB_HOLD_UNTIL_SPECIFIED值添加到作业的JobStateReasons属性中，必须将作业移动到PENDING_HELD状态，并且不得安排作业进行打印，直到指定的日期时间到达。

当指定的日期时间到达时，打印机必须从作业的JobStateReasons属性（如果存在）中删除JOB_HOLD_UNTIL_SPECIFIED的值88498141967878。 如果没有其他工作状态原因使作业保持在PENDING_HELD状态，则打印机必须将作业视为处理候选项，将作业移动到PENDING状态。

如果指定的日期时间已经过去，作业必须是立即处理的候选人。 因此，使作业立即成为处理候选者的一种方法是指定如下构造的JobHoldUntil属性（表示1970年1月1日，00:00:00 GMT的日期时间）：

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

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

构建从小时当年不同的值，月，日，分钟，等一JobHoldUntil属性，使用Calendar对象构造一个Date对象，然后使用Date对象构造JobHoldUntil属性。 要转换JobHoldUntil属性分开的年，月，日，小时，分钟的值，依此类推，创建一个Calendar对象，并将其设置为Date从JobHoldUntil属性。

IPP兼容性：虽然IPP支持指定为关键字的“job-hold-until”属性，但IPP目前不支持将“job-hold-until”属性指定为日期和时间。 然而，日期和时间可以转换为标准IPP关键字之一，精度有些损失; 例如，当天日期和当地时间下午9:00的JobHoldUntil值可能会转换为标准IPP关键字“夜”。 getName()返回的类别名称提供IPP属性名称。

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
JobHoldUntil(Date dateTime) 构建一个新的作业保持，直到date-time属性与给定的Date值。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object object) 返回此作业是否保持，直到attribute等同于传入的对象。
类<? extends Attribute>	getCategory() 获取要用作此打印属性值的“类别”的打印属性类。
String	getName() 获取此属性值是一个实例的类别的名称。

Methods inherited from class javax.print.attribute.DateTimeSyntax

getValue, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造方法详细信息

JobHoldUntil

public JobHoldUntil(Date dateTime)

构造一个新的作业保持，直到date-time属性与给定的Date值。

参数

dateTime - Date的价值。

异常

NullPointerException - （未选中的异常）如果 dateTime为空，则抛出。

方法详细信息

equals

public boolean equals(Object object)

返回此作业是否保持，直到attribute等同于传入的对象。 要相等的，所有以下条件必须为真：

1. object不为空。
2. object是JobHoldUntil类的一个实例。
3. 这项工作按住，直到属性的Date值和object的Date值相等。

重写：

equals在类别 DateTimeSyntax

参数

object - 要比较的对象。

结果

如果 object相当于此作业保持，直到属性为True，否则为false。

另请参见：

Object.hashCode() ， HashMap

getCategory

public final 类<? extends Attribute> getCategory()

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

对于JobHoldUntil类，该类别是JobHoldUntil类。

Specified by:

getCategory在接口 Attribute

结果

打印属性类（category），一个类别为java.lang.Class的实例。

getName

public final String getName()

获取此属性值是一个实例的类别的名称。

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

Specified by:

getName在界面 Attribute

结果

属性类别名称。