Класс 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 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.

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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/javax/xml/transform/sax/SAXTransformerFactory.html