Класс 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 являются примерами типичных и приемлемых исключений во время выполнения для таких случаев.

Методы

unmodifiableView

public static AttributeSet unmodifiableView(AttributeSet attributeSet)

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

Параметры:

attributeSet - Базовый набор атрибутов.

Возвращает:

Неизменяемый вид attributeSet.

Исключения:

NullPointerException - Бросается, если attributeSet равно null. 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.

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 равно null или если attribute равно null.

IllegalArgumentException - (исключение без проверки типа) Бросается, если category не равен категории attribute.