Интерфейс AttributeSet

public interface AttributeSet

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

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

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

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

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

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

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