Пакет 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. Вызывает метод печати задания печати.

Следующий пример кода демонстрирует типичное использование 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 являются примерами типичных и допустимых исключений во время выполнения для таких случаев.