Пакет javax.print.attribute

Обеспечивает классы и интерфейсы, которые описывают типы атрибутов Службы печати ^JavaTM и как они могут быть собраны в наборы атрибута.

См.: Описание

Интерфейсная Сводка

Интерфейс	Описание
Атрибут	Интерфейсный Атрибут является основным интерфейсом, реализованным любым и каждым классом атрибута печати, чтобы указать, что класс представляет атрибут печати.
AttributeSet	Интерфейсный AttributeSet определяет интерфейс для ряда атрибутов печати.
DocAttribute	Интерфейсный DocAttribute является интерфейсом тегирования, который класс атрибута печати реализует, чтобы указать, что атрибут обозначает установку для документа.
DocAttributeSet	Интерфейсный DocAttributeSet определяет интерфейс для ряда атрибутов документа, то есть.
PrintJobAttribute	PrintJobAttribute является интерфейсом тегирования, который класс атрибута печати реализует, чтобы указать, что атрибут описывает состояние Задания Печати или некоторую другую характеристику Задания Печати.
PrintJobAttributeSet	Интерфейсный PrintJobAttributeSet определяет интерфейс для ряда атрибутов задания печати, то есть.
PrintRequestAttribute	Интерфейсный PrintRequestAttribute является интерфейсом тегирования, который класс атрибута печати реализует, чтобы указать, что атрибут обозначает требуемую установку для задания печати.
PrintRequestAttributeSet	Интерфейсный PrintRequestAttributeSet определяет интерфейс для ряда атрибутов запроса печати, то есть.
PrintServiceAttribute	Интерфейсный PrintServiceAttribute является интерфейсом тегирования, который класс атрибута печати реализует, чтобы указать, что атрибут описывает состояние Службы печати или некоторую другую характеристику Службы печати.
PrintServiceAttributeSet	Интерфейсный PrintServiceAttributeSet определяет интерфейс для ряда атрибутов задания печати, то есть.
SupportedValuesAttribute	Интерфейсный SupportedValuesAttribute является интерфейсом тегирования, который класс атрибута печати реализует, чтобы указать, что атрибут описывает поддерживаемые значения для другого атрибута.

Сводка класса

Класс	Описание
AttributeSetUtilities	Класс AttributeSetUtilities обеспечивает статические методы для того, чтобы они управляли AttributeSets.
DateTimeSyntax	DateTimeSyntax класса является абстрактным базовым классом, обеспечивающим общую реализацию всех атрибутов, значение которых является датой и время.
EnumSyntax	Класс EnumSyntax является абстрактным базовым классом, обеспечивающим общую реализацию всего "безопасного с точки зрения типов перечисления" объекты.
HashAttributeSet	Класс HashAttributeSet обеспечивает AttributeSet реализация с характеристиками карты хеша.
HashDocAttributeSet	HashDocAttributeSet класса обеспечивает набор атрибута, который наследовал его реализацию от класса HashAttributeSet и осуществляет семантические ограничения интерфейса DocAttributeSet.
HashPrintJobAttributeSet	HashPrintJobAttributeSet класса обеспечивает набор атрибута, который наследовал его реализацию от класса HashAttributeSet и осуществляет семантические ограничения интерфейса PrintJobAttributeSet.
HashPrintRequestAttributeSet	Класс HashPrintRequestAttributeSet наследовал свою реализацию от класса HashAttributeSet и осуществляет семантические ограничения интерфейса PrintRequestAttributeSet.
HashPrintServiceAttributeSet	HashPrintServiceAttributeSet класса обеспечивает набор атрибута, который наследовал его реализацию от класса HashAttributeSet и осуществляет семантические ограничения интерфейса PrintServiceAttributeSet.
IntegerSyntax	Класс IntegerSyntax является абстрактным базовым классом, обеспечивающим общую реализацию всех атрибутов с целочисленными значениями.
ResolutionSyntax	Класс ResolutionSyntax является абстрактным базовым классом, обеспечивающим общую реализацию всех атрибутов, обозначающих разрешение принтера.
SetOfIntegerSyntax	SetOfIntegerSyntax класса является абстрактным базовым классом, обеспечивающим общую реализацию всех атрибутов, значение которых является рядом неотрицательных целых чисел.
Size2DSyntax	Класс Size2DSyntax является абстрактным базовым классом, обеспечивающим общую реализацию всех атрибутов, обозначающих размер в двух размерностях.
TextSyntax	TextSyntax класса является абстрактным базовым классом, обеспечивающим общую реализацию всех атрибутов, значение которых является строкой.
URISyntax	URISyntax класса является абстрактным базовым классом, обеспечивающим общую реализацию всех атрибутов, значение которых является Универсальным Идентификатором ресурса (URI).

