Класс AttributeSetUtilities

java.lang.Object

javax.print.attribute.AttributeSetUtilities

public final class AttributeSetUtilities extends Object

Класс AttributeSetUtilities предоставляет статические методы для работы с наборами атрибутов.

Методы для создания неизменяемых и синхронизированных представлений наборов атрибутов.
операции, полезные для реализации интерфейса AttributeSet

Неизменяемое представление U набора атрибутов S предоставляет клиенту «только для чтения» доступ к S. Операции запроса к U обращаются к S; таким образом, изменения в S отражаются в U. Однако любая попытка изменить U приводит к UnmodifiableSetException. Объект неизменяемого представления U будет сериализуемым, если объект набора атрибутов S сериализуем.

Синхронизированное представление V набора атрибутов S предоставляет клиенту синхронизированный (безопасный для нескольких потоков) доступ к S. Каждая операция V синхронизируется с использованием самого V в качестве объекта блокировки, а затем просто вызывает соответствующую операцию S. Для обеспечения взаимной исключительности доступа важно, чтобы весь доступ к S осуществлялся через V. Объект синхронизированного представления V будет сериализуемым, если объект набора атрибутов S сериализуем.

Как упоминается в описании пакета javax.print, параметр ссылки null в методах является неправильным, если явно не указано иное в документации метода, что параметр имеет осмысленное значение. В противном случае использование является неправильным кодированием и может привести к исключению времени выполнения сразу или в какой-то момент позже. IllegalArgumentException и NullPointerException являются примерами типичных и допустимых исключений времени выполнения в таких случаях.

Краткое описание методов

Модификатор и тип	Метод	Описание
`static AttributeSet`	`synchronizedView(AttributeSet attributeSet)`	Создаёт синхронизированное представление заданного набора атрибутов.
`static DocAttributeSet`	`synchronizedView(DocAttributeSet attributeSet)`	Создаёт синхронизированное представление заданного набора атрибутов документа.
`static PrintJobAttributeSet`	`synchronizedView(PrintJobAttributeSet attributeSet)`	Создаёт синхронизированное представление заданного набора атрибутов задания печати.
`static PrintRequestAttributeSet`	`synchronizedView(PrintRequestAttributeSet attributeSet)`	Создаёт синхронизированное представление заданного набора атрибутов запроса на печать.
`static PrintServiceAttributeSet`	`synchronizedView(PrintServiceAttributeSet attributeSet)`	Создаёт синхронизированное представление заданного набора атрибутов службы печати.
`static AttributeSet`	`unmodifiableView(AttributeSet attributeSet)`	Создаёт неизменяемое представление заданного набора атрибутов.
`static DocAttributeSet`	`unmodifiableView(DocAttributeSet attributeSet)`	Создаёт неизменяемое представление заданного набора атрибутов документа.
`static PrintJobAttributeSet`	`unmodifiableView(PrintJobAttributeSet attributeSet)`	Создаёт неизменяемое представление заданного набора атрибутов задания печати.
`static PrintRequestAttributeSet`	`unmodifiableView(PrintRequestAttributeSet attributeSet)`	Создаёт неизменяемое представление заданного набора атрибутов запроса на печать.
`static PrintServiceAttributeSet`	`unmodifiableView(PrintServiceAttributeSet attributeSet)`	Создаёт неизменяемое представление заданного набора атрибутов службы печати.
`static Class<?>`	`verifyAttributeCategory(Object object, Class<?> interfaceName)`	Проверяет, что заданный объект является классом `Class`, реализующим данный интерфейс, который предполагается интерфейсом `Attribute` или его подинтерфейсом.
`static Attribute`	`verifyAttributeValue(Object object, Class<?> interfaceName)`	Проверяет, что заданный объект является экземпляром заданного интерфейса, который предполагается интерфейсом `Attribute` или его подинтерфейсом.
`static void`	`verifyCategoryForValue(Class<?> category, Attribute attribute)`	Проверяет, что заданный объект категории атрибутов равен категории заданного объекта значения атрибута.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробности методов

unmodifiableView

public static AttributeSet unmodifiableView(AttributeSet attributeSet)

Создаёт неизменяемый вид заданного набора атрибутов.

Параметры:: attributeSet - базовый набор атрибутов
Возвращает:: неизменяемый вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

unmodifiableView

