Класс 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 предназначен для изменения: к существующему объекту JobStateReasons можно добавлять объекты JobStateReason и удалять их. Однако, как и класс java.util.HashSet, класс JobStateReasons не является потокобезопасным. Если объект JobStateReasons будет использоваться несколькими потоками, обязательно синхронизируйте его операции (например, с помощью синхронизированного представления набора, полученного из класса java.util.Collections).

Совместимость с IPP: Строковое значение, возвращаемое методом toString() каждого объекта JobStateReason, задает значение ключевого слова 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()`	Возвращает имя категории, экземпляром которой является это значение атрибута.

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

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

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

equals, hashCode, removeAll

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

addAll, containsAll, retainAll, toArray, toArray, toString

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

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

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

parallelStream, removeIf, stream, toArray

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

forEach

Методы, объявленные в интерфейсе 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/standard/JobStateReasons.html