Module  java.desktop
软件包  javax.print.attribute.standard

Class JobHoldUntil

  • All Implemented Interfaces:
    Serializable ， Cloneable ， Attribute ， PrintJobAttribute ， PrintRequestAttribute 

    public final class JobHoldUntil
extends DateTimeSyntax
implements PrintRequestAttribute, PrintJobAttribute
    JobHoldUntil类是一个打印属性类，一个日期时间属性，用于指定作业必须成为打印候选者的确切日期和时间。

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

    当指定的日期时间到达时，打印机必须从作业的JobStateReasons属性（如果存在）中删除JOB_HOLD_UNTIL_SPECIFIED的值JobStateReason。 如果没有其他作业状态原因使作业保持在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

    • 构造方法详细信息

      • 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 Class<? 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
        结果
        属性类别名称。