TransformerFactory (Платформа Java SE 8 b92)

java.lang. Объект
- javax.xml.transform. TransformerFactory

Прямые Известные Подклассы:

SAXTransformerFactory
```
public abstract class TransformerFactory
extends Object
```
Экземпляр TransformerFactory может использоваться, чтобы создать Transformer и Templates объекты.

Системное свойство, которое определяет, какую реализацию Фабрики создать называют "javax.xml.transform.TransformerFactory". Это свойство называет конкретный подкласс TransformerFactory абстрактный class. Если свойство не определяется, значение по умолчанию платформы, используются.

С тех пор:

1.5

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

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

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

Все Методы Статические Методы Методы экземпляра Абстрактные Методы Конкретные Методы
Модификатор и Тип	Метод и Описание
`abstract Source`	`getAssociatedStylesheet(Source source, String media, String title, String charset)` Свяжите спецификацию (и) таблицы стилей с XML `Source` документ через инструкцию обработки xml-таблицы-стилей, которые соответствуют данные критерии.
`abstract Object`	`getAttribute(String name)` Позволяет пользователю получать определенные атрибуты на базовой реализации.
`abstract ErrorListener`	`getErrorListener()` Получите ошибочный обработчик событий для TransformerFactory.
`abstract boolean`	`getFeature(String name)` Ищите значение функции.
`abstract URIResolver`	`getURIResolver()` Получите объект, который используется по умолчанию во время преобразования, чтобы разрешить URI, используемые в документе (), xsl:import, или xsl:include.
`static TransformerFactory`	`newInstance()` Получите новый экземпляр a `TransformerFactory`.
`static TransformerFactory`	`newInstance(String factoryClassName, ClassLoader classLoader)` Получите новый экземпляр a `TransformerFactory` от фабрики имя class.
`abstract Templates`	`newTemplates(Source source)` Обработайте Источник в Шаблонный объект, который является скомпилированным представлением источника.
`abstract Transformer`	`newTransformer()` Создайте новое `Transformer` это выполняет копию `Source` к `Result`.
`abstract Transformer`	`newTransformer(Source source)` Обработайте `Source` в a `Transformer` `Object`.
`abstract void`	`setAttribute(String name, Object value)` Позволяет пользователю устанавливать определенные атрибуты на базовой реализации.
`abstract void`	`setErrorListener(ErrorListener listener)` Установите ошибочного слушателя события для TransformerFactory, который используется для обработки инструкций преобразования, а не для преобразования непосредственно.
`abstract void`	`setFeature(String name, boolean value)` Установите функцию этого `TransformerFactory` и `Transformer`s или `Template`s создаваемый этой фабрикой.
`abstract void`	`setURIResolver(URIResolver resolver)` Установите объект, который используется по умолчанию во время преобразования, чтобы разрешить URI, используемые в документе (), xsl:import, или xsl:include.

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

- Деталь конструктора
  - TransformerFactory
```
protected TransformerFactory()
```
    Конструктор по умолчанию защищается нарочно.
- Деталь метода
  - newInstance
```
public static TransformerFactory newInstance()
                                      throws TransformerFactoryConfigurationError
```
    Получите новый экземпляр a TransformerFactory. Этот статический метод создает новый экземпляр фабрики.
    
    Этот метод использует следующую упорядоченную процедуру поиска, чтобы определить TransformerFactory реализация class, чтобы загрузиться:
    - Используйте javax.xml.transform.TransformerFactory системное свойство.
    - Используйте файл свойств "lib/jaxp.properties" в каталоге JRE. Этот конфигурационный файл находится в стандарте java.util.Properties отформатируйте и содержит полностью определенное имя реализации class с ключом, являющимся системным свойством, определенным выше.
      jaxp.properties файл только для чтения однажды реализацией JAXP, и это - значения, тогда кэшируются для будущего использования. Если файл не существует, когда первая попытка предпринимается, чтобы читать из него, никакие дальнейшие попытки не предпринимаются, чтобы проверить на ее существование. Не возможно изменить значение любого свойства в jaxp.properties после того, как это было считано впервые.
    - Используйте средства загрузки поставщика услуг, определенные ServiceLoader class, чтобы попытаться расположиться и загрузить реализацию службы.
    - Иначе, реализация системного значения по умолчанию возвращается.
    Как только приложение получило ссылку на a TransformerFactory это может использовать фабрику, чтобы сконфигурировать и получить экземпляры преобразователя.
    Возвраты:
    
    новый экземпляр TransformerFactory, никогда нуль.
    
    Броски:
    
    TransformerFactoryConfigurationError - Брошенный в случае ошибки конфигурации службы или если реализация не доступна или не может быть инстанцирована.
  - newInstance
