Интерфейс 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, содержащий DocAttribute, определяет характеристики отдельного документа и параметры печати, которые должны применяться к отдельному документу.
• Набор PrintRequestAttributeSet, содержащий PrintRequestAttribute, определяет параметры, которые должны применяться ко всему заданию печати и ко всем документам в задании печати.
• Набор PrintJobAttributeSet, содержащий PrintJobAttribute, сообщает о состоянии задания печати.
• Набор PrintServiceAttributeSet, содержащий PrintServiceAttribute, сообщает о состоянии экземпляра службы печати.

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

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