Класс 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 определяет стандартные значения состояний задания. Реализация службы печати должна сообщать только о тех состояниях заданий, которые подходят для конкретной реализации; сообщать обо всех определённых состояниях не требуется. Атрибут JobStateReasons дополняет атрибут JobState, предоставляя более подробную информацию о задании в указанном состоянии.

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

См. также:

Краткое описание полей

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

Краткое описание конструкторов

JobState(int value)

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

Краткое описание методов

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

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

clone, getOffset, getValue, hashCode, readResolve, toString

Методы, объявленные в классе 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 может указывать причину остановки обработки. Например, если устройство вывода остановлено, в атрибут задания JobStateReasons может быть включено значение PRINTER_STOPPED.

Примечание: При остановке устройства вывода его состояние обычно отображается на самом устройстве в понятном человеку виде. Клиент может получить более полные сведения о состоянии устройства удалённо, запросив атрибуты принтера 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, 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/standard/JobState.html