Пакет javax.print

Предоставляет основные классы и интерфейсы для API Java Print Service. API Java Print Service позволяет клиентским и серверным приложениям:

• Определять и выбирать службы печати на основе их возможностей
• Указывать формат данных печати
• Отправлять задания печати в службы, которые поддерживают тип документа, который нужно напечатать.

Обнаружение служб печати

Приложение вызывает статические методы абстрактного класса PrintServiceLookup, чтобы найти службы печати, которые обладают возможностями удовлетворения запроса на печать приложения. Например, для печати двустороннего документа приложение сначала должно найти принтеры, которые поддерживают двустороннюю печать.

JDK включает PrintServiceLookup реализации, которые могут определять стандартные принтеры платформы. Чтобы найти другие типы принтеров, такие как принтеры IPP или принтеры JINI, поставщик служб печати может написать реализации PrintServiceLookup. Поставщик служб печати может динамически устанавливать эти PrintServiceLookup реализации с помощью средства ServiceLoader.

Определения атрибутов

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

Пакет javax.print.attribute описывает типы атрибутов и способы их объединения в наборы. Пакет javax.print.attribute.standard перечисляет все стандартные атрибуты, поддерживаемые API, большинство из которых являются реализациями атрибутов, указанных в спецификации IETF, RFC 2911 Internet Printing Protocol, 1.1: Model and Semantics, от сентября 2000 года. Атрибуты, указанные в javax.print.attribute.standard, включают общие возможности, такие как: разрешение, количество копий, размеры носителей, приоритет задания и диапазоны страниц.

Спецификация типа документа

Класс DocFlavor представляет формат данных печати, такой как JPEG или PostScript. Объект DocFlavor состоит из MIME-типа, который описывает формат, и имени класса представления документа, который указывает, как документ передается принтеру или потоку вывода. Приложение использует DocFlavor и набор атрибутов, чтобы найти принтеры, которые могут печатать тип документа, указанный DocFlavor, и обладают возможностями, указанными в наборе атрибутов.

Использование API

Типичное приложение, использующее API Java Print Service, выполняет эти шаги для обработки запроса на печать:

1. Выбирает DocFlavor.
2. Создает набор атрибутов.
3. Находит службу печати, которая может обработать запрос на печать в соответствии с DocFlavor и набором атрибутов.
4. Создает объект Doc, содержащий DocFlavor и фактические данные печати, которые могут быть разных форм, включая: файл Postscript, изображение JPEG, URL или обычный текст.
5. Получает задание печати, представленное интерфейсом DocPrintJob, из службы печати.
6. Вызывает метод print задания печати.

Следующий пример кода демонстрирует типичное использование API Java Print Service: поиск принтеров, которые могут печатать пять двусторонних копий документа Postscript на бумаге формата A4, создание задания печати из одной из возвращенных служб печати и вызов печати.

 FileInputStream psStream;
 try {
     psStream = new FileInputStream("file.ps");
 } catch (FileNotFoundException ffne) {
 }
 if (psStream == null) {
     return;
 }
 DocFlavor psInFormat = DocFlavor.INPUT_STREAM.POSTSCRIPT;
 Doc myDoc = new SimpleDoc(psStream, psInFormat, null);
 PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();
 aset.add(new Copies(5));
 aset.add(MediaSizeName.ISO_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 ссылка на параметр null для методов неверна, если явно не указано в документации к методу, что у него есть осмысленная интерпретация. Использование в противном случае является некорректным программированием и может привести к исключению во время выполнения, как немедленно, так и в какой-то момент позже. IllegalArgumentException и NullPointerException являются примерами типичных и приемлемых исключений во время выполнения для таких случаев.