Класс JobState

java.lang.Object
- javax.print.attribute.EnumSyntax
- - javax.print.attribute.standard.JobState

Все реализованные интерфейсы:: Serializable, Cloneable, Attribute, PrintJobAttribute

public class JobState
extends EnumSyntax
implements PrintJobAttribute

JobState — это класс атрибута печати, перечисление, определяющее текущее состояние задания печати. Класс JobState определяет стандартные значения состояния задания. Реализация Print Service должна сообщать только те состояния заданий, которые подходят для конкретной реализации; она не обязана сообщать каждое определённое состояние задания. Атрибут JobStateReasons дополняет атрибут JobState, предоставляя более подробную информацию о задании в данном состоянии.

Совместимость с IPP: Имя категории, возвращаемое getName(), — это имя атрибута IPP. Целочисленное значение перечисления — это значение перечисления IPP. Метод toString() возвращает строковое представление значения атрибута в формате IPP.

См. также:: Справочник по сериализованной форме

Поля

Модификатор и тип	Поле и описание
`static JobState`	`ABORTED` Задание было прервано системой (обычно, когда задание находилось в состоянии PROCESSING или PROCESSING_STOPPED), принтер завершил прерывание задания, и все атрибуты состояния задания достигли своих конечных значений для задания.
`static JobState`	`CANCELED` Задание было отменено каким-либо пользователем, принтер завершил отмену задания, и все атрибуты состояния задания достигли своих конечных значений для задания.
`static JobState`	`COMPLETED` Задание успешно завершено или с предупреждениями или ошибками после обработки, все листы носителя задания были успешно уложены в соответствующие выходные лотки, и все атрибуты состояния задания достигли своих конечных значений для задания.
`static JobState`	`PENDING` Задание готово к началу обработки, но ещё не обрабатывается.
`static JobState`	`PENDING_HELD` Задание не готово к обработке по ряду причин, но вернётся в состояние PENDING, как только причины исчезнут.
`static JobState`	`PROCESSING` Задание обрабатывается.
`static JobState`	`PROCESSING_STOPPED` Обработка задания приостановлена по ряду причин, и она вернётся в состояние PROCESSING, как только причины исчезнут.
`static JobState`	`UNKNOWN` Состояние задания неизвестно.

Конструкторы

Модификатор	Конструктор и описание
`protected`	`JobState(int value)` Создаёт новое значение перечисления состояния задания с заданным целочисленным значением.

Методы

Модификатор и тип	Метод и описание
`Class<? extends Attribute>`	`getCategory()` Получить класс атрибута печати, который должен использоваться в качестве "категории" для этого значения атрибута печати.
`protected EnumSyntax[]`	`getEnumValueTable()` Возвращает таблицу значений перечисления для класса JobState.
`String`	`getName()` Получить имя категории, экземпляром которой является это значение атрибута.
`protected String[]`	`getStringTable()` Возвращает таблицу строк для класса JobState.

Методы, унаследованные от класса javax.print.attribute.EnumSyntax

clone, getOffset, getValue, hashCode, readResolve, toString

Методы, унаследованные от класса java.lang.Object

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

Поля

UNKNOWN

public static final JobState UNKNOWN

Состояние задания неизвестно.

PENDING

public static final JobState PENDING

Задание готово к началу обработки, но ещё не обрабатывается.

PENDING_HELD

public static final JobState PENDING_HELD

Задание не готово к обработке по ряду причин, но вернётся в состояние PENDING, как только причины исчезнут. Атрибут JobStateReasons задания должен указывать причину, по которой задание больше не может быть обработано.

PROCESSING

public static final JobState PROCESSING

Задание обрабатывается. Одновременно выполняется одна или несколько из следующих операций:

Задание использует или пытается использовать один или несколько чисто программных процессов, которые анализируют, создают или интерпретируют PDL и т. п.
Задание использует или пытается использовать один или несколько аппаратных устройств, которые интерпретируют PDL, производят отметки на носителе и/или выполняют завершающие операции, такие как скрепление и т. п.
Принтер подготовил задание к печати, но устройство вывода ещё не печатает его, либо потому, что задание ещё не достигло устройства вывода, либо потому, что задание находится в очереди в устройстве вывода или в другом планировщике, ожидая, пока устройство вывода его напечатает.