```
public static TransformerFactory newInstance(String factoryClassName,
                                             ClassLoader classLoader)
                                      throws TransformerFactoryConfigurationError
```
    Получите новый экземпляр a TransformerFactory от фабрики имя class. Эта функция полезна, когда есть многократные провайдеры в пути к классу. Это дает больше контроля к приложению, поскольку это может определить, какой провайдер должен быть загружен.
    
    Как только приложение получило ссылку на a TransformerFactory это может использовать фабрику, чтобы сконфигурировать и получить экземпляры преобразователя.
    
    Подсказка для Поиска и устранения неисправностей
    
    Установка jaxp.debug системное свойство заставит этот метод печатать много сообщений отладки к System.err о каком это делает и где это смотрит на.
    
    Если у Вас есть попытка задач:
```
 java -Djaxp.debug=1 YourProgram ....
 
```
    Параметры:
    
    factoryClassName - полностью определенное имя class фабрики, которое обеспечивает реализацию javax.xml.transform.TransformerFactory.
    
    classLoader - ClassLoader используемый, чтобы загрузить фабрику class. Если null ток Thread's контекст classLoader используется, чтобы загрузить фабрику class.
    
    Возвраты:
    
    новый экземпляр TransformerFactory, никогда нуль.
    
    Броски:
    
    TransformerFactoryConfigurationError - если factoryClassName null, или фабрика class не может быть загружена, инстанцирована.
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    newInstance()
  - newTransformer
```
public abstract Transformer newTransformer(Source source)
                                    throws TransformerConfigurationException
```
    Обработайте Source в a Transformer Object. Source документ XSLT, который приспосабливает Преобразованиям XSL (XSLT) Версии 1.0. Забота должна быть проявлена, чтобы не использовать это Transformer в многократном Threads работающий одновременно. Отличающийся TransformerFactories может использоваться одновременно различным Threads.
    
    Параметры:
    
    source - Source из документа XSLT, используемого, чтобы создать Transformer. Примеры XML Sources включают DOMSource, SAXSource, и StreamSource.
    
    Возвраты:
    
    A Transformer объект, который может использоваться, чтобы выполнить преобразование в сингле Thread, никогда null.
    
    Броски:
    
    TransformerConfigurationException - Брошенный, если есть ошибки, анализируя Source или не возможно создать a Transformer экземпляр.
    
    См. Также:
    
    Преобразования XSL (XSLT) Версия 1.0
  - newTransformer
```
public abstract Transformer newTransformer()
                                    throws TransformerConfigurationException
```
    Создайте новое Transformer это выполняет копию Source к Result. то есть "идентификационные данные преобразовывают".
    
    Возвраты:
    
    Объект Преобразователя, который может использоваться, чтобы не выполнить преобразование в единственном потоке, никогда нуль.
    
    Броски:
    
    TransformerConfigurationException - Когда не возможно создать a Transformer экземпляр.
  - newTemplates
