Класс 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 — это класс атрибута печати, атрибут даты и времени, указывающий точную дату и время, когда задание должно стать кандидатом на печать.

Если значение этого атрибута указывает дату и время в будущем, принтер должен добавить значение JobStateReason JOB_HOLD_UNTIL_SPECIFIED к атрибуту JobStateReasons задания, перевести задание в состояние PENDING_HELD и не планировать его печать до наступления указанной даты и времени.

Когда наступит указанная дата и время, принтер должен удалить значение JobStateReason JOB_HOLD_UNTIL_SPECIFIED из атрибута JobStateReasons задания, если оно присутствует. Если нет других причин состояния задания, из-за которых оно остается в состоянии PENDING_HELD, принтер должен считать задание кандидатом на обработку, переведя его в состояние PENDING.

Если указанная дата и время уже прошли, задание должно сразу стать кандидатом на обработку. Таким образом, один из способов немедленно сделать задание кандидатом на обработку — указать атрибут JobHoldUntil, созданный следующим образом (это соответствует дате и времени 1 января 1970 года, 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 с некоторой потерей точности; например, значение JobHoldUntil с сегодняшней датой и местным временем 21:00 может быть преобразовано в стандартное ключевое слово IPP "night". Имя категории, возвращаемое методом getName(), задает имя атрибута IPP.

См. также:

Краткое описание конструкторов

Конструктор	Описание
`JobHoldUntil(Date dateTime)`	Создает новый атрибут даты и времени удержания задания до указанного момента с заданным значением `Date`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object object)`	Возвращает, эквивалентен ли этот атрибут времени удержания задания до указанного момента переданному объекту.
`final Class<? extends Attribute>`	`getCategory()`	Возвращает класс атрибута печати, используемый в качестве «категории» для этого значения атрибута печати.
`final String`	`getName()`	Возвращает имя категории, экземпляром которой является это значение атрибута.

Методы, объявленные в классе DateTimeSyntax

getValue, hashCode, toString

Методы, объявленные в классе Object

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

Подробное описание конструкторов

JobHoldUntil

public JobHoldUntil(Date dateTime)

Создает новый атрибут даты и времени удержания задания до указанного момента с заданным значением Date.

Параметры:: dateTime — значение Date
Исключения:: NullPointerException — если dateTime равно null

Подробное описание методов

equals

public boolean equals(Object object)

Возвращает, эквивалентен ли этот атрибут времени удержания задания до указанного момента переданному объекту. Для эквивалентности должны выполняться все следующие условия:

object не является null.
object является экземпляром класса JobHoldUntil.
Значение Date этого атрибута времени удержания задания до указанного момента равно значению Date объекта object.

Переопределяет:

equals в классе DateTimeSyntax

Параметры:

object — Object для сравнения

Возвращает:

true, если object эквивалентен этому атрибуту времени удержания задания до указанного момента; в противном случае — false

См. также:

getCategory

public final Class<? extends Attribute> getCategory()

Возвращает класс атрибута печати, используемый в качестве «категории» для этого значения атрибута печати.

Для класса JobHoldUntil категорией является сам класс JobHoldUntil.

Определено в:: getCategory в интерфейсе Attribute
Возвращает:: класс атрибута печати (категория), экземпляр класса java.lang.Class

getName

public final String getName()

Возвращает имя категории, экземпляром которой является это значение атрибута.

Для класса JobHoldUntil именем категории является "job-hold-until".

Определено в:: getName в интерфейсе Attribute
Возвращает:: имя категории атрибута

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/standard/JobHoldUntil.html