Spec-Zone.ru › OpenJDK 25

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

См. также:
  • Сериализованное представление

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

Модификатор и тип Поле Описание
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)
Модификатор Конструктор Описание
protected
Создает новое значение перечисления причины состояния задания с заданным целочисленным значением.

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

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

Методы, объявленные в классе EnumSyntax

clone, getOffset, getValue, hashCode, readResolve, toString

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

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
Это задание сохранено и в данный момент может быть перезапущено. Если атрибут задания JobStateReasons содержит JOB_RESTARTABLE, принтер должен принять запрос на перезапуск этого задания. Это значение следует поддерживать, если поддерживается перезапуск заданий. [В настоящее время 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
Возвращает:
имя категории атрибута

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API