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

PROCESSING_TO_STOP_POINT

public static final JobStateReason PROCESSING_TO_STOP_POINT

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

Если реализации требуется некоторое измеримое время для отмены задания в состояниях задания PROCESSING или PROCESSING_STOPPED, принтер должен использовать эту причину для указания того, что принтер всё ещё выполняет некоторые действия по заданию, в то время как задание остаётся в состоянии PROCESSING или PROCESSING_STOPPED. После того, как все атрибуты описания задания перестали увеличиваться, принтер перемещает задание из состояния ОБРАБОТКИ в состояния задания 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, 2021, 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/17/docs/api/java.desktop/javax/print/attribute/standard/JobStateReason.html