Класс 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 разработан для того, чтобы быть изменяемым; вы можете добавлять объекты 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)`	Создает новый атрибут причин состояния принтера, который содержит те же отображения «причина состояния принтера» — «уровень серьезности», что и заданное отображение.

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

Модификатор и тип	Метод	Описание
`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, 2023, 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/21/docs/api/java.desktop/javax/print/attribute/standard/PrinterStateReasons.html