Преобразователь (Платформа Java SE 7)

java.lang. Объект
- javax.xml.transform. Преобразователь

```
public abstract class Transformer
extends Object
```
Экземпляр этого абстрактного класса может преобразовать исходное дерево в дерево результата.
Экземпляр этого класса может быть получен с TransformerFactory.newTransformer метод. Этот экземпляр может тогда использоваться, чтобы обработать XML от множества источников и записать вывод преобразования во множество приемников.

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

A Transformer может использоваться многократно. Параметры и выходные свойства сохраняются через преобразования.

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`Transformer()` Конструктор по умолчанию защищается нарочно.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`abstract void`	`clearParameters()` Очистите весь набор параметров с setParameter.
`abstract ErrorListener`	`getErrorListener()` Получите ошибочный обработчик событий в действительности для преобразования.
`abstract Properties`	`getOutputProperties()` Получите копию выходных свойств для преобразования.
`abstract String`	`getOutputProperty(String name)` Получите выходное свойство, которое является в действительности для преобразователя.
`abstract Object`	`getParameter(String name)` Получите параметры, которые были явно установлены с setParameter.
`abstract URIResolver`	`getURIResolver()` Получите объект, который будет использоваться, чтобы разрешить URI, используемые в документе ().
`void`	`reset()` Сбросьте это `Transformer` к его исходной конфигурации.
`abstract void`	`setErrorListener(ErrorListener listener)` Установите ошибочного слушателя события в действительности для преобразования.
`abstract void`	`setOutputProperties(Properties oformat)` Установите выходные свойства для преобразования.
`abstract void`	`setOutputProperty(String name, String value)` Установите выходное свойство, которое будет в действительности для преобразования.
`abstract void`	`setParameter(String name, Object value)` Добавьте параметр для преобразования.
`abstract void`	`setURIResolver(URIResolver resolver)` Установите объект, который будет использоваться, чтобы разрешить URI, используемые в документе ().
`abstract void`	`transform(Source xmlSource, Result outputTarget)` Преобразуйте XML `Source` к a `Result`.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - Преобразователь
```
protected Transformer()
```
    Конструктор по умолчанию защищается нарочно.
- Деталь метода
  - сброс
```
public void reset()
```
    Сбросьте это Transformer к его исходной конфигурации.
    
    Transformer сбрасывается к тому же самому состоянию как тогда, когда оно создавалось с TransformerFactory.newTransformer(), TransformerFactory.newTransformer(Source source) или Templates.newTransformer(). reset() разрабатывается, чтобы позволить повторное использование существующих Transformers таким образом сохраняющий ресурсы, связанные с созданием новых Transformers.
    
    Сброс Transformer как гарантируют, не будет иметь то же самое URIResolver или ErrorListener Objects, например. Object.equals(Object obj). Это, как гарантируют, будет иметь функционально равный URIResolver и ErrorListener.
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод.
    С тех пор:
    
    1.5
  - преобразовать
```
public abstract void transform(Source xmlSource,
             Result outputTarget)
                        throws TransformerException
```
    Преобразуйте XML Source к a Result. Определенное поведение преобразования определяется настройками TransformerFactory в действительности, когда Transformer был инстанцирован и любые модификации, сделанные к Transformer экземпляр.
    
    Пустое Source представляется как пустой документ как создано DocumentBuilder.newDocument(). Результат преобразования пустого Source зависит от поведения преобразования; это - не всегда пустое Result.
    
    Параметры:
    xmlSource - Ввод XML, чтобы преобразовать.
    outputTarget - Result из преобразования xmlSource.
    
    Броски:
    
    TransformerException - Если неисправимая ошибка происходит в течение преобразования.
  - setParameter
