Класс 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, 2021, 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/17/docs/api/java.desktop/javax/print/StreamPrintServiceFactory.html