Интерфейс AttributeSet

public interface AttributeSet

Интерфейс AttributeSet определяет интерфейс для набора атрибутов печати. Атрибут печати — это объект, класс которого реализует интерфейс Attribute.

Набор атрибутов содержит группу значений атрибутов, где дублирующие значения в наборе не допускаются. Кроме того, каждое значение в наборе атрибутов является членом некоторой категории, и в наборе разрешено не более одного значения в любой конкретной категории. Для набора атрибутов значения являются объектами Attribute, а категории — объектами Class. Категория атрибута — это класс (или интерфейс) в корне иерархии классов для этого типа атрибута. Обратите внимание, что категория объекта атрибута может быть суперклассом класса объекта атрибута, а не самим классом объекта атрибута. Категория объекта атрибута определяется вызовом метода getCategory(), определенного в интерфейсе Attribute.

Интерфейсы набора AttributeSet похожи на интерфейс java.util.Map API Java Collections, но более ограничены по принимаемым типам и объединяют ключи и значения в Attribute.

Наборы атрибутов используются в нескольких местах в API Print Service. В каждом контексте разрешены только определенные типы атрибутов, присутствующих в наборе атрибутов, что определяется интерфейсами тегов, которые реализует класс атрибута — DocAttribute, PrintRequestAttribute, PrintJobAttribute и PrintServiceAttribute. Существуют четыре специализации набора атрибутов, которые ограничены содержанием только одного из четырёх типов атрибутов — DocAttributeSet, PrintRequestAttributeSet, PrintJobAttributeSet и PrintServiceAttributeSet соответственно. Обратите внимание, что многие классы атрибутов реализуют более одного интерфейса тегов и поэтому могут присутствовать в нескольких контекстах.

• Набор DocAttributeSet, содержащий DocAttributes, определяет характеристики отдельного документа и параметры печати, применяемые к одному документу.
• Набор PrintRequestAttributeSet, содержащий PrintRequestAttributes, определяет параметры, применяемые к всей работе печати и ко всем документам в этой работе.
• Набор PrintJobAttributeSet, содержащий PrintJobAttributes, сообщает о состоянии работы печати.
• Набор PrintServiceAttributeSet, содержащий PrintServiceAttributes, сообщает о состоянии экземпляра службы печати.

В некоторых контекстах клиенту разрешается только просматривать содержимое набора атрибутов, но не изменять его (набор является только для чтения). В других местах клиенту разрешается как просматривать, так и изменять содержимое набора атрибутов (набор является читаемо-записываемым). Для набора атрибутов только для чтения вызов изменяющей операции вызывает UnmodifiableSetException.

API Print Service предоставляет одну реализацию интерфейса AttributeSet, класс HashAttributeSet. Клиент может использовать класс HashAttributeSet или предоставить собственную реализацию интерфейса AttributeSet. API Print Service также предоставляет реализации подинтерфейсов интерфейса AttributeSet, — классы HashDocAttributeSet, HashPrintRequestAttributeSet, HashPrintJobAttributeSet и HashPrintServiceAttributeSet.