Класс JobStateReason

java.lang.Object

javax.print.attribute.EnumSyntax

javax.print.attribute.standard.JobStateReason

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

public class JobStateReason extends EnumSyntax implements Attribute

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

Экземпляры JobStateReason напрямую не появляются в наборе атрибутов задания печати. Вместо этого в наборе атрибутов задания печати присутствует атрибут JobStateReasons. Атрибут JobStateReasons содержит ноль, один или несколько объектов JobStateReason, относящихся к состоянию задания печати. Принтер добавляет объект JobStateReason в атрибут JobStateReasons задания печати, когда соответствующее условие становится истинным для задания печати, и удаляет объект JobStateReason, когда соответствующее условие становится ложным, независимо от того, изменилось ли при этом общее JobState задания печати.

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

См. также:

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

Модификатор и тип	Поле	Описание
`static final JobStateReason`	`ABORTED_BY_SYSTEM`	Задание было прервано системой.
`static final JobStateReason`	`COMPRESSION_ERROR`	Задание было прервано системой, поскольку при распаковке данных документа принтер обнаружил ошибку.
`static final JobStateReason`	`DOCUMENT_ACCESS_ERROR`	Принтеру не удалось получить доступ к одному или нескольким документам, переданным по ссылке (то есть объект представления данных печати является `URL`).
`static final JobStateReason`	`DOCUMENT_FORMAT_ERROR`	Задание было прервано системой, поскольку при обработке данных документа принтер обнаружил ошибку.
`static final JobStateReason`	`JOB_CANCELED_AT_DEVICE`	Задание было отменено неустановленным локальным пользователем, то есть пользователем, находившимся у консоли устройства.
`static final JobStateReason`	`JOB_CANCELED_BY_OPERATOR`	Задание было отменено оператором, то есть пользователем, прошедшим аутентификацию и обладающим правами оператора (локально или удалённо).
`static final JobStateReason`	`JOB_CANCELED_BY_USER`	Задание было отменено его владельцем, то есть пользователем, чья аутентифицированная идентификация совпадает со значением исходного пользователя, создавшего задание печати, либо другим авторизованным конечным пользователем, например участником группы безопасности владельца задания.
`static final JobStateReason`	`JOB_COMPLETED_SUCCESSFULLY`	Задание успешно завершено.
`static final JobStateReason`	`JOB_COMPLETED_WITH_ERRORS`	Задание завершено с ошибками (и, возможно, предупреждениями).
`static final JobStateReason`	`JOB_COMPLETED_WITH_WARNINGS`	Задание завершено с предупреждениями.
`static final JobStateReason`	`JOB_DATA_INSUFFICIENT`	Принтер создал задание печати, но ожидает получения дополнительных данных печати, прежде чем перевести задание в состояние `PROCESSING`.
`static final JobStateReason`	`JOB_HOLD_UNTIL_SPECIFIED`	Для атрибута `JobHoldUntil` задания указано значение даты и времени, которое ещё не наступило.
`static final JobStateReason`	`JOB_INCOMING`	Принтер создал задание печати, но ещё не завершил получение или принятие всех данных печати.
`static final JobStateReason`	`JOB_INTERPRETING`	Задание находится в состоянии `PROCESSING`, но, точнее, принтер интерпретирует данные документа.
`static final JobStateReason`	`JOB_OUTGOING`	Принтер передаёт задание устройству вывода.
`static final JobStateReason`	`JOB_PRINTING`	Устройство вывода наносит изображение на носитель.
`static final JobStateReason`	`JOB_QUEUED`	Задание находится в состоянии `PROCESSING`, но, точнее, принтер поставил данные документа в очередь.
`static final JobStateReason`	`JOB_QUEUED_FOR_MARKER`	Задание находится в состоянии `PENDING_HELD`, `PENDING` или `PROCESSING`, но, точнее, принтер выполнил достаточную обработку документа для начала нанесения изображения, и задание ожидает устройства нанесения.
`static final JobStateReason`	`JOB_RESTARTABLE`	Это задание сохранено и в настоящее время может быть перезапущено.
`static final JobStateReason`	`JOB_TRANSFORMING`	Задание находится в состоянии `PROCESSING`, но, точнее, принтер интерпретирует данные документа и создаёт другое электронное представление.
`static final JobStateReason`	`PRINTER_STOPPED`	Значение атрибута `PrinterState` принтера — `STOPPED`.
`static final JobStateReason`	`PRINTER_STOPPED_PARTLY`	Атрибут `PrinterStateReasons` принтера содержит значение `PrinterStateReason` `STOPPED_PARTLY`.
`static final JobStateReason`	`PROCESSING_TO_STOP_POINT`	Запросившая сторона отменила задание или принтер прервал его, однако принтер продолжает выполнять с заданием некоторые действия, пока не будет достигнута указанная точка остановки или не завершится завершение/очистка задания.
`static final JobStateReason`	`QUEUED_IN_DEVICE`	Задание было перенаправлено на устройство или в систему печати, которые не могут отправлять сведения о состоянии.
`static final JobStateReason`	`RESOURCES_ARE_NOT_READY`	Как минимум один ресурс, необходимый заданию, например носитель, шрифты, объекты ресурсов и т. д., недоступен ни на одном из физических принтеров, подходящих для выполнения задания.
`static final JobStateReason`	`SERVICE_OFF_LINE`	Принтер отключён от сети и не принимает задания.
`static final JobStateReason`	`SUBMISSION_INTERRUPTED`	По непредвиденной причине отправка задания не была завершена.
`static final JobStateReason`	`UNSUPPORTED_COMPRESSION`	Задание было прервано системой, поскольку при попытке распаковать данные документа принтер определил, что использованный алгоритм сжатия не входит в число поддерживаемых принтером.
`static final JobStateReason`	`UNSUPPORTED_DOCUMENT_FORMAT`	Задание было прервано системой, поскольку формат документа (тип документа) не входит в число поддерживаемых принтером.

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

