Класс PrinterStateReason

java.lang.Object

javax.print.attribute.EnumSyntax

javax.print.attribute.standard.PrinterStateReason

Все реализуемые интерфейсы:: Serializable, Cloneable, Attribute

public class PrinterStateReason extends EnumSyntax implements Attribute

Класс PrinterStateReason — это класс атрибута печати, перечисление, предоставляющее дополнительные сведения о текущем состоянии принтера, то есть информацию, дополняющую значение атрибута PrinterState принтера. Класс PrinterStateReason определяет стандартные значения причин состояния принтера. Реализация службы печати должна сообщать только те причины состояния принтера, которые применимы к конкретной реализации; сообщать обо всех определённых причинах состояния принтера не требуется.

Экземпляры PrinterStateReason не появляются непосредственно в наборе атрибутов службы печати. Вместо этого в наборе атрибутов службы печати присутствует атрибут PrinterStateReasons. Атрибут PrinterStateReasons содержит ноль, один или несколько объектов PrinterStateReason, относящихся к состоянию службы печати, причём каждому объекту PrinterStateReason сопоставлен уровень REPORT (наименее серьёзный), WARNING или ERROR (наиболее серьёзный) атрибута Severity. Принтер добавляет объект PrinterStateReason в атрибут PrinterStateReasons службы печати, когда соответствующее условие становится истинным для принтера, и удаляет объект PrinterStateReason, когда соответствующее условие перестаёт выполняться, независимо от того, изменилось ли также общее состояние PrinterState службы печати.

Совместимость с IPP: Строковые значения, возвращаемые методами toString() каждого отдельного объекта PrinterStateReason и связанного с ним объекта Severity, объединённые дефисом ("-"), задают значение ключевого слова IPP для атрибута PrinterStateReasons. Имя категории, возвращаемое методом getName(), задаёт имя атрибута IPP.

См. также:

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

Модификатор и тип	Поле	Описание
`static final PrinterStateReason`	`CONNECTING_TO_DEVICE`	Принтер назначил задание устройству вывода и устанавливает соединение с общим сетевым устройством вывода (и может не иметь возможности начать печать задания в течение неопределённо долгого времени — это зависит от того, насколько другие серверы в сети используют устройство вывода).
`static final PrinterStateReason`	`COVER_OPEN`	Одна или несколько крышек устройства открыты.
`static final PrinterStateReason`	`DEVELOPER_EMPTY`	В устройстве закончился проявитель.
`static final PrinterStateReason`	`DEVELOPER_LOW`	В устройстве заканчивается проявитель.
`static final PrinterStateReason`	`DOOR_OPEN`	Одна или несколько дверец устройства открыты.
`static final PrinterStateReason`	`FUSER_OVER_TEMP`	Температура термофиксатора выше нормы.
`static final PrinterStateReason`	`FUSER_UNDER_TEMP`	Температура термофиксатора ниже нормы.
`static final PrinterStateReason`	`INPUT_TRAY_MISSING`	Одного или нескольких входных лотков нет в устройстве.
`static final PrinterStateReason`	`INTERLOCK_OPEN`	Одно или несколько блокировочных устройств принтера разблокированы.
`static final PrinterStateReason`	`INTERPRETER_RESOURCE_UNAVAILABLE`	Недоступен ресурс интерпретатора (например, шрифт или форма).
`static final PrinterStateReason`	`MARKER_SUPPLY_EMPTY`	В устройстве закончился как минимум один расходный материал для печати (например, тонер, чернила или лента).
`static final PrinterStateReason`	`MARKER_SUPPLY_LOW`	Заканчивается как минимум один расходный материал для печати (например, тонер, чернила или лента).
`static final PrinterStateReason`	`MARKER_WASTE_ALMOST_FULL`	Контейнер для отходов расходных материалов устройства почти заполнен.
`static final PrinterStateReason`	`MARKER_WASTE_FULL`	Контейнер для отходов расходных материалов устройства заполнен.
`static final PrinterStateReason`	`MEDIA_EMPTY`	Как минимум один входной лоток пуст.
`static final PrinterStateReason`	`MEDIA_JAM`	В устройстве произошло замятие носителя.
`static final PrinterStateReason`	`MEDIA_LOW`	Как минимум в одном входном лотке заканчивается носитель.
`static final PrinterStateReason`	`MEDIA_NEEDED`	В лотке закончился носитель.
`static final PrinterStateReason`	`MOVING_TO_PAUSED`	Кто-то приостановил работу принтера, но устройству (устройствам) требуется заметное время для остановки.
`static final PrinterStateReason`	`OPC_LIFE_OVER`	Фотопроводник больше не функционирует.
`static final PrinterStateReason`	`OPC_NEAR_EOL`	Срок службы фотопроводника подходит к концу.
`static final PrinterStateReason`	`OTHER`	Принтер обнаружил ошибку, отличную от перечисленных ниже.
`static final PrinterStateReason`	`OUTPUT_AREA_ALMOST_FULL`	Одна или несколько областей вывода почти заполнены (например, лоток, укладчик или сортировщик).
`static final PrinterStateReason`	`OUTPUT_AREA_FULL`	Одна или несколько областей вывода заполнены (например, лоток, укладчик или сортировщик).
`static final PrinterStateReason`	`OUTPUT_TRAY_MISSING`	Одного или нескольких выходных лотков нет в устройстве.
`static final PrinterStateReason`	`PAUSED`	Кто-то приостановил работу принтера, и его состояние `PrinterState` равно `STOPPED`.
`static final PrinterStateReason`	`SHUTDOWN`	Кто-то вывел принтер из эксплуатации; устройство может быть выключено или физически отсоединено.
`static final PrinterStateReason`	`SPOOL_AREA_FULL`	Достигнут предел выделенного для буферизации постоянного хранилища.
`static final PrinterStateReason`	`STOPPED_PARTLY`	Если принтер управляет несколькими устройствами вывода, эта причина означает, что одно или несколько устройств вывода остановлены.
`static final PrinterStateReason`	`STOPPING`	Принтер останавливает устройство; остановка произойдёт через некоторое время.
`static final PrinterStateReason`	`TIMED_OUT`	Серверу удалось подключиться к устройству вывода (или подключение установлено постоянно), но получить ответ от устройства вывода не удалось.
`static final PrinterStateReason`	`TONER_EMPTY`	В устройстве закончился тонер.
`static final PrinterStateReason`	`TONER_LOW`	В устройстве заканчивается тонер.

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

