Класс 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, предоставляющий (с помощью getXMLReader) ссылку на XMLReader.

Начиная с:: 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`	Конструктор по умолчанию намеренно объявлен защищённым.

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

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

Модификатор и тип	Метод	Описание
`abstract Source`	`getAssociatedStylesheet(Source source, String media, String title, String charset)`	Получает спецификации таблиц стилей, связанные с документом XML `Source` с помощью инструкции обработки xml-stylesheet, которые соответствуют заданным критериям.
`abstract Object`	`getAttribute(String name)`	Позволяет пользователю получать определённые атрибуты базовой реализации.
`abstract ErrorListener`	`getErrorListener()`	Получает обработчик событий ошибок для TransformerFactory.
`abstract boolean`	`getFeature(String name)`	Получает значение свойства.
`abstract URIResolver`	`getURIResolver()`	Получает объект, используемый по умолчанию во время преобразования для разрешения URI, используемых в document(), xsl:import или xsl:include.
`static TransformerFactory`	`newDefaultInstance()`	Создаёт новый экземпляр встроенной реализации `TransformerFactory`, используемой по умолчанию в системе.
`static TransformerFactory`	`newInstance()`	Получает новый экземпляр `TransformerFactory`.
`static TransformerFactory`	`newInstance(String factoryClassName, ClassLoader classLoader)`	Получает новый экземпляр `TransformerFactory` по имени класса фабрики.
`abstract Templates`	`newTemplates(Source source)`	Обрабатывает Source и создаёт объект Templates, представляющий собой скомпилированное представление источника.
`abstract Transformer`	`newTransformer()`	Создаёт новый `Transformer`, выполняющий копирование `Source` в `Result`, то есть «тождественное преобразование».
`abstract Transformer`	`newTransformer(Source source)`	Обрабатывает `Source` и создаёт `Transformer` `Object`.
`abstract void`	`setAttribute(String name, Object value)`	Позволяет пользователю задавать определённые атрибуты базовой реализации.
`abstract void`	`setErrorListener(ErrorListener listener)`	Задаёт обработчик событий ошибок для TransformerFactory, который используется при обработке инструкций преобразования, а не при выполнении самого преобразования.
`abstract void`	`setFeature(String name, boolean value)`	Задаёт свойство для этого `TransformerFactory` и созданных этой фабрикой `Transformer` или `Template`.
`abstract void`	`setURIResolver(URIResolver resolver)`	Задаёт объект, используемый по умолчанию во время преобразования для разрешения URI, используемых в document(), xsl:import или xsl:include.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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()

Конструктор по умолчанию намеренно объявлен защищённым.

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

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, 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.