Сводка исключения

Исключение	Описание
UnmodifiableSetException	Брошенный, чтобы указать, что требуемая работа не может быть выполнена, потому что набор неподдающийся изменению.

Пакет javax.print.attribute Описание

Обеспечивает классы и интерфейсы, которые описывают типы атрибутов Службы печати ^JavaTM и как они могут быть собраны в наборы атрибута.

Каков Атрибут?

Устанавливая задание печати, клиент определяет две вещи: данные печати и инструкции обработки. Данные печати являются фактическим контентом, который будет напечатан. Инструкции обработки говорят принтер, как напечатать данные печати, такие как: какие носители использовать, сколько копий, чтобы напечатать, и напечатать ли на одном или обеих сторонах листа. Клиент определяет эти инструкции обработки с определениями атрибута API Службы печати Java.

Данные печати и инструкции обработки являются отдельными объектами. Это означает что:

• Можно напечатать те же самые данные печати в разное время, используя различные инструкции обработки.
  Например, можно напечатать представление понижения US отчет размера буквы, двусторонний, сшитый, 20 копий, чтобы сделать рекламные проспекты для разговора; и Вы могли напечатать то же самое представление понижения US диапозитивы размера буквы, односторонние, одна копия, чтобы сделать фактические слайды для разговора.
• Можно использовать те же самые инструкции обработки в разное время, чтобы напечатать различные данные. Например, Вы могли установить свои инструкции обработки значения по умолчанию в: US бумага размера буквы, дважды примкнутая, сшитая. Всякий раз, когда Вы печатаете задание, оно печатает с этими настройками, если Вы явно не переопределяете их.

Инструкция обработки не определяет, как задание печати обрабатывает запрос; каждая инструкция обработки является только описанием результатов задания печати. Задание печати определяет способ, которым оно достигает результатов, определенных инструкциями обработки. Представление обработки инструкций как дескриптивные элементы обеспечивает больше гибкости для того, чтобы оно реализовало задания печати.

Категории атрибута и Значения

У каждого принтера есть ряд возможностей, таких как возможность напечатать на различных форматах бумаги или возможности напечатать больше чем одну копию. У каждой из возможностей есть диапазон значений. Например, у возможности ориентации принтера мог бы быть этот диапазон значений: [среда, портрет]. Для каждого запроса печати возможность устанавливается в одно из этих значений. API Службы печати Java использует категорию атрибута термина, чтобы послать к возможности принтера и термину значение атрибута обратиться к значению возможности.

В API Службы печати Java категория атрибута представляется классом Java, реализовывая интерфейс Атрибута. Значения атрибута являются экземплярами такого класса или одним из его подклассов. Например, чтобы определить число копий, приложение создает экземпляр класса Копий с числом требуемых копий и использует Copies экземпляр как часть запроса печати. В этом случае, Copies класс представляет категорию атрибута, и Copies экземпляр представляет значение атрибута.

Роли атрибута

