Класс PrinterStateReasons
- java.lang.Object
-
- java.util.AbstractMap<K,V>
-
- 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) | Создает новый атрибут состояний принтера, содержащий те же сопоставления |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Class<? extends Attribute> | getCategory() | Получить класс атрибута печати, который должен использоваться в качестве «категории» для этого значения атрибута печати. |
String | getName() | Получить имя категории, экземпляром которой является это значение атрибута. |
Set<PrinterStateReason> | printerStateReasonSet(Severity severity) | Получить немодифицируемый набор представлений отдельных атрибутов причины состояния принтера на заданном уровне серьезности в этом атрибуте |
Severity | put(PrinterStateReason reason,
Severity severity) | Добавляет заданную причину состояния принтера к атрибуту состояний принтера, сопоставляя ее с заданным уровнем серьезности. |
Методы, объявленные в классе java.util.HashMap
clear, clone, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, get, isEmpty, keySet, merge, 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".
printerStateReasonSet
public Set<PrinterStateReason> printerStateReasonSet(Severity severity)
Получить неизменяемый набор значений отдельных кодов причин состояния принтера на заданном уровне критичности в этом атрибуте PrinterStateReasons. Каждый элемент в наборе — объект PrinterStateReason. В набор входят только объекты PrinterStateReason, сопоставленные с данным значением уровня критичности. Набор является представлением этого атрибута PrinterStateReasons, поэтому изменения в этом атрибуте PrinterStateReasons отражаются в наборе. Набор не поддерживает добавление или удаление элементов. Итератор набора не поддерживает удаление элементов.
- Параметры:
-
severity- уровень критичности - Возвращает:
- набор представлений отдельных кодов причин состояния принтера
PrinterStateReasonна заданном уровне критичностиSeverity - Исключения:
-
NullPointerException- еслиseverityимеет значениеnull
© 1993, 2020, 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/11/docs/api/java.desktop/javax/print/attribute/standard/PrinterStateReasons.html