Класс 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 пространства имён, заключённый в фигурные скобки ({}), за которым следует локальное имя. Если у имени есть null 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 пространства имён, заключённый в фигурные скобки ({}), за которым следует локальное имя. Если у имени есть null 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 по преобразованию 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 пространства имён, заключённый в фигурные скобки ({}), за которым следует локальное имя. Если у имени есть null 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()

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