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

Принтер создал задание печати, но принтер ожидает дополнительных данных печати, прежде чем сможет перевести задание в состояние PROCESSING.
static JobStateReason JOB_HOLD_UNTIL_SPECIFIED

Значение атрибута задания JobHoldUntil было задано с датой и временем, которые ещё не наступили.
static JobStateReason JOB_INCOMING

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

Задание находится в состоянии PROCESSING , но более конкретно, принтер интерпретирует данные документа.
static JobStateReason JOB_OUTGOING

Принтер отправляет задание на выходное устройство.
static JobStateReason JOB_PRINTING

Выходное устройство маркирует носитель.
static JobStateReason JOB_QUEUED

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

Задание находится в состоянии PENDING_HELD, PENDING, или PROCESSING, но более конкретно, принтер завершил достаточно обработки документа, чтобы начать маркировку, и задание ожидает маркер.
static JobStateReason JOB_RESTARTABLE

Это задание сохраняется и в настоящее время может быть перезапущено.
static JobStateReason JOB_TRANSFORMING

Задание находится в состоянии PROCESSING , но более конкретно, принтер интерпретирует данные документа и создаёт другое электронное представление.
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

Принтер создал задание печати, но ожидает дополнительные данные печати, прежде чем переместить задание в состояние 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.

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, 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/print/attribute/standard/JobStateReason.html

Spec-Zone .ru
спецификации, руководства, описания, API