Класс AttributeSetUtilities
public final class AttributeSetUtilities extends Object
AttributeSetUtilities предоставляет статические методы для манипулирования AttributeSets. - Методы для создания неизменяемых и синхронизированных представлений набора атрибутов.
- Операции, полезные для построения реализаций интерфейса
AttributeSet
**Синхронизированное представление** V набора атрибутов S предоставляет клиенту синхронизированный (безопасный для множественных потоков) доступ к S. Каждая операция V синхронизируется с использованием самого V в качестве объекта блокировки, а затем просто вызывает соответствующую операцию S. Для гарантии взаимной исключительности доступа крайне важно, чтобы все обращения к S осуществлялись через V. Объект синхронизированного представления V будет сериализуем, если объект набора атрибутов S сериализуем.
Как указано в описании пакета javax.print, ссылка параметра null к методам некорректна, если явно не задокументировано в методе, имея осмысленное толкование. Использование в противном случае является неправильным кодированием и может привести к исключению во время выполнения сразу или впоследствии. IllegalArgumentException и NullPointerException являются примерами типичных и приемлемых исключений во время выполнения для таких случаев.
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
static AttributeSet |
synchronizedView |
Создаёт синхронизированное представление заданного набора атрибутов. |
static DocAttributeSet |
synchronizedView |
Создаёт синхронизированное представление заданного набора атрибутов документа. |
static PrintJobAttributeSet |
synchronizedView |
Создаёт синхронизированное представление заданного набора атрибутов задания печати. |
static PrintRequestAttributeSet |
synchronizedView |
Создаёт синхронизированное представление заданного набора атрибутов запроса на печать. |
static PrintServiceAttributeSet |
synchronizedView |
Создаёт синхронизированное представление заданного набора атрибутов службы печати. |
static AttributeSet |
unmodifiableView |
Создаёт неизменяемое представление заданного набора атрибутов. |
static DocAttributeSet |
unmodifiableView |
Создаёт неизменяемое представление заданного набора атрибутов документа. |
static PrintJobAttributeSet |
unmodifiableView |
Создаёт неизменяемое представление заданного набора атрибутов задания печати. |
static PrintRequestAttributeSet |
unmodifiableView |
Создаёт неизменяемое представление заданного набора атрибутов запроса на печать. |
static PrintServiceAttributeSet |
unmodifiableView |
Создаёт неизменяемое представление заданного набора атрибутов службы печати. |
static Class<?> |
verifyAttributeCategory |
|
static Attribute |
verifyAttributeValue |
Проверяет, является ли заданный объект экземпляром заданного интерфейса, который предполагается интерфейсом Attribute или его подинтерфейсом. |
static void |
verifyCategoryForValue |
Проверяет, равен ли заданный объект категории атрибутов категории заданного объекта значения атрибута. |
Подробное описание методов
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