Класс StreamPrintService

java.lang.Object

javax.print.StreamPrintService

Все реализуемые интерфейсы:: PrintService

public abstract class StreamPrintService extends Object implements PrintService

Этот класс является подклассом PrintService и представляет службу печати, которая выводит данные в различных форматах в предоставленный клиентом поток вывода. Она предназначена главным образом для служб, формат вывода которых представляет собой тип документа, пригодный для просмотра или архивирования. Формат вывода должен быть объявлен как тип MIME. Это эквивалентно формату документа вывода, в котором класс представления всегда равен "java.io.OutputStream". Экземпляр класса StreamPrintService получают из экземпляра StreamPrintServiceFactory.

Обратите внимание, что StreamPrintService отличается от PrintService, который поддерживает атрибут Destination. Для StreamPrintService всегда требуется поток вывода, тогда как PrintService может принимать Destination как необязательный параметр. У StreamPrintService нет места назначения по умолчанию для форматированного вывода. Кроме того, предполагается, что StreamPrintService создает вывод в формате, пригодном для использования в других контекстах. От StreamPrintService не требуется поддержка атрибута Destination.

Краткое описание конструкторов

StreamPrintService(OutputStream out)

Модификатор	Конструктор	Описание
`protected`	Создает объект `StreamPrintService`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`dispose()`	Освобождает ресурсы этого `StreamPrintService`.
`abstract String`	`getOutputFormat()`	Возвращает формат документа, создаваемый этой службой печати.
`OutputStream`	`getOutputStream()`	Возвращает поток вывода.
`boolean`	`isDisposed()`	Возвращает `boolean`, указывающий, было ли освобождено это `StreamPrintService`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект какому-либо другому объекту.
`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(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Методы, объявленные в интерфейсе PrintService

addPrintServiceAttributeListener, createPrintJob, equals, getAttribute, getAttributes, getDefaultAttributeValue, getName, getServiceUIFactory, getSupportedAttributeCategories, getSupportedAttributeValues, getSupportedDocFlavors, getUnsupportedAttributes, hashCode, isAttributeCategorySupported, isAttributeValueSupported, isDocFlavorSupported, removePrintServiceAttributeListener

Модификатор и тип	Метод	Описание
`void`	`addPrintServiceAttributeListener(PrintServiceAttributeListener listener)`	Регистрирует прослушиватель событий для этого `PrintService`.
`DocPrintJob`	`createPrintJob()`	Создает и возвращает `PrintJob`, способный обрабатывать данные любого из поддерживаемых форматов документов.
`boolean`	`equals(Object obj)`	Определяет, относятся ли две службы к одной и той же базовой службе.
`<T extends PrintServiceAttribute> T`	`getAttribute(Class<T> category)`	Получает значение указанного атрибута службы.
`PrintServiceAttributeSet`	`getAttributes()`	Получает набор атрибутов описания принтера этой службы печати, определяющих ее состояние.
`Object`	`getDefaultAttributeValue(Class<? extends Attribute> category)`	Определяет значение атрибута печати по умолчанию для этой службы в указанной категории.
`String`	`getName()`	Возвращает строковое имя этой службы печати, которое приложения могут использовать для запроса определенной службы печати.
`ServiceUIFactory`	`getServiceUIFactory()`	Возвращает фабрику компонентов пользовательского интерфейса, позволяющих пользователям взаимодействовать со службой в различных ролях.
`Class<?>[]`	`getSupportedAttributeCategories()`	Определяет категории атрибутов печати, которые клиент может указывать при настройке задания для этой службы печати.
`Object`	`getSupportedAttributeValues(Class<? extends Attribute> category, DocFlavor flavor, AttributeSet attributes)`	Определяет значения атрибутов печати, которые клиент может указывать в данной категории при настройке задания для этой службы печати.
`DocFlavor[]`	`getSupportedDocFlavors()`	Определяет форматы данных печати, которые клиент может указать при настройке задания для этого `PrintService`.
`AttributeSet`	`getUnsupportedAttributes(DocFlavor flavor, AttributeSet attributes)`	Определяет атрибуты, не поддерживаемые для запроса на печать в контексте определенного `DocFlavor`.
`int`	`hashCode()`	Этот метод следует реализовать согласованно с `equals(Object)`.
`boolean`	`isAttributeCategorySupported(Class<? extends Attribute> category)`	Определяет, может ли клиент указать данную категорию атрибутов печати при настройке задания для этой службы печати.
`boolean`	`isAttributeValueSupported(Attribute attrval, DocFlavor flavor, AttributeSet attributes)`	Определяет, может ли клиент указать данное значение атрибута печати при настройке задания для этой службы печати.
`boolean`	`isDocFlavorSupported(DocFlavor flavor)`	Определяет, поддерживает ли эта служба печати определенный `DocFlavor`.
`void`	`removePrintServiceAttributeListener(PrintServiceAttributeListener listener)`	Удаляет прослушиватель службы печати из этой службы печати.

Подробное описание конструкторов

StreamPrintService

protected StreamPrintService(OutputStream out)

Создает объект StreamPrintService.

Параметры:: out — поток, в который следует отправлять форматированные данные печати

Подробное описание методов

getOutputStream

public OutputStream getOutputStream()

Возвращает поток вывода.

Возвращает:: поток, в который эта служба будет отправлять форматированные данные печати

getOutputFormat

public abstract String getOutputFormat()

Возвращает формат документа, создаваемый этой службой печати. Должен быть указан в формате типа MIME, совместимом с компонентами MIME-типа в DocFlavors

Возвращает:

тип MIME, определяющий формат вывода

См. также:

dispose

public void dispose()

Освобождает ресурсы этого StreamPrintService. Если службу потоковой печати нельзя использовать повторно, ее необходимо освободить, чтобы указать на это. Обычно этот метод вызывает клиент. Службы, записывающие данные, к которым нельзя осмысленно дописать новые данные, также могут освободить поток. Сам поток при этом не закрывается. Он лишь помечается как больше не используемый этой службой.

isDisposed

public boolean isDisposed()

Возвращает boolean, указывающий, было ли освобождено это StreamPrintService. Если этот объект был освобожден, метод вернет true. Службы и клиентские приложения используют этот метод, чтобы определить, в какие потоки больше не следует записывать данные.

Возвращает:: true, если это StreamPrintService было освобождено; в противном случае — false

© 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.