Класс 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 имеют null; IllegalArgumentException - если category не равно категории attribute

© 1993, 2023, 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/21/docs/api/java.desktop/javax/print/attribute/AttributeSetUtilities.html