Класс JobStateReasons

public final class JobStateReasons
extends HashSet<JobStateReason>
implements PrintJobAttribute

Класс JobStateReasons — это класс атрибута печати, набор значений перечисления, предоставляющий дополнительную информацию о текущем состоянии задания, т. е. информацию, дополняющую значение атрибута задания JobState.

Экземпляры JobStateReason не отображаются в наборе атрибутов задания печати напрямую. Вместо этого атрибут JobStateReasons появляется в наборе атрибутов задания печати. Атрибут JobStateReasons содержит ноль, один или более объектов JobStateReason, относящихся к статусу задания печати. Принтер добавляет объект JobStateReason в атрибут JobStateReasons задания печати, когда соответствующее условие становится истинным для задания печати, и принтер удаляет объект JobStateReason снова, когда соответствующее условие становится ложным, независимо от того, изменился ли общий атрибут JobState задания печати.

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

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

Детали конструкторов

JobStateReasons

public JobStateReasons()

Создает новый пустой атрибут состояния задания; базовый набор имеет значения по умолчанию для начальной емкости и коэффициента загрузки.

JobStateReasons

public JobStateReasons(int initialCapacity)

Создает новый пустой атрибут состояния задания; базовый набор имеет заданную начальную емкость и значение по умолчанию для коэффициента загрузки.

Параметры:

initialCapacity - Начальная емкость.

Исключения:

IllegalArgumentException - если начальная емкость меньше нуля.

JobStateReasons

public JobStateReasons(int initialCapacity,
                       float loadFactor)

Создает новый пустой атрибут состояния задания; базовый набор имеет заданную начальную емкость и коэффициент загрузки.

Параметры:

initialCapacity - Начальная емкость.

loadFactor - Коэффициент загрузки.

Исключения:

IllegalArgumentException - если начальная емкость меньше нуля.

JobStateReasons

public JobStateReasons(Collection<JobStateReason> collection)

Создает новый атрибут состояния задания, содержащий те же объекты JobStateReason, что и заданный набор. Начальная емкость и коэффициент загрузки базового набора определяются конструктором суперкласса HashSet(Collection).

Параметры:

collection - Набор для копирования.

Исключения:

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

ClassCastException - (исключение, не проверяемое) Бросается, если какой-либо элемент в collection не является экземпляром класса JobStateReason.

Методы

add

public boolean add(JobStateReason o)

Добавляет указанный элемент в этот атрибут состояния задания, если он еще не присутствует. Элемент, который должен быть добавлен, должен быть экземпляром класса JobStateReason. Если этот атрибут состояния задания уже содержит указанный элемент, вызов оставляет этот атрибут состояния задания неизменным и возвращает false.

Указано в:

add в интерфейсе Collection<JobStateReason>

Указано в:

add в интерфейсе Set<JobStateReason>

Переопределяет:

add в классе HashSet<JobStateReason>

Параметры:

o - Элемент, который нужно добавить в этот атрибут состояния задания.

Возвращает:

true если этот атрибут состояния задания не содержал указанный элемент.

Исключения:

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

ClassCastException - (исключение, не проверяемое) Бросается, если указанный элемент не является экземпляром класса JobStateReason.

С тех пор как:

1.5

getCategory

public final Class<? extends Attribute> getCategory()

Указано в:

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

Возвращает:

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

getName

public final String getName()

Указано в:

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

Возвращает:

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