Класс PrinterStateReasons

java.lang.Object

java.util.AbstractMap<PrinterStateReason, Severity>

java.util.HashMap<PrinterStateReason, Severity>

javax.print.attribute.standard.PrinterStateReasons

Все реализуемые интерфейсы:: Serializable, Cloneable, Map<PrinterStateReason, Severity>, Attribute, PrintServiceAttribute

public final class PrinterStateReasons extends HashMap<PrinterStateReason, Severity> implements PrintServiceAttribute

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

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

Класс PrinterStateReasons наследует реализацию от класса java.util.HashMap. Каждая запись в карте состоит из объекта PrinterStateReason (ключа), которому сопоставлен объект Severity (значение):

В отличие от большинства атрибутов печати, которые после создания являются неизменяемыми, класс PrinterStateReasons предназначен для изменения: к существующему объекту PrinterStateReasons можно добавлять объекты PrinterStateReason и удалять их. Однако, как и класс java.util.HashMap, класс PrinterStateReasons не является потокобезопасным. Если объект PrinterStateReasons будет использоваться несколькими потоками, обязательно синхронизируйте операции с ним (например, используя синхронизированное представление карты, полученное из класса java.util.Collections).

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

См. также:

Краткое описание вложенных классов

Вложенные классы и интерфейсы, объявленные в классе AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Вложенные классы и интерфейсы, объявленные в интерфейсе Map

Map.Entry<K,V>

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

Конструктор	Описание
`PrinterStateReasons()`	Создает новый пустой атрибут причин состояния принтера; базовая хеш-карта имеет емкость и коэффициент загрузки по умолчанию.
`PrinterStateReasons(int initialCapacity)`	Создает новый пустой атрибут причин состояния принтера; базовая хеш-карта имеет указанную начальную емкость и коэффициент загрузки по умолчанию.
`PrinterStateReasons(int initialCapacity, float loadFactor)`	Создает новый пустой атрибут причин состояния принтера; базовая хеш-карта имеет указанную начальную емкость и коэффициент загрузки.
`PrinterStateReasons(Map<PrinterStateReason, Severity> map)`	Создает новый атрибут причин состояния принтера, содержащий те же соответствия `PrinterStateReason` объектам `Severity`, что и указанная карта.

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

Модификатор и тип	Метод	Описание
`final Class<? extends Attribute>`	`getCategory()`	Возвращает класс атрибута печати, используемый в качестве «категории» для этого значения атрибута печати.
`final String`	`getName()`	Возвращает имя категории, экземпляром которой является это значение атрибута.
`Set<PrinterStateReason>`	`printerStateReasonSet(Severity severity)`	Возвращает неизменяемое представление в виде множества отдельных атрибутов причин состояния принтера с указанным уровнем серьезности в этом атрибуте `PrinterStateReasons`.
`Severity`	`put(PrinterStateReason reason, Severity severity)`	Добавляет указанную причину состояния принтера в этот атрибут причин состояния принтера, связывая ее с указанным уровнем серьезности.

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

clear, clone, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, get, isEmpty, keySet, merge, newHashMap, putAll, remove, size, values

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

equals, hashCode, toString

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

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

Методы, объявленные в интерфейсе Map

equals, forEach, getOrDefault, hashCode, putIfAbsent, remove, replace, replace, replaceAll

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

PrinterStateReasons

public PrinterStateReasons()

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

PrinterStateReasons

public PrinterStateReasons(int initialCapacity)

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

Параметры:: initialCapacity — начальная емкость
Исключения:: IllegalArgumentException — если начальная емкость отрицательна

PrinterStateReasons

public PrinterStateReasons(int initialCapacity, float loadFactor)

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

Параметры:: initialCapacity — начальная емкость; loadFactor — коэффициент загрузки
Исключения:: IllegalArgumentException — если начальная емкость отрицательна

PrinterStateReasons

public PrinterStateReasons(Map<PrinterStateReason, Severity> map)

Создает новый атрибут причин состояния принтера, содержащий те же соответствия PrinterStateReason объектам Severity, что и указанная карта. Начальная емкость и коэффициент загрузки базовой хеш-карты определяются конструктором суперкласса HashMap(Map).

Параметры:: map — карта для копирования
Исключения:: NullPointerException — если map равно null или если какой-либо ключ или значение в map равно null; ClassCastException — если какой-либо ключ в map не является экземпляром класса PrinterStateReason или если какое-либо значение в map не является экземпляром класса Severity

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

put

public Severity put(PrinterStateReason reason, Severity severity)

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

Определено в:: put в интерфейсе Map<PrinterStateReason, Severity>
Переопределяет:: put в классе HashMap<PrinterStateReason, Severity>
Параметры:: reason — причина состояния принтера. Должна быть экземпляром класса PrinterStateReason; severity — уровень серьезности причины состояния принтера. Должен быть экземпляром класса Severity
Возвращает:: предыдущий уровень серьезности, связанный с указанной причиной состояния принтера, или null, если указанная причина состояния принтера отсутствовала
Исключения:: NullPointerException — если reason равно null или severity равно null; ClassCastException — если reason не является экземпляром класса PrinterStateReason или если severity не является экземпляром класса Severity
Начиная с версии:: 1.5

getCategory

public final Class<? extends Attribute> getCategory()

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

Для класса PrinterStateReasons категорией является сам класс PrinterStateReasons.

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

getName

public final String getName()

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

Для класса PrinterStateReasons именем категории является "printer-state-reasons".

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

printerStateReasonSet

public Set<PrinterStateReason> printerStateReasonSet(Severity severity)

Получает неизменяемое представление в виде множества отдельных атрибутов причин состояния принтера с указанным уровнем серьезности в этом атрибуте PrinterStateReasons. Каждый элемент представления-множества является объектом PrinterStateReason. Представление-множество содержит только объекты PrinterStateReason, которым сопоставлено указанное значение серьезности. Представление-множество связано с этим атрибутом PrinterStateReasons, поэтому изменения этого атрибута PrinterStateReasons отражаются в представлении-множестве. Представление-множество не поддерживает добавление или удаление элементов. Итератор представления-множества не поддерживает удаление элементов.

Параметры:: severity — уровень серьезности
Возвращает:: представление-множество отдельных атрибутов PrinterStateReason с указанным уровнем Severity
Исключения:: NullPointerException — если severity равно null

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