Класс 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, нет, принтер должен рассматривать задание как кандидата для обработки, переместив задание в состояние ОЖИДАНИЯ.
Если указанное время уже прошло, задание должно сразу стать кандидатом на обработку. Таким образом, один из способов заставить задание немедленно стать кандидатом на обработку — это указать атрибут 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 «ночь». Имя категории, возвращаемое getName(), дает имя атрибута IPP.
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
JobHoldUntil |
Создает новый атрибут даты и времени задержки задания с заданным значением Date. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
equals |
Возвращает, эквивалентен ли этот атрибут задержки задания переданному объекту. |
final Class<? extends Attribute> |
getCategory() |
Возвращает класс атрибута печати, который должен использоваться в качестве «категории» для этого значения атрибута печати. |
final String |
getName() |
Возвращает имя категории, экземпляром которой является это значение атрибута. |
Методы, объявленные в классе javax.print.attribute.DateTimeSyntax
getValue, hashCode, toString
Подробное описание конструкторов
JobHoldUntil
public JobHoldUntil(Date dateTime)
Date значения.- Параметры:
-
dateTime- значениеDate - Исключения:
-
NullPointerException- еслиdateTimeявляетсяnull
Подробное описание методов
equals
public boolean equals(Object 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, 2021, 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/17/docs/api/java.desktop/javax/print/attribute/standard/JobHoldUntil.html