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

Модификатор и тип	Класс	Описание
`static class`	`AbstractMap.SimpleEntry<K,V>`	Запись, содержащая ключ и значение.
`static class`	`AbstractMap.SimpleImmutableEntry<K,V>`	Неизменяемая запись, содержащая ключ и значение.

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

Map.Entry<K,V>

Модификатор и тип	Интерфейс	Описание
`static interface`	`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

Модификатор и тип	Метод	Описание
`void`	`clear()`	Удаляет все сопоставления из этой карты.
`Object`	`clone()`	Возвращает поверхностную копию этого экземпляра `HashMap`: сами ключи и значения не клонируются.
`Severity`	`compute(PrinterStateReason key, BiFunction<? super PrinterStateReason, ? super Severity, ? extends Severity> remappingFunction)`	Пытается вычислить сопоставление для указанного ключа и его текущего сопоставленного значения либо `null`, если текущего сопоставления нет (необязательная операция).
`Severity`	`computeIfAbsent(PrinterStateReason key, Function<? super PrinterStateReason, ? extends Severity> mappingFunction)`	Если указанному ключу еще не сопоставлено значение (или ему сопоставлено `null`), пытается вычислить его значение с помощью заданной функции сопоставления и добавить его в эту карту, если результат не равен `null` (необязательная операция).
`Severity`	`computeIfPresent(PrinterStateReason key, BiFunction<? super PrinterStateReason, ? super Severity, ? extends Severity> remappingFunction)`	Если для указанного ключа имеется ненулевое значение, пытается вычислить новое сопоставление на основе ключа и его текущего сопоставленного значения (необязательная операция).
`boolean`	`containsKey(Object key)`	Возвращает `true`, если эта карта содержит сопоставление для указанного ключа.
`boolean`	`containsValue(Object value)`	Возвращает `true`, если в этой карте один или несколько ключей сопоставлены с указанным значением.
`Set<Map.Entry<PrinterStateReason, Severity>>`	`entrySet()`	Возвращает представление сопоставлений, содержащихся в этой карте, в виде `Set`.
`Severity`	`get(Object key)`	Возвращает значение, сопоставленное с указанным ключом, или `null`, если эта карта не содержит сопоставления для ключа.
`boolean`	`isEmpty()`	Возвращает `true`, если эта карта не содержит сопоставлений ключ-значение.
`Set<PrinterStateReason>`	`keySet()`	Возвращает представление ключей, содержащихся в этой карте, в виде `Set`.
`Severity`	`merge(PrinterStateReason key, Severity value, BiFunction<? super Severity, ? super Severity, ? extends Severity> remappingFunction)`	Если указанному ключу еще не сопоставлено значение или сопоставлено значение null, связывает его с заданным ненулевым значением (необязательная операция).
`static <K,V> HashMap<K,V>`	`newHashMap(int numMappings)`	Создает новую пустую HashMap, подходящую для ожидаемого количества сопоставлений.
`void`	`putAll(Map<? extends PrinterStateReason, ? extends Severity> m)`	Копирует все сопоставления из указанной карты в эту карту.
`Severity`	`remove(Object key)`	Удаляет сопоставление для указанного ключа из этой карты, если оно имеется.
`int`	`size()`	Возвращает количество сопоставлений ключ-значение в этой карте.
`Collection<Severity>`	`values()`	Возвращает представление значений, содержащихся в этой карте, в виде `Collection`.

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

equals, hashCode, toString

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этой картой на равенство.
`int`	`hashCode()`	Возвращает значение хеш-кода этой карты.
`String`	`toString()`	Возвращает строковое представление этой карты.

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

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

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

forEach, getOrDefault, putIfAbsent, remove, replace, replace, replaceAll

Модификатор и тип	Метод	Описание
`default void`	`forEach(BiConsumer<? super PrinterStateReason, ? super Severity> action)`	Выполняет заданное действие для каждой записи этой карты, пока не будут обработаны все записи или действие не вызовет исключение.
`default Severity`	`getOrDefault(Object key, Severity defaultValue)`	Возвращает значение, сопоставленное с указанным ключом, или `defaultValue`, если эта карта не содержит сопоставления для ключа.
`default Severity`	`putIfAbsent(PrinterStateReason key, Severity value)`	Если указанному ключу еще не сопоставлено значение (или ему сопоставлено `null`), сопоставляет ему заданное значение и возвращает `null`; в противном случае возвращает текущее значение (необязательная операция).
`default boolean`	`remove(Object key, Object value)`	Удаляет запись для указанного ключа только в том случае, если в данный момент ему сопоставлено указанное значение (необязательная операция).
`default Severity`	`replace(PrinterStateReason key, Severity value)`	Заменяет запись для указанного ключа только в том случае, если в данный момент ему сопоставлено какое-либо значение (необязательная операция).
`default boolean`	`replace(PrinterStateReason key, Severity oldValue, Severity newValue)`	Заменяет запись для указанного ключа только в том случае, если в данный момент ему сопоставлено указанное значение (необязательная операция).
`default void`	`replaceAll(BiFunction<? super PrinterStateReason, ? super Severity, ? extends Severity> function)`	Заменяет значение каждой записи результатом вызова заданной функции для этой записи, пока не будут обработаны все записи или функция не вызовет исключение (необязательная операция).

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

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.