Представляя задание печати принтеру, клиент обеспечивает атрибуты, описывающие характеристики данных печати, такие как название документа, и как данные печати должны быть напечатаны, такой как двусторонние, пять копий. Если задание печати состоит из многократных частей данных печати, у различных частей могли бы быть различные инструкции обработки, такие как 8 x 11-дюймовых носителей для первого документа, и 11 x 17-дюймовых носителей для другого документа.

Как только принтер начинает обрабатывать задание печати, дополнительная информация о задании становится доступной, который мог бы включать: состояние задания (такой как завершено или поставлено в очередь) и число страниц, напечатанных до сих пор. Эти сведения являются также атрибутами. Атрибуты могут также описать принтер непосредственно, такой как: имя принтера, расположение принтера, и число заданий поставлены в очередь.

API Службы печати Java определяет эти различные виды атрибутов с пятью подынтерфейсами Attribute:

• DocAttribute определяет характеристику отдельного документа и настроек задания печати, которые будут применены к отдельному документу.
• PrintRequestAttribute определяет установку, которой применяются к целое задание печати и ко всем документам на задании печати.
• PrintJobAttribute сообщает о состоянии задания печати.
• PrintServiceAttribute сообщает о состоянии службы печати.
• SupportedValuesAttribute дает поддерживаемые значения для другого атрибута.

Каждый класс атрибута реализует один или больше этих подынтерфейсов тегирования, чтобы указать, где атрибут может использоваться в API. Если класс атрибута реализует многократные подынтерфейсы тегирования, атрибут может использоваться в многократных контекстах. Например, атрибут носителей может примениться к одному документу на задании печати как a DocAttribute или ко всему заданию печати как a PrintRequestAttribute. Определенные низкоуровневые атрибуты никогда не используются самостоятельно, но всегда агрегированы в высокоуровневые атрибуты. Эти низкоуровневые классы атрибута только реализуют интерфейсный Атрибут, не любой из подынтерфейсов тегирования.

API Службы печати Java определяет группу стандартных классов атрибута, смоделированных на атрибуты в интернет-Протоколе Печати (IPP) версия 1.1. Стандартные классы атрибута находятся в подпакете javax.print.attribute.standard, чтобы сохранить фактические классы атрибута, концептуально отделяются от универсального аппарата, определенного в пакете javax.print.attribute.

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

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

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

1. Каждый ключ AttributeSet соответствует категории, и значение ключа может только быть одним из значений атрибута, которые принадлежат категории, представленной ключом. Таким образом, в отличие от a Map, AttributeSet ограничивает возможные значения ключа: категория атрибута не может быть установлена в значение атрибута, которое не принадлежит той категории.
2. Никакие два атрибута от той же самой категории не могут существовать в том же самом наборе. Например, набор атрибута не должен содержать и "односторонний" атрибут и "двухсторонний" атрибут, потому что эти два атрибута дают принтеру конфликтные инструкции.
3. Только атрибуты реализовывая Attribute интерфейс может быть добавлен к набору.

javax.print.attribute пакет включает HashAttributeSet как конкретную реализацию интерфейса набора атрибута. HashAttributeSet обеспечивает набор атрибута, основанный на карте хеша. Можно использовать эту реализацию или обеспечить Вашу собственную реализацию интерфейса AttributeSet.

API Службы печати Java обеспечивает четыре специализации набора атрибута, которые ограничиваются, чтобы содержать только один из четырех видов атрибутов, как обсуждено в Роли атрибутаразделе :

• DocAttributeSet
• PrintRequestAttributeSet
• PrintJobAttributeSet
• PrintServiceAttributeSet

Заметьте, что только четыре вида наборов атрибута перечисляются здесь, но есть пять видов атрибутов. Интерфейсный SupportedValuesAttribute обозначает атрибут, который дает поддерживаемые значения для другого атрибута. Атрибуты поддерживаемых значений никогда не агрегированы в наборы атрибута, таким образом нет никакого подынтерфейса набора атрибута, определенного для них.

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

Пакет javax.print.attribute включает одну конкретную реализацию каждого из подынтерфейсов набора атрибута:

