Класс TransformerFactory

Экземпляр TransformerFactory может использоваться для создания объектов Transformer и Templates.

Системная переменная, определяющая, какая реализация фабрики будет создана, называется "javax.xml.transform.TransformerFactory". Эта переменная задаёт конкретный подкласс абстрактного класса TransformerFactory. Если эта переменная не определена, используется платформа по умолчанию.

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

TransformerFactory

protected TransformerFactory()

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

Методы

newInstance

public static TransformerFactory newInstance()
                                      throws TransformerFactoryConfigurationError

Возвращает:

новый экземпляр TransformerFactory, никогда не null.

Издаёт:

TransformerFactoryConfigurationError - Выбрасывается в случае ошибки конфигурации службы или если реализация недоступна или не может быть создана.

newInstance

public static TransformerFactory newInstance(String factoryClassName,
                                             ClassLoader classLoader)
                                      throws TransformerFactoryConfigurationError

java -Djaxp.debug=1 YourProgram ....

Параметры:

factoryClassName - полное квалифицированное имя класса фабрики, предоставляющее реализацию javax.xml.transform.TransformerFactory.

classLoader - ClassLoader для загрузки класса фабрики. Если null используется текущий Thread класс загрузки контекста для загрузки класса фабрики.

Возвращает:

новый экземпляр TransformerFactory, никогда не null.

Издаёт:

TransformerFactoryConfigurationError - если factoryClassName является null, или класс фабрики не может быть загружен, создан.

С момента:

1.6

См. также:

newInstance()

newTransformer

public abstract Transformer newTransformer(Source source)
                                    throws TransformerConfigurationException

Параметры:

source - Source документа XSLT, используемого для создания Transformer. Примеры XML Source включают DOMSource, SAXSource и StreamSource.

Возвращает:

объект Transformer, который может быть использован для выполнения преобразования в одном потоке, никогда не null.

Издаёт:

TransformerConfigurationException - Выбрасывается, если при разборе Source возникли ошибки или невозможно создать экземпляр Transformer.

См. также:

XSL Transformations (XSLT) Version 1.0

newTransformer

public abstract Transformer newTransformer()
                                    throws TransformerConfigurationException

Возвращает:

объект Transformer, который можно использовать для выполнения преобразования в одном потоке, никогда не null.

Издаёт:

TransformerConfigurationException - Когда невозможно создать экземпляр Transformer.

newTemplates

public abstract Templates newTemplates(Source source)
                                throws TransformerConfigurationException

Обработать Source в объект Templates, представляющий собой скомпилированное представление источника. Этот объект Templates можно использовать параллельно в нескольких потоках. Создание объекта Templates позволяет TransformerFactory выполнить подробную оптимизацию производительности инструкций преобразования без наказания времени выполнения преобразования.

Параметры:

source - Объект, содержащий URL, поток ввода и т. д.

Возвращает:

объект Templates, пригодный для преобразования, никогда не null.

Издаёт:

TransformerConfigurationException - При сбое разбора для построения объекта Templates.

getAssociatedStylesheet

public abstract Source getAssociatedStylesheet(Source source,
                                               String media,
                                               String title,
                                               String charset)
                                        throws TransformerConfigurationException

Параметры:

source - XML-документ-источник.

media - Атрибут media для сопоставления. Может быть null, в этом случае будут использованы предпочтительные шаблоны (т. е. alternate = no).

title - Значение атрибута title для сопоставления. Может быть null.

charset - Значение атрибута charset для сопоставления. Может быть null.

Возвращает:

объект Source Object, подходящий для передачи в TransformerFactory.

Издаёт:

TransformerConfigurationException - Исключение Exception выбрасывается, если произошла ошибка при разборе source.

См. также:

Associating Style Sheets with XML documents Version 1.0

setURIResolver

public abstract void setURIResolver(URIResolver resolver)

Установить объект, который по умолчанию используется во время преобразования для разрешения URI, используемых в document(), xsl:import или xsl:include.

Параметры:

resolver - Объект, реализующий интерфейс URIResolver, или null.

getURIResolver

public abstract URIResolver getURIResolver()

Получить объект, используемый по умолчанию во время преобразования для разрешения URI, используемых в document(), xsl:import или xsl:include.

Возвращает:

URIResolver, установленный с помощью setURIResolver.

setFeature

public abstract void setFeature(String name,
                                boolean value)
                         throws TransformerConfigurationException

Параметры:

name - Имя функции.

value - Состояние функции true или false.

Издаёт:

TransformerConfigurationException - если этот TransformerFactory или Transformer или Template не поддерживает эту функцию.

NullPointerException - Если параметр name равен null.

getFeature

public abstract boolean getFeature(String name)

Параметры:

name - Имя функции.

Возвращает:

Текущее состояние функции, true или false.

Исключения:

NullPointerException - Если параметр name равен null.

setAttribute

public abstract void setAttribute(String name,
                                  Object value)

Параметры:

name - Название атрибута.

value - Значение атрибута.

Исключения:

IllegalArgumentException - Когда реализация не распознает атрибут.

getAttribute

public abstract Object getAttribute(String name)

Позволяет пользователю получить определенные атрибуты в базовой реализации. Если базовая реализация не распознает атрибут, будет выброшено исключение IllegalArgumentException.

Параметры:

name - Имя атрибута.

Возвращает:

Значение атрибута.

Исключения:

IllegalArgumentException - Когда реализация не распознает атрибут.

setErrorListener

public abstract void setErrorListener(ErrorListener listener)

Устанавливает обработчик событий ошибок для TransformerFactory, который используется для обработки инструкций преобразования, а не самого преобразования. Исключение IllegalArgumentException будет выброшено, если обработчик событий ошибок ErrorListener является null.

Параметры:

listener - Новый обработчик ошибок.

Исключения:

IllegalArgumentException - Когда listener является null

getErrorListener

public abstract ErrorListener getErrorListener()

Получить обработчик событий ошибок для TransformerFactory.

Возвращает:

Текущий обработчик ошибок, который никогда не должен быть null.