Интерфейс LSOutput

public interface LSOutput

Данный интерфейс представляет собой пункт назначения вывода данных.

Этот интерфейс позволяет приложению инкапсулировать информацию о пункте назначения вывода в одном объекте, который может включать URI, байтовый поток (возможно, со специфицированной кодировкой), базовый URI и/или символьный поток.

Точные определения байтового и символьного потоков зависят от связки.

Приложение должно предоставлять объекты, реализующие этот интерфейс, когда такие объекты необходимы. Приложение может либо предоставить свои собственные объекты, реализующие этот интерфейс, либо использовать общий фабричный метод DOMImplementationLS.createLSOutput() для создания объектов, реализующих этот интерфейс.

LSSerializer будет использовать объект LSOutput для определения, куда сериализовать вывод. LSSerializer будет анализировать различные указанные в LSOutput выходы в следующем порядке, чтобы узнать, куда выводить, первый не нулевой и не пустой будет использован:

LSOutput.characterStream
LSOutput.byteStream
LSOutput.systemId

Объекты LSOutput принадлежат приложению. Реализация DOM никогда не будет их изменять (хотя может создавать копии и изменять копии, если необходимо).

См. также Спецификацию загрузки и сохранения объекта документа (DOM) уровня 3.

С:: 1.5

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

Модификатор и тип	Метод	Описание
`OutputStream`	`getByteStream()`	Атрибут языка и зависящий от связки тип, представляющий поток байтов для записи.
`Writer`	`getCharacterStream()`	Атрибут языка и зависящий от связки тип, представляющий поток для записи 16-битных единиц.
`String`	`getEncoding()`	Кодировка символов для вывода.
`String`	`getSystemId()`	Идентификатор системы, ссылка URI [IETF RFC 2396], для этого пункта назначения вывода.
`void`	`setByteStream(OutputStream byteStream)`	Атрибут языка и зависящий от связки тип, представляющий поток байтов для записи.
`void`	`setCharacterStream(Writer characterStream)`	Атрибут языка и зависящий от связки тип, представляющий поток для записи 16-битных единиц.
`void`	`setEncoding(String encoding)`	Кодировка символов для вывода.
`void`	`setSystemId(String systemId)`	Идентификатор системы, ссылка URI [IETF RFC 2396], для этого пункта назначения вывода.

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

getCharacterStream

Writer getCharacterStream()

Атрибут языка и зависящий от связки тип, представляющий поток для записи 16-битных единиц.

setCharacterStream

void setCharacterStream(Writer characterStream)

Атрибут языка и зависящий от связки тип, представляющий поток для записи 16-битных единиц.

getByteStream

OutputStream getByteStream()

Атрибут языка и зависящий от связки тип, представляющий поток байтов для записи.

setByteStream

void setByteStream(OutputStream byteStream)

Атрибут языка и зависящий от связки тип, представляющий поток байтов для записи.

getSystemId

String getSystemId()

Идентификатор системы, ссылка URI [IETF RFC 2396], для этого пункта назначения вывода.
Если идентификатор системы — это относительная ссылка URI (см. раздел 5 в [IETF RFC 2396]), поведение зависит от реализации.

setSystemId

void setSystemId(String systemId)

getEncoding

String getEncoding()

Кодировка символов для вывода. Кодировка должна быть строкой, допустимой для объявления кодировки XML ([XML 1.0] раздел 4.3.3 "Кодировка символов в сущностях"), рекомендуется использовать зарегистрированные имена кодировок символов (в качестве наборов символов), зарегистрированные в Internet Assigned Numbers Authority [IANA-CHARSETS].

setEncoding

void setEncoding(String encoding)

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.xml/org/w3c/dom/ls/LSOutput.html