Интерфейс CancelablePrintJob

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

public interface CancelablePrintJob
extends DocPrintJob

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

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

Методы

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

Наследованные методы из интерфейса javax.print.DocPrintJob

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

Методы

cancel

void cancel()
     throws PrintException

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

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

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

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

Исключения:: PrintException - если задание не может быть успешно отменено.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.