Класс 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/standard/JobStateReasons.html