Класс SAXTransformerFactory

java.lang.Object
- javax.xml.transform.TransformerFactory
- - javax.xml.transform.sax.SAXTransformerFactory

public abstract class SAXTransformerFactory
extends TransformerFactory

Этот класс расширяет TransformerFactory, предоставляя методы фабрики, специфичные для SAX. Он предоставляет два типа ContentHandler, один для создания Transformers, а другой для создания объектов Templates.

Если приложение хочет установить ErrorHandler или EntityResolver для XMLReader, используемого во время преобразования, оно должно использовать URIResolver для возврата SAXSource, который предоставляет (с помощью getXMLReader) ссылку на XMLReader.

Since:: 1.4

Поля

Модификатор и тип	Поле	Описание
`static String`	`FEATURE`	Если `TransformerFactory.getFeature(java.lang.String)` возвращает true при передаче этого значения в качестве аргумента, то TransformerFactory, возвращаемый из `TransformerFactory.newInstance()`, можно безопасно привести к типу SAXTransformerFactory.
`static String`	`FEATURE_XMLFILTER`	Если `TransformerFactory.getFeature(java.lang.String)` возвращает true при передаче этого значения в качестве аргумента, то методы `newXMLFilter(Source src)` и `newXMLFilter(Templates templates)` поддерживаются.

Конструкторы

Модификатор	Конструктор	Описание
`protected`	`SAXTransformerFactory()`	Конструктор по умолчанию специально защищен.

Методы

Модификатор и тип	Метод	Описание
`abstract TemplatesHandler`	`newTemplatesHandler()`	Получить объект TemplatesHandler, который может обрабатывать события SAX ContentHandler и преобразовывать их в объект Templates.
`abstract TransformerHandler`	`newTransformerHandler()`	Получить объект TransformerHandler, который может обрабатывать события SAX ContentHandler и преобразовывать их в Result.
`abstract TransformerHandler`	`newTransformerHandler(Source src)`	Получить объект TransformerHandler, который может обрабатывать события SAX ContentHandler и преобразовывать их в Result, основываясь на инструкциях преобразования, указанных в аргументе.
`abstract TransformerHandler`	`newTransformerHandler(Templates templates)`	Получить объект TransformerHandler, который может обрабатывать события SAX ContentHandler и преобразовывать их в Result, основываясь на аргументе Templates.
`abstract XMLFilter`	`newXMLFilter(Source src)`	Создать XMLFilter, который использует указанный Source в качестве инструкций преобразования.
`abstract XMLFilter`	`newXMLFilter(Templates templates)`	Создать XMLFilter, основываясь на аргументе Templates.

Методы, унаследованные от класса javax.xml.transform.TransformerFactory

getAssociatedStylesheet, getAttribute, getErrorListener, getFeature, getURIResolver, newDefaultInstance, newInstance, newInstance, newTemplates, newTransformer, newTransformer, setAttribute, setErrorListener, setFeature, setURIResolver

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Поля

FEATURE

public static final String FEATURE

Если TransformerFactory.getFeature(java.lang.String) возвращает true при передаче этого значения в качестве аргумента, то TransformerFactory, возвращаемый из TransformerFactory.newInstance(), можно безопасно привести к типу SAXTransformerFactory.

См. также:: Постоянные значения полей

FEATURE_XMLFILTER

public static final String FEATURE_XMLFILTER

Если TransformerFactory.getFeature(java.lang.String) возвращает true при передаче этого значения в качестве аргумента, то методы newXMLFilter(Source src) и newXMLFilter(Templates templates) поддерживаются.

См. также:: Постоянные значения полей

Конструкторы

SAXTransformerFactory

protected SAXTransformerFactory()

Конструктор по умолчанию специально защищен.

Методы

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Source src)
                                                  throws TransformerConfigurationException

Получить объект TransformerHandler, который может обрабатывать события SAX ContentHandler и преобразовывать их в Result, основываясь на инструкциях преобразования, указанных в аргументе.

Параметры:: src - Источник инструкций преобразования.
Возвращает:: TransformerHandler, готовый к преобразованию событий SAX.
Исключения:: TransformerConfigurationException - Если по какой-либо причине TransformerHandler не может быть создан.

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Templates templates)
                                                  throws TransformerConfigurationException

Получить объект TransformerHandler, который может обрабатывать события SAX ContentHandler и преобразовывать их в Result, основываясь на аргументе Templates.

Параметры:: templates - Скомпилированные инструкции преобразования.
Возвращает:: TransformerHandler, готовый к преобразованию событий SAX.
Исключения:: TransformerConfigurationException - Если по какой-либо причине TransformerHandler не может быть создан.

newTransformerHandler

public abstract TransformerHandler newTransformerHandler()
                                                  throws TransformerConfigurationException

Получить объект TransformerHandler, который может обрабатывать события SAX ContentHandler и преобразовывать их в Result. Преобразование определено как тождественное (или копирующее) преобразование, например, для копирования серии событий парсинга SAX в дерево DOM.

Возвращает:: Ссылка на не-null TransformerHandler, который может использоваться как ContentHandler для событий парсинга SAX.
Исключения:: TransformerConfigurationException - Если по какой-либо причине TransformerHandler не может быть создан.

newTemplatesHandler

public abstract TemplatesHandler newTemplatesHandler()
                                              throws TransformerConfigurationException

Получить объект TemplatesHandler, который может обрабатывать события SAX ContentHandler и преобразовывать их в объект Templates.

Возвращает:: Ссылка на не-null TemplatesHandler, который может использоваться как ContentHandler для событий парсинга SAX.
Исключения:: TransformerConfigurationException - Если по какой-либо причине TemplatesHandler не может быть создан.

newXMLFilter

public abstract XMLFilter newXMLFilter(Source src)
                                throws TransformerConfigurationException

Создать XMLFilter, который использует указанный Source в качестве инструкций преобразования.

Параметры:: src - Источник инструкций преобразования.
Возвращает:: Объект XMLFilter или null, если эта функция не поддерживается.
Исключения:: TransformerConfigurationException - Если по какой-либо причине TemplatesHandler не может быть создан.

newXMLFilter

public abstract XMLFilter newXMLFilter(Templates templates)
                                throws TransformerConfigurationException

Создать XMLFilter, основываясь на аргументе Templates.

Параметры:: templates - Скомпилированные инструкции преобразования.
Возвращает:: Объект XMLFilter или null, если эта функция не поддерживается.
Исключения:: TransformerConfigurationException - Если по какой-либо причине TemplatesHandler не может быть создан.