```
public abstract Templates newTemplates(Source source)
                                throws TransformerConfigurationException
```
    Обработайте Источник в Шаблонный объект, который является скомпилированным представлением источника. Это Шаблонный объект может тогда использоваться одновременно через многократные потоки. Создание Шаблонного объекта позволяет TransformerFactory делать детализированную оптимизацию производительности инструкций преобразования, не штрафуя преобразование времени выполнения.
    
    Параметры:
    
    source - Объект, который содержит URL, входной поток, и т.д.
    
    Возвраты:
    
    Шаблонный объект, способный к тому, чтобы быть используемым в целях преобразования, никогда null.
    
    Броски:
    
    TransformerConfigurationException - Анализируя, чтобы создать Шаблоны возражают сбоям.
  - getAssociatedStylesheet
```
public abstract Source getAssociatedStylesheet(Source source,
                                               String media,
                                               String title,
                                               String charset)
                                        throws TransformerConfigurationException
```
    Свяжите спецификацию (и) таблицы стилей с XML Source документ через инструкцию обработки xml-таблицы-стилей, которые соответствуют данные критерии. Отметьте, что возможно возвратить несколько таблиц стилей, когда они применяются, как будто они были списком импорта или каскадов в единственной таблице стилей.
    
    Параметры:
    
    source - Исходный документ XML.
    
    media - Атрибут носителей, который будет соответствующим. Может быть нуль, когда предпочтенные шаблоны будут использоваться (то есть альтернатива = не).
    
    title - Значение title приписывает соответствию. Может быть нуль.
    
    charset - Значение набора символов приписывает соответствию. Может быть нуль.
    
    Возвраты:
    
    A Source Object подходящий для того, чтобы передать к TransformerFactory.
    
    Броски:
    
    TransformerConfigurationException - Exception бросается если ошибка occurings во время парсинга source.
    
    См. Также:
    
    Соединение Таблиц стилей с XML-документами Версия 1.0
  - setURIResolver
```
public abstract void setURIResolver(URIResolver resolver)
```
    Установите объект, который используется по умолчанию во время преобразования, чтобы разрешить URI, используемые в документе (), xsl:import, или xsl:include.
    
    Параметры:
    
    resolver - Объект, который реализует интерфейс URIResolver, или нуль.
  - getURIResolver
```
public abstract URIResolver getURIResolver()
```
    Получите объект, который используется по умолчанию во время преобразования, чтобы разрешить URI, используемые в документе (), xsl:import, или xsl:include.
    
    Возвраты:
    
    URIResolver, который был установлен с setURIResolver.
  - setFeature
```
public abstract void setFeature(String name,
                                boolean value)
                         throws TransformerConfigurationException
```
    Установите функцию этого TransformerFactory и Transformers или Templates создаваемый этой фабрикой.
    
    Имена функции полностью определяются URIs. Реализации могут определить свои собственные функции. TransformerConfigurationException бросается если это TransformerFactory или Transformers или Templates это создает, не может поддерживать функцию. Это возможно для TransformerFactory представить значение функции, но быть неспособными изменить его состояние.
    
    Все реализации обязаны поддерживать XMLConstants.FEATURE_SECURE_PROCESSING функция. Когда функция:
    - true: реализация ограничит обработку XML, чтобы соответствовать пределам реализации и вести себя безопасным способом как определено реализацией. Примеры включают разрешение определяемых пользователем таблиц стилей и функций. Если обработка XML будет ограничена для соображений безопасности, то о ней сообщат через звонок в зарегистрированный ErrorListener.fatalError(TransformerException exception). См. setErrorListener(ErrorListener listener).
    - false: реализация будет, обрабатывая XML согласно спецификациям XML без отношения к возможным пределам реализации.
    Параметры:
    
    name - Имя функции.
    
    value - Состояние функции true или false.
    
    Броски:
    
    TransformerConfigurationException - если это TransformerFactory или Transformers или Templates это создает, не может поддерживать эту функцию.
    
    NullPointerException - Если name параметр является нулем.
  - getFeature
