Класс JobStateReasons

java.lang.Object

java.util.AbstractCollection<JobStateReason>

java.util.AbstractSet<JobStateReason>

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)`	Добавляет указанный элемент в этот атрибут состояний задания, если он еще не присутствует.
`final Class<? extends Attribute>`	`getCategory()`	Получить класс атрибута печати, который должен использоваться в качестве «категории» для этого значения атрибута печати.
`final String`	`getName()`	Получить имя категории, экземпляром которой является это значение атрибута.

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

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

Методы, объявленные в классе 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

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

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
Возвращает:: имя категории атрибута

© 1993, 2023, 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/21/docs/api/java.desktop/javax/print/attribute/standard/JobStateReasons.html