PrinterStateReason(int value)

Модификатор	Конструктор	Описание
`protected`	Создаёт новое значение перечисления причины состояния принтера с заданным целочисленным значением.

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

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

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

clone, getOffset, getValue, hashCode, readResolve, toString

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

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание полей

OTHER

public static final PrinterStateReason OTHER

Принтер обнаружил ошибку, отличную от перечисленных ниже.

MEDIA_NEEDED

public static final PrinterStateReason MEDIA_NEEDED

В лотке закончился носитель.

MEDIA_JAM

public static final PrinterStateReason MEDIA_JAM

В устройстве произошло замятие носителя.

MOVING_TO_PAUSED

public static final PrinterStateReason MOVING_TO_PAUSED

Кто-то приостановил работу принтера, но устройству (устройствам) требуется заметное время для остановки. После остановки всего вывода состояние PrinterState становится равным STOPPED, а значение PAUSED заменяет значение MOVING_TO_PAUSED в атрибуте PrinterStateReasons. Это значение должно поддерживаться, если работу принтера можно приостановить и в определённых обстоятельствах реализация тратит значительное время на приостановку устройства.

PAUSED

public static final PrinterStateReason PAUSED

Кто-то приостановил работу принтера, и его состояние PrinterState равно STOPPED. В этом состоянии принтер не должен выполнять печать, но должен выполнять другие операции, запрошенные клиентом. Если принтер печатал задание в момент приостановки, Printer должен возобновить печать этого задания после снятия приостановки, не оставляя на отпечатках никаких следов такой приостановки. Это значение должно поддерживаться, если работу принтера можно приостановить.

SHUTDOWN

public static final PrinterStateReason SHUTDOWN

Кто-то вывел принтер из эксплуатации; устройство может быть выключено или физически отсоединено. В этом состоянии принтер не должен выполнять печать, а если принтер не реализован посредством активного сервера печати, он не должен выполнять и другие операции, запрошенные клиентом. Если принтер печатал задание в момент выключения, он не обязан возобновлять его печать после включения. Если принтер возобновит печать такого задания, на отпечатках могут остаться следы выключения: например, часть задания, напечатанная до выключения, может быть повторно напечатана после включения.

CONNECTING_TO_DEVICE

public static final PrinterStateReason CONNECTING_TO_DEVICE

Принтер назначил задание устройству вывода и устанавливает соединение с общим сетевым устройством вывода (и может не иметь возможности начать печать задания в течение неопределённо долгого времени — это зависит от того, насколько другие серверы в сети используют устройство вывода).

TIMED_OUT

public static final PrinterStateReason TIMED_OUT

Серверу удалось подключиться к устройству вывода (или подключение установлено постоянно), но получить ответ от устройства вывода не удалось.

STOPPING

public static final PrinterStateReason STOPPING

Принтер останавливает устройство; остановка произойдёт через некоторое время. После остановки устройства принтер изменит состояние PrinterState на STOPPED. Причина STOPPING никогда не является ошибкой, даже для принтера с одним устройством вывода. Когда устройство вывода перестаёт принимать задания, эта причина указывается в атрибуте PrinterStateReasons принтера, пока устройство вывода завершает печать.

STOPPED_PARTLY

public static final PrinterStateReason STOPPED_PARTLY

Если принтер управляет несколькими устройствами вывода, эта причина означает, что одно или несколько устройств вывода остановлены. Если серьёзность причины соответствует отчёту, остановлено менее половины устройств вывода. Если серьёзность причины соответствует предупреждению, остановлена как минимум половина, но не все устройства вывода.

TONER_LOW

public static final PrinterStateReason TONER_LOW

В устройстве заканчивается тонер.

