Руководство пользователя API Службы печати Java: 2

спецификации, руководства, описания, API

Наборы атрибута

Клиент обычно должен обеспечивать больше чем одну инструкцию обработки, представляя задание печати. Например, клиент, возможно, должен был бы определить носители A4 и альбомную ориентацию. Чтобы отправить больше чем одну инструкцию обработки принтеру, клиент собирает атрибуты, представляющие инструкции в набор атрибута, который API Службы печати Java представляет с интерфейсом AttributeSet.

Интерфейс AttributeSet подобен java.util. Интерфейс карты: это обеспечивает карту ключей к значениям, в которых каждый ключ уникален и может содержать не больше, чем одно значение. Однако, интерфейс AttributeSet разрабатывается, чтобы определенно поддерживать потребности API Службы печати Java. AttributeSet требует что:

Каждый ключ в AttributeSet соответствует категории, и значение ключа может только быть одним из значений атрибута, которые принадлежат категории, представленной ключом. Таким образом, в отличие от Карты, AttributeSet ограничивает возможные значения ключа: категория атрибута не может быть установлена в значение атрибута, которое не принадлежит той категории.
Только атрибуты реализовывая интерфейс Атрибута могут быть добавлены к набору атрибута.
Только один атрибут от определенной категории может существовать в AttributeSet. Например, если набор атрибута уже содержит атрибут Носителей, добавляя, что другой атрибут Носителей перезаписывает первый.

Как единственный атрибут, у набора атрибута есть роль. Роли определяются подынтерфейсами AttributeSet, которые параллельны подынтерфейсам Атрибута, упомянутым в Ролевом разделе Атрибута. Подынтерфейсы AttributeSet: PrintRequestAttributeSet, PrintJobAttributeSet, DocAttributeSet, и PrintServiceAttributeSet. Роль набора атрибута определяет, какие атрибуты это содержит: набор атрибута запроса печати может содержать только атрибуты запроса печати.

API Службы печати Java включает HashAttributeSet как конкретную реализацию интерфейса AttributeSet, но разработчики могут обеспечить свою собственную реализацию. Вместо того, чтобы использовать HashAttributeSet непосредственно, приложения будут чаще использовать один из подклассов HashAttributeSet, которые являются: HashPrintRequestAttributeSet, HashPrintJobAttributeSet, HashDocumentAttributeSet, и HashPrintServiceAttributeSet. Эти подклассы реализуют соответствующие подынтерфейсы AttributeSet. Например PrintRequestAttributeSet расширяет AttributeSet, и HashPrintRequestAttributeSet является конкретной реализацией PrintRequestAttributeSet. Набор атрибута, создаваемый с HashPrintRequestAttributeSet или любой реализацией PrintRequestAttributeSet, может содержать только атрибуты запроса.

В отличие от его подклассов, HashAttributeSet может содержать любой вид атрибута. Приложение использует HashAttributeSet непосредственно, когда оно нуждается в наборе, чтобы содержать больше чем один вид атрибута. Одним примером является набор, возвращенный getUnsupportedAttributes методом PrintService. Неподдерживаемые возвращенные атрибуты могли бы принадлежать больше чем одной роли атрибута.

Как с единственными атрибутами, приложения чаще создадут наборы атрибута запроса, потому что определение запросов печати является первичной функцией приложения печати. Чтобы создать набор атрибута запроса, используйте одного из конструкторов от класса HashPrintRequestAttributeSet:

PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();

Следующий раздел описывает некоторые из более обычно используемых атрибутов, которые можно добавить к набору.

СОДЕРЖАНИЕ | ПРЕДЫДУЩИЙ | NEXT

Свяжитесь с Нами