Класс StreamResult

java.lang.Object

javax.xml.transform.stream.StreamResult

Все реализованные интерфейсы:: Result

public class StreamResult extends Object implements Result

Выступает в качестве контейнера для результата преобразования, который может быть XML, обычным текстом, HTML или какой-либо другой разметкой.

С:: 1.4

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`FEATURE`	Если `TransformerFactory.getFeature(java.lang.String)` возвращает true, при передаче этого значения в качестве аргумента, преобразователь поддерживает вывод результата этого типа.

Поля, объявленные в интерфейсе javax.xml.transform.Result

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

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

Конструктор	Описание
`StreamResult()`	Конструктор по умолчанию без аргументов.
`StreamResult(File f)`	Создает StreamResult из файла.
`StreamResult(OutputStream outputStream)`	Создает StreamResult из потока байтов.
`StreamResult(Writer writer)`	Создает StreamResult из потока символов.
`StreamResult(String systemId)`	Создает StreamResult из URL.

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

Модификатор и тип	Метод	Описание
`OutputStream`	`getOutputStream()`	Получить поток байтов, установленный с помощью setOutputStream.
`String`	`getSystemId()`	Получить идентификатор системы, установленный с помощью setSystemId.
`Writer`	`getWriter()`	Получить поток символов, установленный с помощью setWriter.
`void`	`setOutputStream(OutputStream outputStream)`	Установить поток байтов, в который нужно записать результат.
`void`	`setSystemId(File f)`	Установить идентификатор системы из ссылки `File`.
`void`	`setSystemId(String systemId)`	Установить идентификатор системы, который может быть использован в сопоставлении с потоком байтов или символов, или, если ни один из них не установлен, использовать это значение как URI для записи (вероятно, имя файла).
`void`	`setWriter(Writer writer)`	Установить writer, который должен получить результат.

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

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

Подробное описание полей

FEATURE

public static final String FEATURE

Если TransformerFactory.getFeature(java.lang.String) возвращает true, при передаче этого значения в качестве аргумента, преобразователь поддерживает вывод результата этого типа.

См. также:

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

StreamResult

public StreamResult()

Конструктор по умолчанию без аргументов.

StreamResult

public StreamResult(OutputStream outputStream)

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

Параметры:: outputStream - Действительная ссылка на OutputStream.

StreamResult

public StreamResult(Writer writer)

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

Параметры:: writer - Действительная ссылка на Writer.

StreamResult

public StreamResult(String systemId)

Создает StreamResult из URL.

Параметры:: systemId - Должно быть строковое значение, соответствующее синтаксису URI.

StreamResult

public StreamResult(File f)

Создает StreamResult из файла.

Параметры:: f - Должна быть непустая ссылка на File.

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

setOutputStream

public void setOutputStream(OutputStream outputStream)

Установить поток байтов, в который нужно записать результат. Обычно, поток следует использовать вместо ридера, чтобы преобразователь мог использовать инструкции, содержащиеся в инструкциях преобразования, для управления кодировкой.

Параметры:: outputStream - Действительная ссылка на OutputStream.

getOutputStream

public OutputStream getOutputStream()

Получить поток байтов, установленный с помощью setOutputStream.

Возвращает:: Поток байтов, установленный с помощью setOutputStream, или null, если setOutputStream или конструктор ByteStream не вызывались.

setWriter

public void setWriter(Writer writer)

Установить writer, который должен получить результат. Обычно, поток следует использовать вместо writer, чтобы преобразователь мог использовать инструкции, содержащиеся в инструкциях преобразования, для управления кодировкой. Однако бывают случаи, когда полезно записывать в writer, например, при использовании StringWriter.

Параметры:: writer - Действительная ссылка на Writer.

getWriter

public Writer getWriter()

Получить поток символов, установленный с помощью setWriter.

Возвращает:: Поток символов, установленный с помощью setWriter, или null, если setWriter или конструктор Writer не вызывались.

setSystemId

public void setSystemId(String systemId)

Установить идентификатор системы, который может быть использован в сопоставлении с потоком байтов или символов, или, если ни один из них не установлен, использовать это значение как URI для записи (вероятно, имя файла).

Определено в:: setSystemId в интерфейсе Result
Параметры:: systemId - Идентификатор системы в виде строки URI.

setSystemId

public void setSystemId(File f)

Установить идентификатор системы из ссылки File.

Параметры:: f - Должна быть непустая ссылка на File.

getSystemId

public String getSystemId()

Получить идентификатор системы, установленный с помощью setSystemId.

Определено в:: getSystemId в интерфейсе Result
Возвращает:: Идентификатор системы, установленный с помощью setSystemId, или null, если setSystemId не вызывался.

© 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.xml/javax/xml/transform/stream/StreamResult.html