JobStateReason(int value)

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

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

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

Методы, объявленные в классе 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()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения определённого промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения определённого промежутка реального времени.

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

JOB_INCOMING

public static final JobStateReason JOB_INCOMING

Принтер создал задание печати, но еще не завершил получение или прием всех данных для печати.

JOB_DATA_INSUFFICIENT

public static final JobStateReason JOB_DATA_INSUFFICIENT

Принтер создал задание печати, но ожидает получения дополнительных данных для печати, прежде чем сможет перевести задание в состояние PROCESSING. Если принтер начинает обработку до получения всех данных, он удаляет причину JOB_DATA_INSUFFICIENT, но причина JOB_INCOMING остается. Если принтер начинает обработку после получения всех данных, он одновременно удаляет причины JOB_DATA_INSUFFICIENT и JOB_INCOMING.

DOCUMENT_ACCESS_ERROR

public static final JobStateReason DOCUMENT_ACCESS_ERROR

Принтер не смог получить доступ к одному или нескольким документам, переданным по ссылке (т. е. объект представления данных для печати имеет тип URL). Эта причина предназначена для обозначения любых проблем с доступом к файлам, включая отсутствие файла и отказ в доступе из-за проблемы с управлением доступом. Решение о том, отменить ли задание и перевести его в состояние ABORTED или напечатать все доступные документы, перевести задание в состояние COMPLETED и добавить причину COMPLETED_WITH_ERRORS к атрибуту JobStateReasons задания, зависит от реализации и/или политики организации. Это значение следует поддерживать, если принтер поддерживает типы документов с объектами представления данных для печати URL.

SUBMISSION_INTERRUPTED

public static final JobStateReason SUBMISSION_INTERRUPTED

По непредвиденной причине задание не было отправлено полностью. Возможные причины: (1) принтер дал сбой до того, как клиент полностью отправил задание; (2) принтер или метод передачи документа дал необратимый сбой до того, как данные документа были полностью переданы принтеру; (3) клиент дал сбой до того, как задание было отправлено полностью.

JOB_OUTGOING

public static final JobStateReason JOB_OUTGOING

Принтер передает задание устройству вывода.

JOB_HOLD_UNTIL_SPECIFIED

public static final JobStateReason JOB_HOLD_UNTIL_SPECIFIED

Значение атрибута задания JobHoldUntil задано как дата и время, которые еще не наступили. Задание не должно обрабатываться, пока эта причина не будет устранена и не останется других причин для удержания задания. Это значение следует поддерживать, если поддерживается шаблонный атрибут задания JobHoldUntil.

