Класс 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`	`clone()`	Возвращает копию этого значения перечисления, которая для сохранения семантики значений перечисления является тем же объектом, что и исходное значение.
`protected int`	`getOffset()`	Возвращает наименьшее целочисленное значение, используемое классом перечисления этого значения перечисления.
`int`	`getValue()`	Возвращает целочисленное значение этого значения перечисления.
`int`	`hashCode()`	Возвращает хеш-код этого значения перечисления.
`protected Object`	`readResolve()`	При чтении объекта преобразует этот десериализованный экземпляр перечисления в соответствующее значение перечисления, определённое в классе атрибута перечисления.
`String`	`toString()`	Возвращает строковое значение, соответствующее этому значению перечисления.

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

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Метод завершения устарел и может быть удалён в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание полей

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.