Интерфейс LSOutput

public interface LSOutput

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

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

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

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

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

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)