Класс 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 (наименее серьезный), WARNING или ERROR (наиболее серьезный). Принтер добавляет объект PrinterStateReason в атрибут PrinterStateReasons службы печати, когда соответствующее условие становится истинным для принтера, и принтер удаляет объект PrinterStateReason снова, когда соответствующее условие становится ложным, независимо от того, изменился ли общий атрибут PrinterState службы печати.

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

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

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

См. также:

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

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

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

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.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)`	Добавляет указанную причину состояния принтера к этому атрибуту причин состояния принтера, связывая её с заданным уровнем серьезности.

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

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

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

equals, hashCode, toString

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

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

Методы, объявленные в интерфейсе java.util.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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/standard/PrinterStateReasons.html