RESOURCES_ARE_NOT_READY

public static final JobStateReason RESOURCES_ARE_NOT_READY

По крайней мере один ресурс, необходимый для задания, например носитель, шрифт, объект ресурса и т. д., недоступен ни на одном из физических принтеров, подходящих для выполнения задания. Это условие может быть обнаружено при принятии задания или позднее, пока задание ожидает обработки или обрабатывается, в зависимости от реализации. В зависимости от реализации и/или политики планирования заданий задание может остаться в текущем состоянии либо быть переведено в состояние PENDING_HELD.

PRINTER_STOPPED_PARTLY

public static final JobStateReason PRINTER_STOPPED_PARTLY

Значение атрибута принтера PrinterStateReasons содержит значение PrinterStateReason STOPPED_PARTLY.

PRINTER_STOPPED

public static final JobStateReason PRINTER_STOPPED

Значение атрибута принтера PrinterState — STOPPED.

JOB_INTERPRETING

public static final JobStateReason JOB_INTERPRETING

Задание находится в состоянии PROCESSING, но, точнее, принтер интерпретирует данные документа.

JOB_QUEUED

public static final JobStateReason JOB_QUEUED

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

JOB_TRANSFORMING

public static final JobStateReason JOB_TRANSFORMING

Задание находится в состоянии PROCESSING, но, точнее, принтер интерпретирует данные документа и создает другое электронное представление.

JOB_QUEUED_FOR_MARKER

public static final JobStateReason JOB_QUEUED_FOR_MARKER

Задание находится в состоянии PENDING_HELD, PENDING или PROCESSING, но, точнее, принтер завершил достаточную часть обработки документа, чтобы начать печать, и задание ожидает печатающего механизма. В системах, где для освобождения заданий требуется вмешательство человека, задание переводится в состояние PENDING_HELD. В системах, которые автоматически выбирают задание для печати, задание переводится в состояние PENDING или остается в состоянии PROCESSING в ожидании печатающего механизма — в зависимости от реализации. Во всех реализациях при начале печати задание переводится в состояние PROCESSING (или возвращается в него).

JOB_PRINTING

public static final JobStateReason JOB_PRINTING

Устройство вывода наносит изображение на носитель. Это значение полезно для принтеров, которые тратят много времени на обработку: (1) когда печать не выполняется, но затем нужно показать, что она началась; или (2) когда задание отменяется или прерывается, оставаясь в состоянии PROCESSING, но печать еще не остановлена, поэтому счетчики отпечатков или листов для задания продолжают увеличиваться.

JOB_CANCELED_BY_USER

public static final JobStateReason JOB_CANCELED_BY_USER

Задание отменено его владельцем, то есть пользователем, чья аутентифицированная личность совпадает со значением пользователя-инициатора, создавшего задание печати, либо другим авторизованным конечным пользователем, например участником группы безопасности владельца задания. Это значение следует поддерживать.

JOB_CANCELED_BY_OPERATOR

public static final JobStateReason JOB_CANCELED_BY_OPERATOR

Задание отменено оператором, то есть пользователем, аутентифицированным как обладатель прав оператора (локальных или удаленных). Если политика безопасности разрешает любому пользователю отменять задания других пользователей, это значение может использоваться, когда задание отменяет не его владелец. При такой политике безопасности любой пользователь фактически считается оператором в том, что касается отмены заданий. Это значение следует поддерживать, если реализация позволяет отменять задания не их владельцам.

JOB_CANCELED_AT_DEVICE

public static final JobStateReason JOB_CANCELED_AT_DEVICE

Задание отменено неустановленным локальным пользователем, то есть пользователем, находящимся у консоли устройства. Это значение следует поддерживать, если реализация позволяет отменять задания с консоли.

ABORTED_BY_SYSTEM

public static final JobStateReason ABORTED_BY_SYSTEM

Задание прервано системой. Задание либо (1) находится в процессе прерывания, (2) прервано системой и переведено в состояние ABORTED, либо (3) прервано системой и переведено в состояние PENDING_HELD, чтобы пользователь или оператор мог вручную повторить попытку выполнения задания. Это значение следует поддерживать.

UNSUPPORTED_COMPRESSION

