Пакет 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, создание задания печати из одной из возвращенных служб печати и вызов метода print.

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