模块  java.desktop

Class JobHoldUntil

  • 实现的所有接口
    SerializableCloneableAttributePrintJobAttributePrintRequestAttribute

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

    如果此属性的值指定将来的日期时间,则打印机应将JobStateReasonJOB_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对象,并将其设置为DateJobHoldUntil属性。

    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 - 如果 dateTimenull
    • 方法详细信息

      • equals

        public boolean equals​(Object object)
        返回此属性是否保持,直到属性等效于传入的对象。 为了等效,所有以下条件必须为真:
        1. object不是null
        2. object是类JobHoldUntil的实例。
        3. 此作业保持不变,直到属性的值为object 值为object的值为object
        重写:
        equalsDateTimeSyntax
        参数
        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
        结果
        属性类别名称