Интерфейс DocPrintJob

PrintService getPrintService()

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

PrintJobAttributeSet getAttributes()

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

void addPrintJobListener(PrintJobListener listener)

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

void removePrintJobListener(PrintJobListener listener)

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

void addPrintJobAttributeListener(PrintJobAttributeListener listener, PrintJobAttributeSet attributes)

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

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

void removePrintJobAttributeListener(PrintJobAttributeListener listener)

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

void print(Doc doc, PrintRequestAttributeSet attributes) throws PrintException

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

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