public static final JobStateReason UNSUPPORTED_COMPRESSION

Задание прервано системой, поскольку при попытке распаковать данные документа принтер обнаружил, что используемый метод сжатия не поддерживается. Это значение необходимо поддерживать, поскольку Compression — обязательный атрибут описания документа.

COMPRESSION_ERROR

public static final JobStateReason COMPRESSION_ERROR

Задание прервано системой, поскольку при распаковке данных документа принтер обнаружил в них ошибку. Если принтер устанавливает эту причину, данные документа уже прошли все проверки, которые привели бы к причине состояния задания UNSUPPORTED_COMPRESSION.

UNSUPPORTED_DOCUMENT_FORMAT

public static final JobStateReason UNSUPPORTED_DOCUMENT_FORMAT

Задание прервано системой, поскольку формат документа (тип документа) не поддерживается принтером. Если клиент указывает тип документа с MIME-типом "application/octet-stream", принтер может прервать задание, если не сможет определить фактический формат данных документа с помощью автоматического распознавания (даже если формат документа поддерживается при явном указании). Это значение необходимо поддерживать, поскольку для каждого документа требуется указывать тип документа.

DOCUMENT_FORMAT_ERROR

public static final JobStateReason DOCUMENT_FORMAT_ERROR

Задание прервано системой, поскольку при обработке данных документа принтер обнаружил в них ошибку. Если принтер устанавливает эту причину, данные документа уже прошли все проверки, которые привели бы к причине состояния задания UNSUPPORTED_DOCUMENT_FORMAT.

PROCESSING_TO_STOP_POINT

public static final JobStateReason PROCESSING_TO_STOP_POINT

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

Если для отмены задания в состояниях PROCESSING или PROCESSING_STOPPED требуется измеримое время, реализация должна использовать эту причину, чтобы указать, что принтер продолжает выполнять некоторые действия с заданием, пока оно остается в состоянии PROCESSING или PROCESSING_STOPPED. После прекращения увеличения всех атрибутов описания задания принтер переводит задание из состояния PROCESSING в состояние CANCELED или ABORTED.

SERVICE_OFF_LINE

public static final JobStateReason SERVICE_OFF_LINE

Принтер отключен от сети и не принимает задания. Все задания PENDING переводятся в состояние PENDING_HELD. Такая ситуация может возникнуть, если входные данные службы или преобразователя документов недоступны или повреждены.

JOB_COMPLETED_SUCCESSFULLY

public static final JobStateReason JOB_COMPLETED_SUCCESSFULLY

Задание выполнено успешно. Это значение следует поддерживать.

JOB_COMPLETED_WITH_WARNINGS

public static final JobStateReason JOB_COMPLETED_WITH_WARNINGS

Задание выполнено с предупреждениями. Это значение следует поддерживать, если реализация обнаруживает предупреждения.

JOB_COMPLETED_WITH_ERRORS

public static final JobStateReason JOB_COMPLETED_WITH_ERRORS

Задание выполнено с ошибками (и, возможно, предупреждениями). Это значение следует поддерживать, если реализация обнаруживает ошибки.

JOB_RESTARTABLE

public static final JobStateReason JOB_RESTARTABLE

Это задание сохранено, и в настоящий момент его можно перезапустить. Если JOB_RESTARTABLE содержится в атрибуте задания JobStateReasons, принтер должен принять запрос на перезапуск этого задания. Это значение следует поддерживать, если поддерживается перезапуск заданий. [В настоящее время API Java Print Service не предоставляет возможности перезапуска заданий.]

QUEUED_IN_DEVICE

public static final JobStateReason QUEUED_IN_DEVICE

Задание передано устройству или системе печати, которые не могут отправлять сведения о состоянии. Принтер устанавливает для атрибута задания JobState значение COMPLETED и добавляет причину QUEUED_IN_DEVICE к атрибуту задания JobStateReasons, указывая, что у принтера нет дополнительных сведений о задании и больше никогда не будет.

Подробное описание конструкторов

JobStateReason

protected JobStateReason(int value)

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

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

Подробное описание методов

getStringTable

protected String[] getStringTable()

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

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

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

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

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

getCategory

public final Class<? extends Attribute> getCategory()

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

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

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

getName

public final String getName()

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

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

Определено в:: 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.