• HashDocAttributeSet
• HashPrintRequestAttributeSet,
• HashPrintJobAttributeSet,
• HashPrintServiceAttributeSet.

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

Проект Класса атрибута

Значение атрибута является небольшим, атомарным элементом данных, таким как целое число или перечисляемое значение. API Службы печати Java не использует примитивные типы данных, такие как интервал, чтобы представить значения атрибута по этим причинам:

• Примитивные типы данных не безопасны с точки зрения типов. Например, компилятор не должен позволить значению атрибута "копий" использоваться для атрибута "сторон".
• Некоторые атрибуты должны быть представлены как запись нескольких значений. Одним примером является разрешение принтера, которое требует двух чисел, таких как 600 и 300 представлений 600 x 300 точек на дюйм.

Для безопасности типов и представлять все атрибуты однородно, API Службы печати Java определяет каждую категорию атрибута как класс, такой как класс Copies, Стороны класса, и класс PrinterResolution. Каждый класс атрибута обертывает один или более примитивных элементов данных, содержащих значение атрибута. Операции присвоения атрибута выполняют частые сравнения между объектами категории атрибута, добавляя атрибуты, находя существующие атрибуты в той же самой категории, и ища атрибут, данный его категорию. Поскольку категория атрибута представляется классом, быстрые сравнения значения атрибута могут быть выполнены с Class.equals метод.

Даже при том, что API Службы печати Java включает большое количество различных категорий атрибута, есть только несколько различных типов значений атрибута. Большинство атрибутов может быть представлено небольшим количеством типов данных, таких как: целочисленные значения, целочисленные диапазоны, текст, или перечисление целочисленных значений. Тип значения атрибута, которое принимает категория, вызывают абстрактным синтаксисом атрибута. Чтобы обеспечить непротиворечивость и уменьшить дублирование кода, API Службы печати Java определяет классы абстрактного синтаксиса, чтобы представить каждый абстрактный синтаксис, и эти классы используются в качестве родителя стандартных атрибутов когда бы ни было возможно. Классы абстрактного синтаксиса:

• EnumSyntax обеспечивает безопасное с точки зрения типов перечисление, в котором представляются перечисляемые значения, поскольку одиночный элемент возражает. Каждый одиночный элемент перечисления является экземпляром класса перечисления, который обертывает скрытое международное значение.
• IntegerSyntax является абстрактным синтаксисом для оцененных целому числу атрибутов.
• TextSyntax является абстрактным синтаксисом для оцененных тексту атрибутов, и включает локаль, дающую естественный язык текстовой строки.
• SetOfIntegerSyntax является абстрактным синтаксисом для атрибутов, представляющих диапазон или набор целых чисел
• ResolutionSyntax является абстрактным синтаксисом для атрибутов, представляющих значения разрешения, такой как 600x300 точки на дюйм.
• Size2DSyntax является абстрактным синтаксисом для атрибутов, представляющих двумерный размер, таких как формат бумаги 8.5 x 11 дюймов.
• DateTimeSyntax является абстрактным синтаксисом для атрибутов, значение которых является датой и время.
• URISyntax является абстрактным синтаксисом для атрибутов, значение которых является Универсальным Индикатором Ресурса.

Классы абстрактного синтаксиса независимы от атрибутов, которые используют их. Фактически, приложения, которые не имеют никакого отношения к печати, могут использовать классы абстрактного синтаксиса. Хотя большинство стандартных классов атрибута расширяет один из классов абстрактного синтаксиса, никакой класс атрибута не обязан расширять один из этих классов. Классы абстрактного синтаксиса просто обеспечивают удобную реализацию, которая может быть совместно использована многими классами атрибута.

Каждый класс атрибута реализует Attribute интерфейс, любой прямо или косвенно, чтобы отметить это как атрибут печати. Класс атрибута, который может появиться в ограниченных наборах атрибута в определенных контекстах также, реализует один или более подынтерфейсов Attribute. Большинство классов атрибута также расширяет соответствующий класс абстрактного синтаксиса, чтобы получить реализацию. Рассмотрите Sides класс атрибута:

