Класс 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

Модификатор и тип	Метод	Описание
`void`	`clear()`	Удаляет все элементы из этого множества.
`Object`	`clone()`	Возвращает поверхностную копию этого экземпляра `HashSet`: сами элементы не клонируются.
`boolean`	`contains(Object o)`	Возвращает `true`, если это множество содержит указанный элемент.
`boolean`	`isEmpty()`	Возвращает `true`, если это множество не содержит элементов.
`Iterator<JobStateReason>`	`iterator()`	Возвращает итератор по элементам этого множества.
`static <T> HashSet<T>`	`newHashSet(int numElements)`	Создает новое пустое множество HashSet, подходящее для ожидаемого количества элементов.
`boolean`	`remove(Object o)`	Удаляет указанный элемент из этого множества, если он присутствует.
`int`	`size()`	Возвращает количество элементов в этом множестве (его мощность).
`Spliterator<JobStateReason>`	`spliterator()`	Создает привязанный с задержкой и быстро завершающийся при изменении `Spliterator` для элементов этого множества.
`Object[]`	`toArray()`	Возвращает массив, содержащий все элементы этой коллекции.
`<T> T[]`	`toArray(T[] a)`	Возвращает массив, содержащий все элементы этой коллекции; тип возвращаемого массива во время выполнения совпадает с типом указанного массива.

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

equals, hashCode, removeAll

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этим множеством на равенство.
`int`	`hashCode()`	Возвращает хеш-код этого множества.
`boolean`	`removeAll(Collection<?> c)`	Удаляет из этого множества все элементы, содержащиеся в указанной коллекции (необязательная операция).

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

addAll, containsAll, retainAll, toArray, toArray, toString

Модификатор и тип	Метод	Описание
`boolean`	`addAll(Collection<? extends JobStateReason> c)`	Добавляет все элементы указанной коллекции в эту коллекцию (необязательная операция).
`boolean`	`containsAll(Collection<?> c)`	Возвращает `true`, если эта коллекция содержит все элементы указанной коллекции.
`boolean`	`retainAll(Collection<?> c)`	Сохраняет в этой коллекции только элементы, содержащиеся в указанной коллекции (необязательная операция).
`Object[]`	`toArray()`	Возвращает массив, содержащий все элементы этой коллекции.
`<T> T[]`	`toArray(T[] a)`	Возвращает массив, содержащий все элементы этой коллекции; тип возвращаемого массива во время выполнения совпадает с типом указанного массива.
`String`	`toString()`	Возвращает строковое представление этой коллекции.

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

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

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс этого `Object` во время выполнения.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

parallelStream, removeIf, stream, toArray

Модификатор и тип	Метод	Описание
`default Stream<JobStateReason>`	`parallelStream()`	Возвращает, возможно, параллельный `Stream` с этой коллекцией в качестве источника.
`default boolean`	`removeIf(Predicate<? super JobStateReason> filter)`	Удаляет из этой коллекции все элементы, удовлетворяющие заданному предикату (необязательная операция).
`default Stream<JobStateReason>`	`stream()`	Возвращает последовательный `Stream` с этой коллекцией в качестве источника.
`default <T> T[]`	`toArray(IntFunction<T[]> generator)`	Возвращает массив, содержащий все элементы этой коллекции; для выделения возвращаемого массива используется предоставленная функция `generator`.

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

forEach

Модификатор и тип	Метод	Описание
`default void`	`forEach(Consumer<? super JobStateReason> action)`	Выполняет заданное действие для каждого элемента `Iterable`, пока не будут обработаны все элементы или действие не вызовет исключение.

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

addAll, containsAll, retainAll

Модификатор и тип	Метод	Описание
`boolean`	`addAll(Collection<? extends JobStateReason> c)`	Добавляет все элементы указанной коллекции в это множество, если они еще не присутствуют (необязательная операция).
`boolean`	`containsAll(Collection<?> c)`	Возвращает `true`, если это множество содержит все элементы указанной коллекции.
`boolean`	`retainAll(Collection<?> c)`	Сохраняет в этом множестве только элементы, содержащиеся в указанной коллекции (необязательная операция).

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

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.