```
public abstract boolean getFeature(String name)
```
    Ищите значение функции.
    Имена функции полностью определяются URIs. Реализации могут определить свои собственные функции. false возвращается если это TransformerFactory или Transformers или Templates это создает, не может поддерживать функцию. Это возможно для TransformerFactory представить значение функции, но быть неспособными изменить его состояние.
    
    Параметры:
    
    name - Имя функции.
    
    Возвраты:
    
    Текущее состояние функции, true или false.
    
    Броски:
    
    NullPointerException - Если name параметр является нулем.
  - setAttribute
```
public abstract void setAttribute(String name,
                                  Object value)
```
    Позволяет пользователю устанавливать определенные атрибуты на базовой реализации. Атрибут в этом контексте определяется, чтобы быть возможностью, которую предоставляет реализация. IllegalArgumentException бросается, если базовая реализация не распознает атрибут.
    Все реализации, которые реализуют JAXP 1.5 или более новый, обязаны поддерживать XMLConstants.ACCESS_EXTERNAL_DTD и XMLConstants.ACCESS_EXTERNAL_STYLESHEET свойства.
    - Доступ к внешним DTD в исходном файле ограничивается протоколам, определенным XMLConstants.ACCESS_EXTERNAL_DTD свойство. Если доступ лишается во время преобразования из-за ограничения этого свойства, TransformerException будет брошен Transformer.transform(Source, Result).
      
      Доступ к внешним DTD в таблице стилей ограничивается протоколам, определенным XMLConstants.ACCESS_EXTERNAL_DTD свойство. Если доступ лишается во время создания нового преобразователя из-за ограничения этого свойства, TransformerConfigurationException будет брошен newTransformer(Source) метод.
      
      Доступ к внешней ссылке, установленной инструкцией обработки таблицы стилей, Импортом и, Включает элемент, ограничивается протоколам, определенным XMLConstants.ACCESS_EXTERNAL_STYLESHEET свойство. Если доступ лишается во время создания нового преобразователя из-за ограничения этого свойства, TransformerConfigurationException будет брошен newTransformer(Source) метод.
      
      Доступ к внешнему документу через функцию документа XSLT ограничивается протоколам, определенным свойством. Если доступ лишается во время преобразования из-за ограничения этого свойства, TransformerException будет брошен Transformer.transform(Source, Result) метод.
    Параметры:
    
    name - Имя атрибута.
    
    value - Значение атрибута.
    
    Броски:
    
    IllegalArgumentException - Когда реализация не распознает атрибут.
  - getAttribute
```
public abstract Object getAttribute(String name)
```
    Позволяет пользователю получать определенные атрибуты на базовой реализации. IllegalArgumentException бросается, если базовая реализация не распознает атрибут.
    
    Параметры:
    
    name - Имя атрибута.
    
    Возвраты:
    
    оцените значение атрибута.
    
    Броски:
    
    IllegalArgumentException - Когда реализация не распознает атрибут.
  - setErrorListener
```
public abstract void setErrorListener(ErrorListener listener)
```
    Установите ошибочного слушателя события для TransformerFactory, который используется для обработки инструкций преобразования, а не для преобразования непосредственно. IllegalArgumentException бросается если ErrorListener слушатель null.
    
    Параметры:
    
    listener - Новый ошибочный слушатель.
    
    Броски:
    
    IllegalArgumentException - Когда listener null
  - getErrorListener
```
public abstract ErrorListener getErrorListener()
```
    Получите ошибочный обработчик событий для TransformerFactory.
    
    Возвраты:
    
    Текущий обработчик ошибок, который никогда не должен быть нулем.

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

Класс TransformerFactory

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

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

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

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

TransformerFactory

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

newInstance

newInstance

Подсказка для Поиска и устранения неисправностей

newTransformer

newTransformer

newTemplates

getAssociatedStylesheet

setURIResolver

getURIResolver

setFeature

getFeature

setAttribute

getAttribute

setErrorListener

getErrorListener