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

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

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

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.