Класс 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, строка содержит только локальное имя. Приложение может безопасно проверить на null 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, строка содержит только локальное имя. Приложение может безопасно проверить на null 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 спецификации 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, строка содержит только локальное имя. Приложение может безопасно проверить на null 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()

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