Пакет javax.xml.transform.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
| Класс | Описание |
|---|---|
| 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