Класс AttributeSetUtilities

java.lang.Object

javax.print.attribute.AttributeSetUtilities

public final class AttributeSetUtilities extends Object

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

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

Неизменяемое представление U объекта AttributeSet 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)`	Проверяет, равен ли заданный объект категории атрибутов категории заданного объекта значения атрибута.

Методы, объявленные в классе 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 равны null; 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/AttributeSetUtilities.html