Класс 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 определяет стандартные значения причины состояния задания. Реализация Print Service должна сообщать только те причины состояния задания, которые подходят для конкретной реализации; она не обязана сообщать каждую определённую причину состояния задания.

Экземпляры 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`.

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

clone, getOffset, getValue, hashCode, readResolve, toString

Методы, унаследованные от класса 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.

PROCESSING_TO_STOP_POINT

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 Print Service.]

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

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, 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/JobStateReason.html