Spec-Zone.ru › OpenJDK 24

Класс 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()
Возвращает имя категории, экземпляром которой является это значение атрибута.

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

getValue, hashCode, toString

Методы, объявленные в классе java.lang.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)
Возвращает, эквивалентен ли этот атрибут ожидания задания переданному объекту. Для эквивалентности должны выполняться все следующие условия:
  1. object не равно null.
  2. object является экземпляром класса JobHoldUntil.
  3. Значение Date этого атрибута ожидания задания и значение Date object равны.
Переопределяет:
equals в классе DateTimeSyntax
Параметры:
object - объект Object для сравнения
Возвращает:
true, если object эквивалентен этому атрибуту ожидания задания, false в противном случае
См. также:
  • Object.hashCode()
  • HashMap

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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/standard/JobHoldUntil.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API