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

Этот пакет реализует SAX2-специфичные API преобразования.

См.: Описание

Сводка интерфейса

Интерфейс	Описание
TemplatesHandler	ContentHandler SAX, который может использоваться, чтобы обработать события синтаксического анализа SAX (анализирующий инструкции преобразования) в Шаблонный объект.
TransformerHandler	TransformerHandler прислушивается к SAX события синтаксического анализа ContentHandler и преобразовывает их к Результату.

Сводка класса

Класс	Описание
SAXResult	Законы как держатель для Результата преобразования.
SAXSource	Законы как держатель для Источника стиля SAX.
SAXTransformerFactory	Этот class расширяет TransformerFactory, чтобы обеспечить специфичные для SAX методы фабрики.

Пакет javax.xml.transform.sax Описание

Этот пакет реализует SAX2-специфичные API преобразования. Это обеспечивает классы, которые позволяют ввод от ContentHandler события, и также классы, которые производят org.xml.sax. События ContentHandler. Это также обеспечивает методы, чтобы установить входной источник как XMLReader, или использовать a InputSource как источник. Это также позволяет создание a XMLFilter, который позволяет преобразованиям "вытянуть" от других преобразований, и позволяет преобразователю, который будет использоваться полиморфно в качестве XMLReader.

SAXSource class позволяет установку XMLReader использоваться для того, чтобы "вытянуть" события синтаксического анализа, и InputSource это может использоваться, чтобы определить источник SAX.

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

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

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

TransformerHandler интерфейс позволяет преобразованию создаваться из событий синтаксического анализа SAX2, который является моделью "нажатия", а не моделью "получения по запросу", которая обычно происходит для преобразования. Нормальные события синтаксического анализа получаются через ContentHandler интерфейс, лексические события, такие как startCDATA и endCDATA получается через LexicalHandler интерфейс, и события, которые сигнализируют запуск или конец отключения выходного выхода, получаются через ContentHandler.processingInstruction(java.lang.String, java.lang.String), с целевым параметром быть Result.PI_DISABLE_OUTPUT_ESCAPING и Result.PI_ENABLE_OUTPUT_ESCAPING. Если параметры, выходные свойства, или другие функции должны быть установлены на обработчике Преобразователя, a Transformer ссылка должна будет быть получена из TransformerHandler.getTransformer(), и методы вызываются из той ссылки.

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

SAXTransformerFactory.newXMLFilter(javax.xml.transform.Source) метод позволяет создание a XMLFilter, который инкапсулирует понятие SAX2 преобразования "получения по запросу". Следующее иллюстрирует несколько преобразований, объединенных в цепочку вместе. Каждый фильтр указывает на родителя XMLReader, и заключительное преобразование вызывается, вызывая XMLReader.parse(org.xml.sax.InputSource) на заключительном читателе в цепочке.