Интерфейс LSOutput

public interface LSOutput

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

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

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

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

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

LSOutput.characterStream
LSOutput.byteStream
LSOutput.systemId

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

См. также Спецификацию Document Object Model (DOM) Level 3 Load and Save.

Since:: 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, 2021, 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/17/docs/api/java.xml/org/w3c/dom/ls/LSOutput.html