Класс StreamPrintServiceFactory

java.lang.Object
- javax.print.StreamPrintServiceFactory

public abstract class StreamPrintServiceFactory
extends Object

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

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

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

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

Конструкторы

Конструктор	Описание
`StreamPrintServiceFactory()`

Методы

Модификатор и тип	Метод	Описание
`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

public 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 , поддерживаемый этой фабрикой