Интерфейс LSOutput

public interface LSOutput

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

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

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

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

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

1. LSOutput.characterStream
2. LSOutput.byteStream
3. LSOutput.systemId

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

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

Методы

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)

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

getEncoding

String getEncoding()

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

setEncoding

void setEncoding(String encoding)

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