Интерфейс LSOutput

public interface LSOutput

Этот интерфейс представляет место назначения для вывода данных.

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

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

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

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

LSOutput.characterStream
LSOutput.byteStream
LSOutput.systemId

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

См. также Спецификацию объектной модели документа (DOM) Level 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)

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 «Кодировка символов в сущностях»). Рекомендуется указывать кодировки символов, зарегистрированные (как наборы символов) в Управлении по присвоению номеров в Интернете [IANA-CHARSETS], используя их зарегистрированные названия.

setEncoding

void setEncoding(String encoding)

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