Пакет javax.xml.transform.sax
Класс SAXSource позволяет задать XMLReader для извлечения событий разбора и InputSource для указания источника SAX.
Класс SAXResult позволяет задать ContentHandler в качестве получателя событий SAX2 от преобразования.
Класс SAXTransformerFactory расширяет TransformerFactory, предоставляя методы для создания экземпляров TemplatesHandler, TransformerHandler и XMLReader.
Чтобы получить SAXTransformerFactory, вызывающий должен выполнить приведение типа для экземпляра TransformerFactory, возвращаемого методом TransformerFactory.newInstance().
Интерфейс TransformerHandler позволяет создать преобразование из событий разбора SAX2, что представляет собой "толкающий" (push) подход, в отличие от обычно используемого "вытягивающего" (pull) подхода при преобразовании. Обычные события разбора принимаются через интерфейс 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(). Обратите внимание, что для определения базового системного идентификатора, из которого можно разрешать относительные URL-адреса, обычно необходимо вызвать метод TemplatesHandler.setSystemId(java.lang.String).
Метод SAXTransformerFactory.newXMLFilter(javax.xml.transform.Source) позволяет создать XMLFilter, который инкапсулирует понятие SAX2 "вытягивающего" (pull) преобразования. Результирующий XMLFilters может быть соединен в цепочку, чтобы последовательность преобразований происходила, при этом результат одного преобразования становится входом для следующего.
- Since:
- 1.5
| Класс | Описание |
|---|---|
| SAXResult | Выступает в качестве контейнера для результата преобразования. |
| SAXSource | Выступает в качестве контейнера для источника в стиле SAX. |
| SAXTransformerFactory | Этот класс расширяет TransformerFactory, предоставляя методы для создания экземпляров в стиле SAX. |
| TemplatesHandler | Обработчик SAX ContentHandler, который может использоваться для обработки событий разбора SAX (парсинга инструкций преобразования) в объект Templates. |
| TransformerHandler | Обработчик TransformerHandler прослушивает события разбора SAX ContentHandler и преобразует их в результат. |
© 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/javax/xml/transform/sax/package-summary.html