Интерфейс CancelablePrintJob

Все суперинтерфейсы:: DocPrintJob

public interface CancelablePrintJob
extends DocPrintJob

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

Разработчикам служб рекомендуется реализовать этот необязательный интерфейс и передать событие PrintJobEvent.JOB_CANCELED всем слушателям, если задание было успешно отменено с помощью реализации этого интерфейса. Службы также должны учитывать, что реализация этого метода может выполняться в отдельном потоке клиента, отличном от того, который сделал запрос печати. Таким образом, реализация этого интерфейса должна быть потокобезопасной.

Методы

Модификатор и тип	Метод	Описание
`void`	`cancel()`	Останавливает дальнейшую обработку задания печати.

Методы, объявленные в интерфейсе javax.print.DocPrintJob

addPrintJobAttributeListener, addPrintJobListener, getAttributes, getPrintService, print, removePrintJobAttributeListener, removePrintJobListener

Методы

cancel

void cancel()
     throws PrintException

Останавливает дальнейшую обработку задания печати.

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

Служба выбросит PrintException, если отмена не удалась. Задание, которое ещё не было отправлено на печать, должно выбросить это исключение. Отмена уже успешно отменённого задания печати не считается ошибкой и всегда будет успешной.

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

Throws:: PrintException - если задание не может быть успешно отменено