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

См. также:

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

Modifier and Type	Field	Description
`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)

Modifier	Constructor	Description
`protected`	Создать новый перечисляемый элемент причины состояния задачи со значением заданного целого числа.

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

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

Methods declared in class javax.print.attribute.EnumSyntax

clone, getOffset, getValue, hashCode, readResolve, toString

Methods declared in class java.lang.Object

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

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

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.

ТОЧКА_ОСТАНОВКИ_ОБРАБОТКИ

public static final JobStateReason PROCESSING_TO_STOP_POINT

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

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

СЕРВИС_ОФФЛАЙН

public static final JobStateReason SERVICE_OFF_LINE

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

ЗАДАНИЕ_ЗАВЕРШЕНО_УСПЕШНО

public static final JobStateReason JOB_COMPLETED_SUCCESSFULLY

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

ЗАДАНИЕ_ЗАВЕРШЕНО_С_ПРЕДУПРЕЖДЕНИЯМИ

public static final JobStateReason JOB_COMPLETED_WITH_WARNINGS

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

ЗАДАНИЕ_ЗАВЕРШЕНО_С_ОШИБКАМИ

public static final JobStateReason JOB_COMPLETED_WITH_ERRORS

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

ЗАДАНИЕ_ВОЗМОЖНО_ПЕРЕЗАПУСК

public static final JobStateReason JOB_RESTARTABLE

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

ОЧЕРЕДЬ_В_УСТРОЙСТВЕ

public static final JobStateReason QUEUED_IN_DEVICE

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

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

JobStateReason

protected JobStateReason(int value)

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

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

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

getStringTable

protected String[] getStringTable()

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

Overrides:: getStringTable в классе EnumSyntax
Возвращает:: таблицу строк

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

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

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

getCategory

public final Class<? extends Attribute> getCategory()

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

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

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

getName

public final String getName()

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

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

Specified by:: 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/JobStateReason.html