Interface CancelablePrintJob

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

public interface CancelablePrintJob extends DocPrintJob

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

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

Краткое описание методов

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

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

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

Подробное описание методов

cancel

void cancel() throws PrintException

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

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

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

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

Выбрасывает:: PrintException — если задание не удалось успешно отменить

© 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/CancelablePrintJob.html