```
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". Отметьте, что никакой префикс не используется.
    
    Параметры:
    name - Имя параметра, который может начаться с URI пространства имен в изогнутых фигурных скобках ({}).
    value - Объект значения. Это может быть любым допустимым объектом Java. Это до процессора, чтобы обеспечить надлежащее объектное приведение или просто передать объект для использования в расширении.
    
    Броски:
    
    NullPointerException - Если значение является нулем.
  - getParameter
```
public abstract Object getParameter(String name)
```
    Получите параметры, которые были явно установлены с setParameter.
    Этот метод не возвращает значение параметра по умолчанию, которое не может быть определено, пока контекст узла не оценивается во время процесса преобразования.
    
    Параметры:
    name - из Object добраться
    
    Возвраты:
    Параметры, которые были установлены с setParameter.
  - clearParameters
```
public abstract void clearParameters()
```
    Очистите весь набор параметров с setParameter.
  - setURIResolver
```
public abstract void setURIResolver(URIResolver resolver)
```
    Установите объект, который будет использоваться, чтобы разрешить URI, используемые в документе ().
    Если параметром преобразователя будет нуль, то значение URIResolver будет очищено, и у преобразователя больше не будет преобразователя.
    
    Параметры:
    resolver - Объект, который реализует интерфейс URIResolver, или нуль.
  - getURIResolver
```
public abstract URIResolver getURIResolver()
```
    Получите объект, который будет использоваться, чтобы разрешить URI, используемые в документе ().
    
    Возвраты:
    Объект, который реализует интерфейс URIResolver, или нуль.
  - setOutputProperties
```
public abstract void setOutputProperties(Properties oformat)
```
    Установите выходные свойства для преобразования. Эти свойства переопределят набор свойств в Шаблонах с xsl:output.
    Если параметром этой функции является нуль, любые свойства ранее набор удаляется, и значение вернется к значению, определенному в шаблонном объекте.
    
    Передайте квалифицированное ключевое имя свойства как строку с двумя частями, URI пространства имен, включенный в изогнутые фигурные скобки ({}), сопровождаемый локальным именем. Если у имени есть нулевой URL, Строка только содержат локальное имя. Приложение может безопасно проверить на ненулевой URI, тестируя, чтобы видеть, ли первый символ имени' {' символ.
    
    Например, если бы URI и локальное имя были получены из элемента, определенного с помощью <xyz:foo xmlns:xyz = "http://xyz.foo.com/yada/baz.html"/>, то полностью определенное имя было бы" {http://xyz.foo.com/yada/baz.html} foo". Отметьте, что никакой префикс не используется.
    IllegalArgumentException бросается, если какой-либо из ключей параметра не распознается и не является квалифицированным пространством имен.
    
    Параметры:
    oformat - Ряд выходных свойств, которые будут использоваться, чтобы переопределить любое из тех же самых свойств в, влияет для преобразования.
    
    Броски:
    
    IllegalArgumentException - Когда ключи не распознаются и не являются квалифицированным пространством имен.
    См. Также:
    OutputKeys, Properties
  - getOutputProperties
```
public abstract Properties getOutputProperties()
```
    Получите копию выходных свойств для преобразования.
    
    Возвращенные свойства должны содержать свойства, установленные пользователем, и свойствами, установленными таблицей стилей, и эти свойства "принимаются значение по умолчанию" свойствами по умолчанию, определенными разделом 16 из Преобразований XSL (XSLT) Рекомендация W3C. Свойства, которые были определенно установлены пользователем или таблицей стилей, должны быть в основном списке Свойств, в то время как свойства по умолчанию XSLT, которые не были определенно установлены, должны быть списком Свойств по умолчанию. Таким образом, getOutputProperties ().getProperty (Строковый ключ) получит любое свойство в этом, был установлен setOutputProperty(java.lang.String, java.lang.String), setOutputProperties(java.util.Properties), в таблице стилей, или свойствах по умолчанию, в то время как getOutputProperties ().get (Строковый ключ) только получит свойства, которые были явно установлены setOutputProperty(java.lang.String, java.lang.String), setOutputProperties(java.util.Properties), или в таблице стилей.
    
    Отметьте, что мутация возвращенного объекта Свойств не будет производить свойства, которые содержит преобразователь.
    
    Если какой-либо из ключей параметра не будет распознан и не будет квалифицированным пространством имен, то свойство будет проигнорировано и не возвращено. Другими словами поведение не является ортогональным с setOutputProperties.
    
    Возвраты:
    Копия набора выходных свойств в действительности для следующего преобразования.
    См. Также:
    OutputKeys, Properties, Преобразования XSL (XSLT) Версия 1.0
  - setOutputProperty
```
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". Отметьте, что никакой префикс не используется.
    
    Объект Свойств, к которому передали setOutputProperties(java.util.Properties) не будет произведен, вызывая этот метод.
    
    Параметры:
    name - Непустая строка, которая определяет выходное имя свойства, которое может быть квалифицированным пространством имен.
    value - Значение непустой строки выходного свойства.
    
    Броски:
    
    IllegalArgumentException - Если свойство не поддерживается, и не квалифицируется с пространством имен.
    См. Также:
    OutputKeys
  - getOutputProperty
```
public abstract String getOutputProperty(String name)
                                  throws IllegalArgumentException
```
    Получите выходное свойство, которое является в действительности для преобразователя.
    
    Если свойство было установлено, используя setOutputProperty(java.lang.String, java.lang.String), то значение будет возвращено. Иначе, если свойство будет явно определено в таблице стилей, то то значение будет возвращено. Если значение свойства было принято значение по умолчанию, то есть, если никакое значение не было установлено явно ни один с setOutputProperty(java.lang.String, java.lang.String) или в таблице стилей, результат может измениться в зависимости от реализации и ввести таблицу стилей.
    
    Параметры:
    name - Непустая строка, которая определяет выходное имя свойства, которое может быть квалифицированным пространством имен.
    
    Возвраты:
    Строковое значение выходного свойства, или нуль, если никакое свойство не было найдено.
    
    Броски:
    
    IllegalArgumentException - Если свойство не поддерживается.
    См. Также:
    OutputKeys
  - setErrorListener
```
public abstract void setErrorListener(ErrorListener listener)
                               throws IllegalArgumentException
```
    Установите ошибочного слушателя события в действительности для преобразования.
    
    Параметры:
    listener - Новый ошибочный слушатель.
    
    Броски:
    
    IllegalArgumentException - если слушатель является нулем.
  - getErrorListener
```
public abstract ErrorListener getErrorListener()
```
    Получите ошибочный обработчик событий в действительности для преобразования. Реализации должны предоставить ошибочному слушателю по умолчанию.
    
    Возвраты:
    Текущий обработчик ошибок, который никогда не должен быть нулем.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Преобразователь класса

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

Преобразователь

Деталь метода

сброс

преобразовать

setParameter

getParameter

clearParameters

setURIResolver

getURIResolver

setOutputProperties

getOutputProperties

setOutputProperty

getOutputProperty

setErrorListener

getErrorListener