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

Поля

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

Конструкторы

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

Методы

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