Класс Transformer

protected Transformer()

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

public void reset()

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

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

Сброшенный Transformer не гарантирует, что у него будут такие же URIResolver или ErrorListener Object, например, 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, строка содержит только локальное имя. Приложение может безопасно проверить наличие URI, проверив, является ли первый символ имени символом '{'.

Например, если 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 будет очищено, и преобразователь больше не будет иметь разрешителя.

public abstract URIResolver getURIResolver()

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

public abstract void setOutputProperties(Properties oformat)

Установить свойства вывода для преобразования. Эти свойства переопределят свойства, установленные в шаблонах с помощью xsl:output.

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

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

Например, если 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). Свойства, которые были явно установлены пользователем или стилем, должны находиться в базовом списке свойств, а свойства по умолчанию XSLT, которые не были явно установлены, должны быть в списке свойств по умолчанию. Таким образом, getOutputProperties().getProperty(String key) получит любое свойство, которое было установлено с помощью setOutputProperty(java.lang.String, java.lang.String), setOutputProperties(java.util.Properties), в стиле или свойства по умолчанию, тогда как getOutputProperties().get(String key) получит только свойства, явно установленные с помощью setOutputProperty(java.lang.String, java.lang.String), setOutputProperties(java.util.Properties) или в стиле.

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

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

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

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

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

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

Объект Properties, переданный setOutputProperties(java.util.Properties), не будет затронут вызовом этого метода.

public abstract String getOutputProperty(String name) throws IllegalArgumentException

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

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

public abstract void setErrorListener(ErrorListener listener) throws IllegalArgumentException

Установить обработчик событий об ошибках, действующий для преобразования.

public abstract ErrorListener getErrorListener()

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