Класс StreamPrintServiceFactory
public abstract class StreamPrintServiceFactory extends Object
StreamPrintServiceFactory — это фабрика для экземпляров StreamPrintService, которые могут выводить данные в поток в определённом формате документа, описанном как тип MIME. Типичным форматом выходного документа может быть Postscript(TM). Этот класс реализуется службой и обнаруживается реализацией с помощью механизма ServiceLoader.
Приложения находят экземпляры этого класса, вызывая метод lookupStreamPrintServiceFactories(DocFlavor, String).
Приложения могут использовать StreamPrintService, полученный от фабрики, вместо PrintService, представляющего физическое устройство принтера.
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Конструктор для вызова подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract String |
getOutputFormat() |
Запрашивает у фабрики формат документа, создаваемого принтерами, полученными от этой фабрики. |
abstract StreamPrintService |
getPrintService |
Возвращает StreamPrintService, который может выполнять печать в указанный выходной поток. |
abstract DocFlavor[] |
getSupportedDocFlavors() |
Запрашивает у фабрики типы документов, которые могут принимать принтеры, полученные от этой фабрики. |
static StreamPrintServiceFactory[] |
lookupStreamPrintServiceFactories |
Находит фабрики служб печати, которые можно использовать с заданием печати для вывода потока данных в формате, указанном в outputMimeType. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создаёт и возвращает копию этого объекта. |
boolean |
equals |
Показывает, равен ли другой объект этому объекту. |
protected void |
finalize() |
Устарело, планируется удаление: этот элемент API планируется удалить в будущей версии. Финализация устарела и планируется к удалению в одном из следующих выпусков. |
final Class |
getClass() |
Возвращает класс среды выполнения для этого Object. |
int |
hashCode() |
Возвращает хеш-код этого объекта. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
String |
toString() |
Возвращает строковое представление объекта. |
final void |
wait() |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
Подробное описание конструкторов
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.