TONER_EMPTY

public static final PrinterStateReason TONER_EMPTY

В устройстве закончился тонер.

SPOOL_AREA_FULL

public static final PrinterStateReason SPOOL_AREA_FULL

Достигнут предел выделенного для буферизации постоянного хранилища. Принтер временно не может принимать новые задания. Принтер удалит эту причину, когда снова сможет принимать задания. Это значение следует использовать для принтера без буферизации, который принимает только одно или небольшое количество заданий за раз, либо для принтера с буферизацией, в котором закончилось место для буферизации.

COVER_OPEN

public static final PrinterStateReason COVER_OPEN

Одна или несколько крышек устройства открыты.

INTERLOCK_OPEN

public static final PrinterStateReason INTERLOCK_OPEN

Одно или несколько блокировочных устройств принтера разблокированы.

DOOR_OPEN

public static final PrinterStateReason DOOR_OPEN

Одна или несколько дверец устройства открыты.

INPUT_TRAY_MISSING

public static final PrinterStateReason INPUT_TRAY_MISSING

Одного или нескольких входных лотков нет в устройстве.

MEDIA_LOW

public static final PrinterStateReason MEDIA_LOW

Как минимум в одном входном лотке заканчивается носитель.

MEDIA_EMPTY

public static final PrinterStateReason MEDIA_EMPTY

Как минимум один входной лоток пуст.

OUTPUT_TRAY_MISSING

public static final PrinterStateReason OUTPUT_TRAY_MISSING

Одного или нескольких выходных лотков нет в устройстве.

OUTPUT_AREA_ALMOST_FULL

public static final PrinterStateReason OUTPUT_AREA_ALMOST_FULL

Одна или несколько областей вывода почти заполнены (например, лоток, укладчик или сортировщик).

OUTPUT_AREA_FULL

public static final PrinterStateReason OUTPUT_AREA_FULL

Одна или несколько областей вывода заполнены (например, лоток, укладчик или сортировщик).

MARKER_SUPPLY_LOW

public static final PrinterStateReason MARKER_SUPPLY_LOW

Заканчивается как минимум один расходный материал для печати (например, тонер, чернила или лента).

MARKER_SUPPLY_EMPTY

public static final PrinterStateReason MARKER_SUPPLY_EMPTY

В устройстве закончился как минимум один расходный материал для печати (например, тонер, чернила или лента).

MARKER_WASTE_ALMOST_FULL

public static final PrinterStateReason MARKER_WASTE_ALMOST_FULL

Контейнер для отходов расходных материалов устройства почти заполнен.

MARKER_WASTE_FULL

public static final PrinterStateReason MARKER_WASTE_FULL

Контейнер для отходов расходных материалов устройства заполнен.

FUSER_OVER_TEMP

public static final PrinterStateReason FUSER_OVER_TEMP

Температура термофиксатора выше нормы.

FUSER_UNDER_TEMP

public static final PrinterStateReason FUSER_UNDER_TEMP

Температура термофиксатора ниже нормы.

OPC_NEAR_EOL

public static final PrinterStateReason OPC_NEAR_EOL

Срок службы фотопроводника подходит к концу.

OPC_LIFE_OVER

public static final PrinterStateReason OPC_LIFE_OVER

Фотопроводник больше не функционирует.

DEVELOPER_LOW

public static final PrinterStateReason DEVELOPER_LOW

В устройстве заканчивается проявитель.

DEVELOPER_EMPTY

public static final PrinterStateReason DEVELOPER_EMPTY

В устройстве закончился проявитель.

INTERPRETER_RESOURCE_UNAVAILABLE

public static final PrinterStateReason INTERPRETER_RESOURCE_UNAVAILABLE

Недоступен ресурс интерпретатора (например, шрифт или форма).

Подробное описание конструкторов

PrinterStateReason

protected PrinterStateReason(int value)

Создаёт новое значение перечисления причины состояния принтера с заданным целочисленным значением.

Параметры:: value — целочисленное значение

Подробное описание методов

getStringTable

protected String[] getStringTable()

Возвращает таблицу строк для класса PrinterStateReason.

Переопределяет:: getStringTable в классе EnumSyntax
Возвращает:: таблицу строк

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

Возвращает таблицу значений перечисления для класса PrinterStateReason.

Переопределяет:: getEnumValueTable в классе EnumSyntax
Возвращает:: таблицу значений

getCategory

public final Class<? extends Attribute> getCategory()

Получает класс атрибута печати, используемый в качестве «категории» для этого значения атрибута печати.

Для класса PrinterStateReason и любых подклассов, определённых поставщиком, категорией является сам класс PrinterStateReason.

Определено в:: getCategory в интерфейсе Attribute
Возвращает:: класс атрибута печати (категория), экземпляр класса java.lang.Class

getName

public final String getName()

Получает имя категории, экземпляром которой является это значение атрибута.

Для класса PrinterStateReason и любых подклассов, определённых поставщиком, именем категории является "printer-state-reason".

Определено в:: getName в интерфейсе Attribute
Возвращает:: имя категории атрибута

© 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/PrinterStateReason.html