Класс Transformer

protected Transformer()

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

public void reset()

Сбрасывает этот Transformer до исходной конфигурации.

Transformer возвращается в то же состояние, в котором находился при создании с помощью TransformerFactory.newTransformer(), TransformerFactory.newTransformer(Source source) или Templates.newTransformer(). reset() предназначен для повторного использования существующих Transformer, что позволяет экономить ресурсы, связанные с созданием новых Transformer.

Для сброшенного Transformer не гарантируется наличие тех же Object URIResolver или ErrorListener, например, равенства, проверяемого с помощью Object.equals(Object obj). Гарантируется функциональное равенство URIResolver и ErrorListener.

public abstract void transform(Source xmlSource, Result outputTarget) throws TransformerException

Преобразует XML Source в Result. Конкретное поведение преобразования определяется настройками TransformerFactory, действующими на момент создания экземпляра Transformer, а также изменениями, внесёнными в экземпляр Transformer.

Пустой Source представляется как пустой документ, созданный с помощью DocumentBuilder.newDocument(). Результат преобразования пустого Source зависит от поведения преобразования; он не всегда является пустым Result.

public abstract void setParameter(String name, Object value)

Добавляет параметр для преобразования.

Передайте квалифицированное имя в виде строки из двух частей: URI пространства имён в фигурных скобках ({}), за которым следует локальное имя. Если URL имени равен null, строка содержит только локальное имя. Приложение может безопасно проверить, что URI не равен null, проверив, является ли первый символ имени символом «{».

Например, если URI и локальное имя получены из элемента, объявленного как <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/>, квалифицированное имя будет иметь вид "{http://xyz.foo.com/yada/baz.html}foo". Обратите внимание, что префикс не используется.

public abstract Object getParameter(String name)

Возвращает параметр, явно заданный с помощью setParameter.

Этот метод не возвращает значение параметра по умолчанию, которое нельзя определить до вычисления контекста узла в процессе преобразования.

public abstract void clearParameters()

Удаляет все параметры, заданные с помощью setParameter.

public abstract void setURIResolver(URIResolver resolver)

Задаёт объект, используемый для разрешения URI в document().

Если аргумент resolver равен null, значение URIResolver будет сброшено, и у преобразователя больше не будет обработчика URI.

public abstract URIResolver getURIResolver()

Возвращает объект, используемый для разрешения URI в document().

public abstract void setOutputProperties(Properties oformat)

Задаёт свойства вывода для преобразования. Эти свойства переопределяют свойства, заданные в Templates с помощью xsl:output.

Если аргумент этой функции равен null, все ранее заданные свойства удаляются, а их значения возвращаются к значениям, определённым в объекте templates.

Передайте квалифицированное имя ключа свойства в виде строки из двух частей: URI пространства имён в фигурных скобках ({}), за которым следует локальное имя. Если URL имени равен null, строка содержит только локальное имя. Приложение может безопасно проверить, что URI не равен null, проверив, является ли первый символ имени символом «{».

Например, если URI и локальное имя получены из элемента, объявленного как <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/>, квалифицированное имя будет иметь вид "{http://xyz.foo.com/yada/baz.html}foo". Обратите внимание, что префикс не используется.

Если какие-либо ключи аргумента не распознаны и не квалифицированы пространством имён, вызывается IllegalArgumentException.

public abstract Properties getOutputProperties()

Возвращает копию свойств вывода для преобразования.

Возвращаемые свойства должны содержать свойства, заданные пользователем, и свойства, заданные таблицей стилей; по умолчанию эти свойства дополняются значениями свойств, указанными в разделе 16 Рекомендации W3C по преобразованиям XSL (XSLT). Свойства, явно заданные пользователем или таблицей стилей, должны находиться в базовом списке Properties, а свойства XSLT по умолчанию, которые не были заданы явно, — в списке Properties по умолчанию. Поэтому getOutputProperties().getProperty(String key) возвращает любое свойство, заданное с помощью setOutputProperty(String, String), setOutputProperties(Properties), в таблице стилей или в свойствах по умолчанию, тогда как getOutputProperties().get(String key) извлекает только свойства, явно заданные с помощью setOutputProperty(String, String), setOutputProperties(Properties) или в таблице стилей.

Обратите внимание, что изменение возвращённого объекта Properties не влияет на свойства, содержащиеся в преобразователе.

Если какие-либо ключи аргумента не распознаны и не квалифицированы пространством имён, соответствующее свойство будет проигнорировано и не возвращено. Иными словами, поведение не является ортогональным по отношению к setOutputProperties.

public abstract void setOutputProperty(String name, String value) throws IllegalArgumentException

Задаёт свойство вывода, которое будет действовать при преобразовании.

Передайте квалифицированное имя свойства в виде строки из двух частей: URI пространства имён в фигурных скобках ({}), за которым следует локальное имя. Если URL имени равен null, строка содержит только локальное имя. Приложение может безопасно проверить, что URI не равен null, проверив, является ли первый символ имени символом «{».

Например, если URI и локальное имя получены из элемента, объявленного как <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/>, квалифицированное имя будет иметь вид "{http://xyz.foo.com/yada/baz.html}foo". Обратите внимание, что префикс не используется.

Вызов этого метода не влияет на объект Properties, переданный в setOutputProperties(Properties).

public abstract String getOutputProperty(String name) throws IllegalArgumentException

Возвращает свойство вывода, действующее для преобразователя.

Если свойство задано с помощью setOutputProperty(String, String), будет возвращено это значение. В противном случае, если свойство явно указано в таблице стилей, будет возвращено указанное там значение. Если значение свойства задано по умолчанию, то есть явно не задано ни с помощью setOutputProperty(String, String), ни в таблице стилей, результат может различаться в зависимости от реализации и входной таблицы стилей.

public abstract void setErrorListener(ErrorListener listener) throws IllegalArgumentException

Задаёт прослушиватель событий ошибок, используемый при преобразовании.

public abstract ErrorListener getErrorListener()

Возвращает обработчик событий ошибок, используемый при преобразовании. Реализации должны предоставлять обработчик ошибок по умолчанию.