Интерфейс DocPrintJob

PrintService getPrintService()

Определяет объект PrintService, к которому привязана эта задача печати.

PrintJobAttributeSet getAttributes()

Получает набор атрибутов печати для этой задачи печати. Возвращаемый объект набора атрибутов является неизменяемым. Возвращаемый объект набора атрибутов представляет собой "снимок" набора атрибутов этой задачи печати на момент вызова метода getAttributes(); то есть содержимое возвращаемого объекта набора атрибутов не будет обновлено, если содержимое набора атрибутов этой задачи печати изменится в будущем. Для обнаружения изменений значений атрибутов вызовите getAttributes() снова и сравните новый набор атрибутов со предыдущим набором атрибутов; или зарегистрируйте слушателя для событий задачи печати. Возвращаемое значение может быть пустым набором, но не должно быть null.

void addPrintJobListener(PrintJobListener listener)

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

void removePrintJobListener(PrintJobListener listener)

Удаляет слушателя из этой задачи печати. Этот метод не выполняет никакой функции и не генерирует исключение, если слушатель, указанный в аргументе, не был ранее добавлен в эту задачу печати. Если слушатель null, исключение не выбрасывается, и никаких действий не выполняется. Если слушатель был зарегистрирован более одного раза, будет удалена только одна из регистраций.

void addPrintJobAttributeListener(PrintJobAttributeListener listener, PrintJobAttributeSet attributes)

Регистрирует слушателя для изменений в указанных атрибутах. Если слушатель null, исключение не выбрасывается, и никаких действий не выполняется. Чтобы определить обновления атрибутов, которые могут быть сообщены этой задачей, клиент может вызвать getAttributes() и определить подмножество, которое представляет интерес и вероятно будет сообщено слушателю. Клиенты, ожидающие обновлений о изменениях в конкретном атрибуте задачи, должны проверить, присутствует ли он в этом наборе, но обновления об атрибуте будут выполнены только если он изменится и это будет обнаружено задачей. Также обновления могут быть объединены задачей. Чтобы минимизировать накладные расходы при обработке задач печати, рекомендуется слушать только ту подмножество атрибутов, которые вероятно изменятся. Если указанный набор пуст, слушателю не будут сообщены никакие обновления атрибутов. Если набор атрибутов null, это означает, что нужно слушать все динамические атрибуты, которые поддерживает задача. Это может привести к отсутствию уведомлений об обновлении, если задача не может сообщить об изменениях атрибутов.

Если слушатель уже зарегистрирован, он будет зарегистрирован снова.

void removePrintJobAttributeListener(PrintJobAttributeListener listener)

Удаляет слушателя атрибутов из этой задачи печати. Этот метод не выполняет никакой функции, и не генерирует исключение, если слушатель, указанный в аргументе, не был ранее добавлен в эту задачу печати. Если слушатель null, исключение не выбрасывается, и никаких действий не выполняется. Если слушатель зарегистрирован более одного раза, даже для разных наборов атрибутов, нет гарантий, какой слушатель будет удален.

void print(Doc doc, PrintRequestAttributeSet attributes) throws PrintException

Печатает документ со специфицированными атрибутами задачи. Этот метод должен вызываться только один раз для данной задачи печати. Его повторный вызов не приведет к отправке новой задачи на принтер. Реализация службы определит политику прерывания и восстановления службы. Когда метод print возвращается, печать может еще не завершиться, так как она может выполняться асинхронно, возможно, в другом потоке. Клиенты приложения, которые хотят отслеживать успех или неудачу, должны зарегистрировать PrintJobListener.

Реализаторы службы печати должны закрывать любые потоки данных печати (например, Reader или InputStream реализации), которые они получают от клиента doc. Надежные клиенты все же могут захотеть это проверить. Исключение всегда генерируется, если документ DocFlavor не может быть распечатан.