Spec-Zone.ru › OpenJDK 17

Класс AttributeSetUtilities

java.lang.Object
javax.print.attribute.AttributeSetUtilities
public final class AttributeSetUtilities extends Object
Класс AttributeSetUtilities предоставляет статические методы для манипулирования AttributeSets.
  • Методы для создания неизменяемых и синхронизированных представлений набора атрибутов.
  • Операции, полезные для построения реализаций интерфейса AttributeSet
**Неизменяемое представление** U набора атрибутов S предоставляет клиенту "только для чтения" доступ к S. Операции запроса на U "считываются" из S; таким образом, изменения в S отражаются в U. Однако любая попытка изменить U, приводит к **исключению**. Объект неизменяемого представления 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, 2021, 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/17/docs/api/java.desktop/javax/print/attribute/AttributeSetUtilities.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API