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

Методы, объявленные в классе 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, 2023, 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/21/docs/api/java.desktop/javax/print/attribute/standard/JobState.html