public class Sides
  extends EnumSyntax
  implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
  {
  public final Object getCategory()
    {
    return Sides.class;
    }
  ...
  }
  

Начиная с каждого класса атрибута реализации Attribute, каждый класс атрибута должен обеспечить реализацию для getCategory метод, который возвращает категорию атрибута. В случае Sides, getCategory возвраты метода Sides.class. getCategory метод является заключительным, чтобы гарантировать, что любые определенные поставщиком подклассы стандартного класса атрибута появляются в той же самой категории. Каждый объект атрибута является неизменным когда-то созданный так, чтобы ссылки на объект атрибута могли быть розданы свободно. Чтобы получить различное значение атрибута, создайте различный объект атрибута.

Поставщики атрибута

API Службы печати Java разрабатывается так, чтобы поставщики могли:

• определите новые специфичные для поставщика значения для любого стандартного атрибута, определенного в javax.print.attribute.standard.
• определите новые категории атрибута, представляющие собственные возможности принтера поставщика, не уже поддерживаемые стандартными атрибутами.

Чтобы определить новое значение для атрибута, клиент может создать экземпляры таких атрибутов с произвольными значениями во время выполнения. Однако, перечислимый атрибут, используя класс абстрактного синтаксиса EnumSyntax определяет все возможные значения атрибута во время компиляции как одноэлементные экземпляры класса атрибута. Это означает, что новые перечисляемые значения не могут быть созданы во время выполнения. Чтобы определить новые специфичные для поставщика значения для стандарта перечисленный атрибут, поставщик должен определить новый класс атрибута, определяющий новые одноэлементные экземпляры. Гарантировать, что новое падение значений атрибута той же самой категории как стандартные значения атрибута, новый класс атрибута должен быть подклассом стандартного класса атрибута.

Чтобы определить новую категорию атрибута, поставщик определяет новый класс атрибута. Этот класс атрибута, как стандартные классы атрибута, реализации Attribute или один из его подынтерфейсов и расширяет класс абстрактного синтаксиса. Поставщик может или использовать существующий класс абстрактного синтаксиса или определить новый. Новый определенный поставщиком атрибут может использоваться везде, где Attribute используется, такой как в AttributeSet.

Используя Атрибуты

Типичное приложение печати использует PrintRequestAttributeSet потому что атрибуты запроса печати являются типами атрибутов, которые обычно определяет клиент. Этот пример демонстрирует, как создавать набор атрибута атрибутов запроса печати и определять местоположение принтера, который может напечатать документ согласно указанным атрибутам:

FileInputStream psStream;
try {
   psstream = new FileInputStream("file.ps");
} catch (FileNotFoundException ffne) {
}
if (psstream == null) {
    return;
}
//Set the document type.  See the DocFlavor documentation for
//more information.
DocFlavor psInFormat = DocFlavor.INPUT_STREAM.POSTSCRIPT;
Doc myDoc = new SimpleDoc(pstream, psInFormat, null);  
PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();
aset.add(new Copies(5));
aset.add(MediaSize.A4);
aset.add(Sides.DUPLEX);

PrintService[] services = 
                PrintServiceLookup.lookupPrintServices(psInFormat, aset);
if (services.length > 0) {
   DocPrintJob job = services[0].createPrintJob();
   try {
        job.print(myDoc, aset);
   } catch (PrintException pe) {}
}

Пожалуйста, отметьте: В javax.print API нулевой ссылочный параметр к методам является неправильным если явно не задокументировано на методе как наличие значимой интерпретации. Использование наоборот является неправильным кодированием и может привести к исключению времени выполнения или сразу или в некоторое более позднее время. IllegalArgumentException и NullPointerException являются примерами типичных и приемлемых исключений времени выполнения для таких случаев.

С тех пор:

1.4