Интерфейс 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

Модификатор и тип	Метод	Описание
`void`	`addPrintJobAttributeListener(PrintJobAttributeListener listener, PrintJobAttributeSet attributes)`	Регистрирует слушателя для отслеживания изменений указанных атрибутов.
`void`	`addPrintJobListener(PrintJobListener listener)`	Регистрирует слушателя для отслеживания событий, возникающих во время этого задания печати.
`PrintJobAttributeSet`	`getAttributes()`	Возвращает набор атрибутов печати этого задания печати.
`PrintService`	`getPrintService()`	Определяет объект `PrintService`, с которым связан этот объект задания печати.
`void`	`print(Doc doc, PrintRequestAttributeSet attributes)`	Печатает документ с указанными атрибутами задания.
`void`	`removePrintJobAttributeListener(PrintJobAttributeListener listener)`	Удаляет слушателя атрибутов из этого задания печати.
`void`	`removePrintJobListener(PrintJobListener listener)`	Удаляет слушателя из этого задания печати.

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

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.