public static DocAttributeSet unmodifiableView(DocAttributeSet attributeSet)

Создаёт неизменяемый вид заданного набора атрибутов документа.

Параметры:: attributeSet - базовый набор атрибутов документа
Возвращает:: неизменяемый вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

unmodifiableView

public static PrintRequestAttributeSet unmodifiableView(PrintRequestAttributeSet attributeSet)

Создаёт неизменяемый вид заданного набора атрибутов запроса на печать.

Параметры:: attributeSet - базовый набор атрибутов запроса на печать
Возвращает:: неизменяемый вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

unmodifiableView

public static PrintJobAttributeSet unmodifiableView(PrintJobAttributeSet attributeSet)

Создаёт неизменяемый вид заданного набора атрибутов задания печати.

Параметры:: attributeSet - базовый набор атрибутов задания печати
Возвращает:: неизменяемый вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

unmodifiableView

public static PrintServiceAttributeSet unmodifiableView(PrintServiceAttributeSet attributeSet)

Создаёт неизменяемый вид заданного набора атрибутов службы печати.

Параметры:: attributeSet - базовый набор атрибутов службы печати
Возвращает:: неизменяемый вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

synchronizedView

public static AttributeSet synchronizedView(AttributeSet attributeSet)

Создаёт синхронизированный вид заданного набора атрибутов.

Параметры:: attributeSet - базовый набор атрибутов
Возвращает:: синхронизированный вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

synchronizedView

public static DocAttributeSet synchronizedView(DocAttributeSet attributeSet)

Создаёт синхронизированный вид заданного набора атрибутов документа.

Параметры:: attributeSet - базовый набор атрибутов документа
Возвращает:: синхронизированный вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

synchronizedView

public static PrintRequestAttributeSet synchronizedView(PrintRequestAttributeSet attributeSet)

Создаёт синхронизированный вид заданного набора атрибутов запроса на печать.

Параметры:: attributeSet - базовый набор атрибутов запроса на печать
Возвращает:: синхронизированный вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

synchronizedView

public static PrintJobAttributeSet synchronizedView(PrintJobAttributeSet attributeSet)

Создаёт синхронизированный вид заданного набора атрибутов задания печати.

Параметры:: attributeSet - базовый набор атрибутов задания печати
Возвращает:: синхронизированный вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

synchronizedView

public static PrintServiceAttributeSet synchronizedView(PrintServiceAttributeSet attributeSet)

Создаёт синхронизированный вид заданного набора атрибутов службы печати.

Параметры:: attributeSet - базовый набор атрибутов службы печати
Возвращает:: синхронизированный вид attributeSet
Выбрасывает:: NullPointerException - если attributeSet является null

verifyAttributeCategory

public static Class<?> verifyAttributeCategory(Object object, Class<?> interfaceName)

Проверяет, что данный объект является Class, реализующим заданный интерфейс, который предполагается интерфейсом Attribute или его подинтерфейсом.

Параметры:: object - объект Object для проверки; interfaceName - интерфейс, который должен реализовывать объект
Возвращает:: если object является Class, реализующим interfaceName, то object возвращается, приведённый к типу Class; в противном случае выбрасывается исключение
Выбрасывает:: NullPointerException - если object является null; ClassCastException - если object не является Class, реализующим interfaceName

verifyAttributeValue

public static Attribute verifyAttributeValue(Object object, Class<?> interfaceName)

Проверяет, что данный объект является экземпляром заданного интерфейса, который предполагается интерфейсом Attribute или его подинтерфейсом.

Параметры:: object - объект Object для проверки; interfaceName - интерфейс, экземпляром которого должен быть объект
Возвращает:: если object является экземпляром interfaceName, то object возвращается, приведённый к типу Attribute; в противном случае выбрасывается исключение
Выбрасывает:: NullPointerException - если object является null; ClassCastException - если object не является экземпляром interfaceName

verifyCategoryForValue

public static void verifyCategoryForValue(Class<?> category, Attribute attribute)

Проверяет, что заданный объект категории атрибута равен категории заданного объекта значения атрибута. Если так, этот метод ничего не делает. В противном случае метод выбрасывает исключение.

Параметры:: category - категория атрибута для проверки; attribute - значение атрибута для проверки
Выбрасывает:: NullPointerException - если category или attribute некорректны; IllegalArgumentException - если category не равно категории 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/AttributeSetUtilities.html