Spec-Zone.ru › OpenJDK 8

Класс StreamPrintServiceFactory

  • java.lang.Object
    • javax.print.StreamPrintServiceFactory

public abstract class StreamPrintServiceFactory
extends Object

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

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

Приложения находят экземпляры этого класса, вызывая метод 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, который может печатать в указанный поток вывода. Поток вывода создаётся и управляется приложением. Приложение отвечает за закрытие потока и за то, чтобы этот принтер не был повторно использован. Приложение не должно закрывать этот поток, пока любое задание печати, созданное с помощью принтера, не будет завершено. Если это сделать раньше, может быть сгенерирована PrinterException и событие, указывающее на неудачу задания.

В то время как PrintService, подключённый к физическому принтеру, может быть повторно использован, StreamPrintService, подключённый к потоку, нет. Подлежащий StreamPrintService может быть удалён системой печати с помощью метода dispose до возврата из метода print объекта DocPrintJob, чтобы система печати знала, что этот принтер больше не используется. Это эквивалентно отключению физического принтера — навсегда. Приложения могут предоставить пустой поток печати для создания запросываемой службы. Недопустимо создавать задание печати для такого потока. Реализации, которые выделяют ресурсы при создании, должны проверить поток и могут захотеть выделять ресурсы только если поток не null.

Параметры:
out - целевой поток для генерируемого вывода.
Возвращает:
PrintService, который сгенерирует формат, указанный в DocFlavor, поддерживаемый этой фабрикой.

© 1993, 2020, 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API