Spec-Zone.ru › OpenJDK 21

Пакет javax.xml.transform.sax

package javax.xml.transform.sax
Предоставляет классы преобразования, специфичные для SAX.

Класс SAXSource позволяет задать XMLReader для извлечения событий разбора и InputSource для указания источника SAX.

Класс SAXResult позволяет задать ContentHandler в качестве получателя событий SAX2 от преобразования.

Класс SAXTransformerFactory расширяет TransformerFactory, предоставляя фабричные методы для создания экземпляров TemplatesHandler, TransformerHandler и XMLReader.

Чтобы получить SAXTransformerFactory, вызывающий должен привести экземпляр TransformerFactory, возвращаемый методом TransformerFactory.newInstance(), к нужному типу.

Интерфейс TransformerHandler позволяет создавать преобразования из событий разбора SAX2, представляя собой «толкающий» подход, в отличие от обычно используемого «тянущего» подхода при преобразовании. Обычные события разбора принимаются через интерфейс ContentHandler, лексические события, такие как startCDATA и endCDATA, принимаются через интерфейс LexicalHandler, а события, сигнализирующие о начале или конце отключения экранирования вывода, принимаются через ContentHandler.processingInstruction(java.lang.String, java.lang.String) с параметром target, равным Result.PI_DISABLE_OUTPUT_ESCAPING и Result.PI_ENABLE_OUTPUT_ESCAPING. Если необходимо задать параметры, свойства вывода или другие параметры обработчика преобразования, необходимо получить ссылку на Transformer из TransformerHandler.getTransformer() и вызвать методы по этой ссылке.

Интерфейс TemplatesHandler позволяет создавать объекты Templates из событий разбора SAX2. После завершения событий ContentHandler объект Templates можно получить из TemplatesHandler.getTemplates(). Обратите внимание, что обычно следует вызвать TemplatesHandler.setSystemId(java.lang.String) для определения базового идентификатора системы, по которому могут разрешаться относительные URL-адреса.

Метод SAXTransformerFactory.newXMLFilter(javax.xml.transform.Source) позволяет создать XMLFilter, который инкапсулирует понятие SAX2 «тянущего» преобразования. Полученные XMLFilters можно связать цепочкой, чтобы последовательно выполнялись преобразования, где вывод одного преобразования становится вводом другого.

Since:
1.5
Пакет Описание
javax.xml.transform
Определяет общие API для обработки инструкций преобразования и выполнения преобразования из источника в результат.
javax.xml.transform.dom
Предоставляет классы преобразования, специфичные для DOM.
javax.xml.transform.stax
Предоставляет классы преобразования, специфичные для StAX.
javax.xml.transform.stream
Предоставляет классы преобразования, специфичные для потоков и URI.
Класс Описание
SAXResult
Выступает в качестве держателя для результата преобразования.
SAXSource
Выступает в качестве держателя источника в стиле SAX.
SAXTransformerFactory
Этот класс расширяет TransformerFactory, предоставляя фабричные методы, специфичные для SAX.
TemplatesHandler
Обработчик SAX ContentHandler, который может использоваться для обработки событий разбора SAX (разбор инструкций преобразования) в объект Templates.
TransformerHandler
Обработчик TransformerHandler следит за событиями разбора SAX ContentHandler и преобразует их в результат.

© 1993, 2023, 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/21/docs/api/java.xml/javax/xml/transform/sax/package-summary.html

Spec-Zone.ru

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