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

См. также:: Форматированная информация о сериализации

Поля

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

Конструкторы

Модификатор	Конструктор и описание
`protected`	`JobStateReason(int value)` Создает новое значение перечисления причины состояния задания с заданным целочисленным значением.

Методы

Модификатор и тип	Метод и описание
`Class<? extends Attribute>`	`getCategory()` Получить класс атрибута печати, который будет использоваться в качестве «категории» для этого значения атрибута печати.
`protected EnumSyntax[]`	`getEnumValueTable()` Возвращает таблицу значений перечисления для класса JobStateReason.
`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

Принтер создал задание печати, но принтер ожидает дополнительные данные печати, прежде чем сможет перевести задание в состояние ОБРАБОТКИ. Если принтер начинает обработку до получения всех данных, принтер удаляет причину JOB_DATA_INSUFFICIENT, но причина JOB_INCOMING остаётся. Если принтер начинает обработку после получения всех данных, принтер удаляет причины JOB_DATA_INSUFFICIENT и JOB_INCOMING одновременно.

DOCUMENT_ACCESS_ERROR

public static final JobStateReason DOCUMENT_ACCESS_ERROR

Принтер не смог получить доступ к одному или нескольким документам, переданным по ссылке (то есть, объект представления данных печати является URL). Эта причина предназначена для покрытия любых проблем доступа к файлам, включая случаи, когда файла не существует и доступ запрещён из-за проблемы контроля доступа. Решение о том, прерывает ли принтер задание и переводит задание в состояние ОТМЕНЁННОЕ или печатает все доступные документы и переводит задание в состояние ЗАВЕРШЁННОЕ и добавляет причину 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

Задание находится в состоянии ОБРАБОТКИ, но более конкретно, принтер интерпретирует данные документа.

JOB_QUEUED

public static final JobStateReason JOB_QUEUED

Задание находится в состоянии ОБРАБОТКИ, но более конкретно, принтер поставил данные документа в очередь.

JOB_TRANSFORMING

public static final JobStateReason JOB_TRANSFORMING

Задание находится в состоянии ОБРАБОТКИ, но более конкретно, принтер интерпретирует данные документа и создаёт другую электронную форму представления.

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) когда задание отменяется или прерывается, пока задание остаётся в состоянии ОБРАБОТКИ, но маркировка ещё не остановлена, поэтому количество отпечатков или листов всё ещё увеличивается для задания.

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) было прервано системой и помещено в состояние ОТМЕНЁННОЕ, или (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 на данный момент.]

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, 2020, 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.