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

See Also:

FEATURE_XMLFILTER

public static final String FEATURE_XMLFILTER

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

See Also:

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

SAXTransformerFactory

protected SAXTransformerFactory()

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

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

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Source src) throws TransformerConfigurationException

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

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

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Templates templates) throws TransformerConfigurationException

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

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

newTransformerHandler

public abstract TransformerHandler newTransformerHandler() throws TransformerConfigurationException

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

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

newTemplatesHandler

public abstract TemplatesHandler newTemplatesHandler() throws TransformerConfigurationException

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

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

newXMLFilter

public abstract XMLFilter newXMLFilter(Source src) throws TransformerConfigurationException

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

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

newXMLFilter

public abstract XMLFilter newXMLFilter(Templates templates) throws TransformerConfigurationException

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

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

© 1993, 2023, 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/21/docs/api/java.xml/javax/xml/transform/sax/SAXTransformerFactory.html