Класс JobStateReasons

java.lang.Object
- java.util.AbstractCollection<E>
- - java.util.AbstractSet<E>
  - - java.util.HashSet<JobStateReason>
    - - javax.print.attribute.standard.JobStateReasons

Все реализованные интерфейсы:: Serializable, Cloneable, Iterable<JobStateReason>, Collection<JobStateReason>, Set<JobStateReason>, Attribute, PrintJobAttribute

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()`	Создает новый пустой атрибут состояния задания; лежащий в основе набор имеет значения по умолчанию для начальной емкости и коэффициента загрузки.
`JobStateReasons(int initialCapacity)`	Создает новый пустой атрибут состояния задания; лежащий в основе набор имеет заданную начальную емкость и коэффициент загрузки по умолчанию.
`JobStateReasons(int initialCapacity, float loadFactor)`	Создает новый пустой атрибут состояния задания; лежащий в основе набор имеет заданную начальную емкость и коэффициент загрузки.
`JobStateReasons(Collection<JobStateReason> collection)`	Создает новый атрибут состояния задания, содержащий те же объекты `JobStateReason`, что и в заданном наборе.

Методы

Модификатор и тип	Метод	Описание
`boolean`	`add(JobStateReason o)`	Добавляет указанный элемент в этот атрибут состояния задания, если он еще не присутствует.
`Class<? extends Attribute>`	`getCategory()`	Получить класс атрибута печати, который должен использоваться в качестве "категории" для этого значения атрибута печати.
`String`	`getName()`	Получить имя категории, экземпляром которой является это значение атрибута.

Методы, объявленные в классе java.util.HashSet

clear, clone, contains, isEmpty, iterator, remove, size, spliterator

Методы, объявленные в классе java.util.AbstractSet

equals, hashCode, removeAll

Методы, объявленные в классе java.util.AbstractCollection

addAll, containsAll, retainAll, toArray, toArray, toString

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

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

Методы, объявленные в интерфейсе java.util.Collection

parallelStream, removeIf, stream, toArray

Методы, объявленные в интерфейсе java.lang.Iterable

forEach

Методы, объявленные в интерфейсе java.util.Set

addAll, containsAll, equals, hashCode, removeAll, retainAll, toArray, toArray

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

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

Получить класс атрибута печати, который должен использоваться в качестве "категории" для этого значения атрибута печати.

Для класса JobStateReasons, категорией является сам класс JobStateReasons.

Задано в:: getCategory в интерфейсе Attribute
Возвращает:: класс атрибута печати (категория), экземпляр класса java.lang.Class

getName

public final String getName()

Получить имя категории, экземпляром которой является это значение атрибута.

Для класса JobStateReasons имя категории — "job-state-reasons".

Задано в:: getName в интерфейсе Attribute
Возвращает:: имя категории атрибута