Класс SAXTransformerFactory

java.lang.Object

javax.xml.transform.TransformerFactory

javax.xml.transform.sax.SAXTransformerFactory

public abstract class SAXTransformerFactory extends TransformerFactory

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

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

Начиная с:: 1.4

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

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

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

SAXTransformerFactory()

Модификатор	Конструктор	Описание
`protected`	Конструктор по умолчанию намеренно имеет модификатор 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.

Методы, объявленные в классе TransformerFactory

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

Методы, объявленные в классе Object

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

Подробное описание полей

FEATURE

public static final String FEATURE

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

См. также:

FEATURE_XMLFILTER

public static final String FEATURE_XMLFILTER

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

См. также:

Подробное описание конструкторов

SAXTransformerFactory

protected SAXTransformerFactory()

Конструктор по умолчанию намеренно имеет модификатор protected.

Подробное описание методов

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Source src) throws TransformerConfigurationException

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

Параметры:: src — Source с инструкциями преобразования.
Возвращает:: 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 — Source с инструкциями преобразования.
Возвращает:: Объект 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/javax/xml/transform/sax/SAXTransformerFactory.html