Пакет 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: протокол интернет-печати, версия 1.1: модель и семантика от сентября 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) {}
}

Обратите внимание: в API javax.print параметр-ссылка null для методов является недопустимым, если только в документации к методу явно не указано, что он имеет смысловую интерпретацию. Использование такого параметра вопреки этому правилу является ошибкой в коде и может привести к исключению во время выполнения — немедленно или позднее. IllegalArgumentException и NullPointerException являются примерами типичных и допустимых исключений во время выполнения в таких случаях.