Класс AttributeSetUtilities

public final class AttributeSetUtilities
extends Object

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

  • Методы для создания неизменяемых и синхронизированных представлений наборов атрибутов.
  • операции, полезные для создания реализаций интерфейса 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 - объект для проверки
interfaceName - интерфейс, который должен реализовывать объект
Возвращает:
Если object является Class, который реализует interfaceName, object возвращается, приведённым к типу Class; в противном случае выбрасывается исключение
Исключение:
NullPointerException - если object является null
ClassCastException - если object не является Class, который реализует interfaceName

verifyAttributeValue

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

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

Параметры:
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, 2020, 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/11/docs/api/java.desktop/javax/print/attribute/AttributeSetUtilities.html

Spec-Zone .ru
спецификации, руководства, описания, API