Класс StreamPrintServiceFactory

java.lang.Object

javax.print.StreamPrintServiceFactory

public abstract class StreamPrintServiceFactory extends Object

Этот класс является фабрикой для экземпляров StreamPrintService, которые могут печатать в потоковый выходной поток в определённом формате документа, описанном как MIME-тип. Типичный формат выходного документа может быть Postscript(TM).

Этот класс реализуется службой и находится с помощью механизма ServiceLoader.

Приложения находят экземпляры этого класса, вызывая метод lookupStreamPrintServiceFactories(DocFlavor, String).

Приложения могут использовать экземпляр StreamPrintService, полученный из фабрики, вместо PrintService, который представляет физическое устройство принтера.

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

StreamPrintServiceFactory()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`abstract String`	`getOutputFormat()`	Опрашивает фабрику для получения формата документа, выводимого принтерами, полученными из этой фабрики.
`abstract StreamPrintService`	`getPrintService(OutputStream out)`	Возвращает `StreamPrintService`, который может печатать в указанный выходной поток.
`abstract DocFlavor[]`	`getSupportedDocFlavors()`	Опрашивает фабрику для получения типов документов, которые могут быть приняты принтерами, полученными из этой фабрики.
`static StreamPrintServiceFactory[]`	`lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType)`	Находит фабрики для служб печати, которые могут быть использованы для задания печати, чтобы вывести поток данных в формате, указанном в `outputMimeType`.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

StreamPrintServiceFactory

protected StreamPrintServiceFactory()

Конструктор для вызова подклассами.

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

lookupStreamPrintServiceFactories

public static StreamPrintServiceFactory[] lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType)

Находит фабрики для служб печати, которые могут быть использованы для задания печати, чтобы вывести поток данных в формате, указанном в outputMimeType.

Параметр outputMimeType описывает тип документа, который вы хотите создать, а параметр flavor описывает формат, в котором приложение предоставит входные данные StreamPrintService.

Хотя null является допустимым значением для поиска служб потоковой печати, обычно ищут определённый желаемый формат, например, Postscript(TM).

Параметры:: flavor - типа входного документа - null означает соответствие всем типам; outputMimeType - представляющий требуемый формат вывода, используемый для идентификации подходящих фабрик для служб потоковой печати. Значение null означает соответствие всем форматам.
Возвращает:: соответствующие фабрики для экземпляра службы потоковой печати, пустое множество, если не было найдено подходящих фабрик

getOutputFormat

public abstract String getOutputFormat()

Опрашивает фабрику для получения формата документа, выводимого принтерами, полученными из этой фабрики.

Возвращает:: формат вывода, описанный как MIME-тип

getSupportedDocFlavors

public abstract DocFlavor[] getSupportedDocFlavors()

Опрашивает фабрику для получения типов документов, которые могут быть приняты принтерами, полученными из этой фабрики.

Возвращает:: массив поддерживаемых типов документов

getPrintService

public abstract StreamPrintService getPrintService(OutputStream out)

Возвращает StreamPrintService, который может печатать в указанный выходной поток. Выходной поток создаётся и управляется приложением. Приложение несёт ответственность за закрытие потока и за то, чтобы этот Printer не был повторно использован. Приложение не должно закрывать этот поток, пока не завершится любая задача печати, созданная с помощью принтера. Раннее закрытие может привести к PrinterException и событию, указывающему на сбой задания.

В то время как PrintService подключённый к физическому принтеру, может быть повторно использован, StreamPrintService подключённый к потоку, не может. Основанный StreamPrintService принтер может быть удалён системой печати с помощью метода dispose перед возвратом из метода print DocPrintJob, чтобы система печати знала, что принтер больше не используется. Это эквивалентно отключению физического принтера - навсегда. Приложения могут предоставить поток печати null для создания запрашиваемой службы. Недопустимо создавать PrintJob для такого потока. Реализации, которые выделяют ресурсы при создании, должны проверить поток и могут захотеть выделить ресурсы только в случае, если поток non-null.

Параметры:: out - целевой поток для сгенерированного вывода
Возвращает:: PrintService который сгенерирует формат, указанный в DocFlavor поддерживаемый этой фабрикой

© 1993, 2023, 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/21/docs/api/java.desktop/javax/print/StreamPrintServiceFactory.html