Класс 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/StreamPrintServiceFactory.html