Класс SAXTransformerFactory

java.lang.Object

javax.xml.transform.TransformerFactory

javax.xml.transform.sax.SAXTransformerFactory

public abstract class SAXTransformerFactory extends TransformerFactory

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

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

С момента:: 1.4

Краткое описание полей

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

Краткое описание конструкторов

SAXTransformerFactory()

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

Краткое описание методов

Модификатор и тип	Метод	Описание
`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.

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

newTemplatesHandler

public abstract TemplatesHandler newTemplatesHandler() throws TransformerConfigurationException

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

Возвращает:: Ссылка на непустой TransformerHandler, который может использоваться как 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 не может быть создан.

© 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/SAXTransformerFactory.html