Package 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(String, String), где целевым параметром служит Result.PI_DISABLE_OUTPUT_ESCAPING или Result.PI_ENABLE_OUTPUT_ESCAPING. Если для обработчика Transformer нужно задать параметры, свойства вывода или другие характеристики, необходимо получить ссылку на Transformer с помощью TransformerHandler.getTransformer() и вызвать методы для этой ссылки.

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

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