Класс JobHoldUntil

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 по Гринвичу):

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

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 - Объект для сравнения с этим атрибутом удержания задания

Возвращает:

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

Возвращает:

Имя категории атрибута