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

Class JobHoldUntil

  • 实现的所有接口
    Serializable ， Cloneable ， Attribute ， PrintJobAttribute ， PrintRequestAttribute 
    public final class JobHoldUntil
extends DateTimeSyntax
implements PrintRequestAttribute, PrintJobAttribute
    类JobHoldUntil是打印属性类，即日期时间属性，它指定作业必须成为打印候选者的确切日期和时间。

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

    当指定的日期-时间到来时，打印机必须删除JobStateReason价值JOB_HOLD_UNTIL_SPECIFIED从作业的JobStateReasons属性，如果存在的话。 如果没有其他作业状态原因使作业保持在PENDING_HELD状态，则打印机必须将作业视为处理候选者，方法是将作业移至PENDING状态。

    如果已经过了指定的日期时间，则该作业必须是立即处理的候选者。 因此，使作业立即成为处理候选者的一种方法是指定JobHoldUntil构造的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关键字“night”。 getName()返回的类别名称给出了IPP属性名称。

    另请参见：
    Serialized Form

    • 构造方法详细信息

      • JobHoldUntil

        public JobHoldUntil​(Date dateTime)
        使用给定的Date值构造一个新的作业保持到date-time属性。
        参数
        dateTime - Date价值
        异常
        NullPointerException - 如果 dateTime是 null

    • 方法详细信息

      • equals

        public boolean equals​(Object object)
        返回此属性是否保持，直到属性等效于传入的对象。 为了等效，所有以下条件必须为真：
        1. object不是null 。
        2. object是类JobHoldUntil的实例。
        3. 此作业保持不变，直到属性的值为object 且值为object的值为object 。
        重写：
        equals类 DateTimeSyntax
        参数
        object - Object来比较
        结果
        true如果 object相当于此作业保持到属性，否则为 false
        另请参见：
        Object.hashCode() ， HashMap

      • getCategory

        public final 类<? extends Attribute> getCategory()
        获取将用作此打印属性值的“类别”的打印属性类。

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

        Specified by:
        getCategory在界面 Attribute
        结果
        打印属性类（类别），类java.lang.Class的实例

      • getName

        public final String getName()
        获取此属性值为实例的类别的名称。

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

        Specified by:
        getName在接口 Attribute
        结果
        属性类别名称