Когда задание находится в состоянии PROCESSING, общее состояние задания включает подробный статус, представленный в атрибутах принтера PrinterState и PrinterStateReasons.

Реализации могут, но не обязаны, включать дополнительные значения в атрибут JobStateReasons задания, чтобы указать ход выполнения задания, например, добавив значение JOB_PRINTING, чтобы указать, когда устройство вывода фактически делает отметки на бумаге и/или PROCESSING_TO_STOP_POINT, чтобы указать, что принтер в процессе отмены или прерывания задания.

PROCESSING_STOPPED

public static final JobState PROCESSING_STOPPED

Обработка задания приостановлена по ряду причин, и она вернётся в состояние PROCESSING, как только причины исчезнут.

Атрибут JobStateReasons задания может указать причину остановки обработки. Например, если устройство вывода остановлено, значение PRINTER_STOPPED может быть включено в атрибут JobStateReasons задания.

Примечание: когда устройство вывода остановлено, устройство обычно указывает своё состояние в удобочитаемой форме локально на устройстве. Клиент может получить более полную информацию о состоянии устройства удалённо, запросив атрибуты принтера PrinterState и PrinterStateReasons.

CANCELED

public static final JobState CANCELED

Задание было отменено каким-либо пользователем, принтер завершил отмену задания, и все атрибуты состояния задания достигли своих конечных значений для задания. Пока принтер отменяет задание, задание остаётся в текущем состоянии, но атрибут JobStateReasons задания должен содержать значение PROCESSING_TO_STOP_POINT и одно из значений CANCELED_BY_USER, CANCELED_BY_OPERATOR или CANCELED_AT_DEVICE. Когда задание переходит в состояние CANCELED, значение PROCESSING_TO_STOP_POINT, если оно присутствует, должно быть удалено, но значение CANCELED_BY_xxx, если оно присутствует, должно остаться.

ABORTED

public static final JobState ABORTED

Задание было прервано системой (обычно, когда задание находилось в состоянии PROCESSING или PROCESSING_STOPPED), принтер завершил прерывание задания, и все атрибуты состояния задания достигли своих конечных значений для задания. Пока принтер прерывает задание, задание остаётся в текущем состоянии, но атрибут JobStateReasons задания должен содержать значения PROCESSING_TO_STOP_POINT и ABORTED_BY_SYSTEM. Когда задание переходит в состояние ABORTED, значение PROCESSING_TO_STOP_POINT, если оно присутствует, должно быть удалено, но значение ABORTED_BY_SYSTEM, если оно присутствует, должно остаться.

COMPLETED

public static final JobState COMPLETED

Задание успешно завершено или с предупреждениями или ошибками после обработки, все листы носителя задания были успешно уложены в соответствующие выходные лотки, и все атрибуты состояния задания достигли своих конечных значений для задания. Атрибут JobStateReasons задания должен содержать одно из этих значений: COMPLETED_SUCCESSFULLY, COMPLETED_WITH_WARNINGS или COMPLETED_WITH_ERRORS.

Конструкторы

JobState

protected JobState(int value)

Создаёт новое значение перечисления состояния задания с заданным целочисленным значением.

Параметры:: value — Целочисленное значение.

Методы

getStringTable

protected String[] getStringTable()

Возвращает таблицу строк для класса JobState.

Переопределяет:: getStringTable в классе EnumSyntax
Возвращает:: таблицу строк

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

Возвращает таблицу значений перечисления для класса JobState.

Переопределяет:: getEnumValueTable в классе EnumSyntax
Возвращает:: таблицу значений

getCategory

public final Class<? extends Attribute> getCategory()

Получить класс атрибута печати, который должен использоваться в качестве "категории" для этого значения атрибута печати.

Для класса JobState и любых подклассов, определённых поставщиком, категорией является сам класс JobState.

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

getName

public final String getName()

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

Для класса JobState и любых подклассов, определённых поставщиком, имя категории — "job-state".

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

© 1993, 2020, 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.