Класс 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 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`.

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

clone, getOffset, getValue, hashCode, readResolve, toString

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

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

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

НЕИЗВЕСТНО

public static final JobState UNKNOWN

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

ОЖИДАЕТСЯ

public static final JobState PENDING

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

ОЖИДАЕТСЯ_В_ЗАДЕРЖКЕ

public static final JobState PENDING_HELD

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

ОБРАБАТЫВАЕТСЯ

public static final JobState PROCESSING

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

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

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

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

ОБРАБОТКА_ОСТАНОВЛЕНА

public static final JobState PROCESSING_STOPPED

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

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

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

ОТМЕНЕНО

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, если оно присутствует, должно остаться.

ПРЕРВАНО

public static final JobState ABORTED

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

ЗАВЕРШЕНО

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