Spec-Zone.ru › OpenJDK 24

Интерфейс LSOutput

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

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

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

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

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

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

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

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

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)
Идентификатор системы, ссылка 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] используя их зарегистрированные имена.

Отправить отчет об ошибке или предложить улучшение
Для получения дополнительной справки по API и документации для разработчиков см. Документацию Java SE, которая содержит более подробные, ориентированные на разработчиков описания с концептуальными обзорами, определениями терминов, решениями и примерами рабочего кода. Другие версии.
Java — товарный знак или зарегистрированный товарный знак Oracle и/или ее дочерних компаний в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 США.
Все права защищены. Использование регулируется условиями лицензии и политикой перераспределения документации.
DRAFT 24-ea+36-Debian-1

© 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/ls/LSOutput.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API