Класс PrinterStateReasons

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 объектом, соединенные дефисом ("-") между ними, дают значение ключевого слова IPP. Имя категории, возвращаемое getName() , предоставляет имя атрибута IPP.

Конструкторы

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()

Определено в:

getCategory в интерфейсе Attribute

Возвращает:

Класс атрибута печати (категория), экземпляр класса java.lang.Class.

getName

public final String getName()

Определено в:

getName в интерфейсе Attribute

Возвращает:

Имя категории атрибута.

printerStateReasonSet

public Set<PrinterStateReason> printerStateReasonSet(Severity severity)

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

Параметры:

severity - Уровень серьезности.

Возвращает:

Представление набора отдельных атрибутов PrinterStateReason на заданном уровне Severity.

Исключения:

NullPointerException - (исключение, не проверяемое при выполнении) Бросается, если severity равно null.