Класс 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 с сегодняшней датой и местным временем 9: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

Модификатор и тип	Метод	Описание
`Date`	`getValue()`	Возвращает значение `java.util.Date` этого атрибута даты и времени.
`int`	`hashCode()`	Возвращает хеш-код этого атрибута даты и времени.
`String`	`toString()`	Возвращает строковое представление этого атрибута даты и времени.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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.