Класс StreamPrintServiceFactory

java.lang.Object

javax.print.StreamPrintServiceFactory

public abstract class StreamPrintServiceFactory extends Object

Фабрика StreamPrintServiceFactory создает экземпляры 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`.

Методы, объявленные в классе 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, 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/StreamPrintServiceFactory.html