TransformerFactory (Java Platform SE 8 )

java.lang.Object
- javax.xml.transform.TransformerFactory

已知直接子类：

SAXTransformerFactory
```
public abstract class TransformerFactory
extends Object
```
TransformerFactory实例可用于创建Transformer和Templates对象。

确定要创建哪个Factory实现的系统属性命名为"javax.xml.transform.TransformerFactory" 。该属性命名为TransformerFactory抽象类的具体子类。如果未定义属性，则使用平台默认值。

从以下版本开始：

1.5

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`TransformerFactory()` 默认构造函数是有意保护的。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract Source`	`getAssociatedStylesheet(Source source, String media, String title, String charset)` 通过符合给定条件的 xml-stylesheet processing instruction获取与XML `Source`文档关联的样式 `Source`规范。
`abstract Object`	`getAttribute(String name)` 允许用户检索底层实现的特定属性。
`abstract ErrorListener`	`getErrorListener()` 获取TransformerFactory的错误事件处理程序。
`abstract boolean`	`getFeature(String name)` 查找功能的值。
`abstract URIResolver`	`getURIResolver()` 获取在转换过程中默认使用的对象来解析在document（），xsl：import或xsl：include中使用的URI。
`static TransformerFactory`	`newInstance()` 获得一个新的 `TransformerFactory`实例。
`static TransformerFactory`	`newInstance(String factoryClassName, ClassLoader classLoader)` 从工厂类名称获取一个新的实例 `TransformerFactory` 。
`abstract Templates`	`newTemplates(Source source)` 将源处理为一个Templates对象，它是源的编译表示。
`abstract Transformer`	`newTransformer()` 创建一个新的 `Transformer` ，执行 `Source`到 `Result` 。
`abstract Transformer`	`newTransformer(Source source)` 将 `Source`为 `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`的功能。
`abstract void`	`setURIResolver(URIResolver resolver)` 设置在转换期间默认使用的对象，以解析document（），xsl：import或xsl：include中使用的URI。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - TransformerFactory
```
protected TransformerFactory()
```
    默认构造函数是有意保护的。
- 方法详细信息
  - newInstance
```
public static TransformerFactory newInstance()
                                      throws TransformerFactoryConfigurationError
```
    获得一个新的TransformerFactory实例。这个静态方法创建一个新的工厂实例。
    
    此方法使用以下有序查找过程来确定要加载的TransformerFactory实现类：
    - 使用javax.xml.transform.TransformerFactory系统属性。
    - 在JRE目录中使用属性文件“lib / jaxp.properties”。此配置文件采用标准java.util.Properties格式，包含实现类的完全限定名称，其中键为上面定义的系统属性。
      jaxp.properties文件由JAXP实现只读一次，然后将其缓存以备将来使用。如果文件第一次尝试读取文件不存在，则不再进一步检查其存在。在第一次读取jaxp.properties之后，无法更改任何属性的值。
    - 使用由ServiceLoader类定义的服务提供商加载工具，使用default loading mechanism尝试定位和加载服务的实现：服务提供商加载工具将使用current thread's context class loader尝试加载服务。如果上下文类加载器为null，那么将使用system class loader 。
    - 否则，返回系统默认实现。
    一旦应用程序获得了对TransformerFactory的TransformerFactory就可以使用工厂来配置和获取变压器实例。
    结果
    
    新的TransformerFactory实例，从不为null。
    
    异常
    
    TransformerFactoryConfigurationError -抛出的情况下service configuration error或者如果实现不可用或不能被实例化。
  - newInstance
```
public static TransformerFactory newInstance(String factoryClassName,
                                             ClassLoader classLoader)
                                      throws TransformerFactoryConfigurationError
```
    从工厂类名称获取一个新的实例TransformerFactory 。在类路径中有多个提供程序时，此功能很有用。它可以更好地控制应用程序，因为它可以指定应该加载哪个提供程序。
    
    一旦应用程序获得了对TransformerFactory的TransformerFactory就可以使用工厂来配置和获取变压器实例。
    
    提示进行故障排除
    
    设置jaxp.debug系统属性将导致此方法打印大量调试消息到System.err有关它在做什么和它在哪里看。
    
    如果您有问题，请尝试：
```
  java -Djaxp.debug=1 YourProgram .... 
```
    参数
    
    factoryClassName -完全限定工厂类名称，提供实施 javax.xml.transform.TransformerFactory 。
    
    classLoader - ClassLoader用于加载工厂类。如果null当前的Thread的上下文classLoader用于加载工厂类。
    
    结果
    
    新的TransformerFactory实例，从不为null。
    
    异常
    
    TransformerFactoryConfigurationError - 如果 factoryClassName是 null ，或工厂类无法加载，实例化。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    newInstance()
  - newTransformer
```
public abstract Transformer newTransformer(Source source)
                                    throws TransformerConfigurationException
```
    将Source成Transformer Object 。 Source是符合XSL Transformations (XSLT) Version 1.0的XSLT文档。必须注意不要使用这种Transformer多个Thread小号同时运行。不同的TransformerFactories可以同时使用不同的Thread s。
    
    参数
    
    source - Source的XSLT文档用于创建Transformer 。 XML的例子Source小号包括DOMSource ， SAXSource和StreamSource 。
    
    结果
    
    一个 Transformer对象，可用于在单个 Thread中执行 Thread ，从不 null 。
    
    异常
    
    TransformerConfigurationException - 如果在解析 Source时出现错误或者无法创建 Transformer实例，则 Transformer 。
    
    另请参见：
    
    XSL Transformations (XSLT) Version 1.0
  - newTransformer
```
public abstract Transformer newTransformer()
                                    throws TransformerConfigurationException
```
    创建一个新的Transformer ，执行Source的Result 。即“ 身份转换 ”。
    
    结果
    
    可用于在单个线程中执行转换的Transformer对象，从不为null。
    
    异常
    
    TransformerConfigurationException - 当无法创建 Transformer实例时。
  - newTemplates
```
public abstract Templates newTemplates(Source source)
                                throws TransformerConfigurationException
```
    将源处理为一个Templates对象，它是源的编译表示。然后可以在多个线程上同时使用此Templates对象。创建一个Templates对象允许TransformerFactory对变换指令进行详细的性能优化，而不会影响运行时转换。
    
    参数
    
    source - 保存URL，输入流等的对象
    
    结果
    
    一个能够用于转换目的的模板对象，从不 null 。
    
    异常
    
    TransformerConfigurationException - 解析构造Templates对象失败。
  - getAssociatedStylesheet
```
public abstract Source getAssociatedStylesheet(Source source,
                                               String media,
                                               String title,
                                               String charset)
                                        throws TransformerConfigurationException
```
    通过符合给定条件的xml-stylesheet processing instruction获取与XML Source文档相关联的样式Source规范。请注意，可以返回多个样式表，在这种情况下，它们应用为单个样式表中的导入或级联列表。
    
    参数
    
    source - XML源文档。
    
    media - 要匹配的媒体属性。可能为null，在这种情况下，将使用优先模板（即alternate = no）。
    
    title - 要匹配的title属性的值。可能为null。
    
    charset - 要匹配的字符集属性的值。可能为null。
    
    结果
    
    A Source Object适合传递给 TransformerFactory 。
    
    异常
    
    TransformerConfigurationException -一个 异常是的分析过程中，如果出现错误occurings抛出 source 。
    
    另请参见：
    
    Associating Style Sheets with XML documents Version 1.0
  - setURIResolver
```
public abstract void setURIResolver(URIResolver resolver)
```
    设置在转换期间默认使用的对象，以解析document（），xsl：import或xsl：include中使用的URI。
    
    参数
    
    resolver - 实现URIResolver接口的对象，或null。
  - getURIResolver
```
public abstract URIResolver getURIResolver()
```
    获取在转换过程中默认使用的对象来解析在document（），xsl：import或xsl：include中使用的URI。
    
    结果
    
    使用setURIResolver设置的URIResolver。
  - setFeature
```
public abstract void setFeature(String name,
                                boolean value)
                         throws TransformerConfigurationException
```
    为这个工厂创建的TransformerFactory和Transformer s或Template设置了一个功能。
    
    功能名称完全符合URI s。实现可以定义自己的特征。如果这个TransformerFactory或TransformerFactory或Transformer或它们创建的Template不能支持该功能，则会抛出一个TransformerConfigurationException 。 TransformerFactory可以公开特征值，但无法更改其状态。
    
    所有实现都需要支持XMLConstants.FEATURE_SECURE_PROCESSING功能。当功能是：
    - true ：实现将限制XML处理以符合实现限制，并以实现所定义的安全方式进行操作。示例包括解析用户定义的样式表和功能。如果XML处理由于安全原因而受到限制，则通过对已注册的ErrorListener.fatalError(TransformerException exception)的呼叫进行报告。见setErrorListener(ErrorListener listener) 。
    - false ：实现将根据XML规范处理XML，而不考虑可能的实现限制。
    参数
    
    name - 功能名称。
    
    value - 是功能状态 true或 false 。
    
    异常
    
    TransformerConfigurationException - 如果这 TransformerFactory或 Transformer s或 Template它创建不能支持此功能。
    
    NullPointerException - 如果 name参数为空。
  - getFeature
```
public abstract boolean getFeature(String name)
```
    查找功能的值。
    功能名称完全符合URI s。实现可以定义自己的特征。 false返回如果这TransformerFactory或Transformer S或Template的IT创建不支持该功能。 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 - 属性的名称。
    
    结果
    
    value属性的值。
    
    异常
    
    IllegalArgumentException - 当实现不识别属性时。
  - setErrorListener
```
public abstract void setErrorListener(ErrorListener listener)
```
    设置TransformerFactory的错误事件侦听器，它用于处理转换指令，而不是转换本身。一个IllegalArgumentException如果抛出ErrorListener监听器是null 。
    
    参数
    
    listener - 新的错误侦听器。
    
    异常
    
    IllegalArgumentException - listener为 null
  - getErrorListener
```
public abstract ErrorListener getErrorListener()
```
    获取TransformerFactory的错误事件处理程序。
    
    结果
    
    当前的错误处理程序，不应该为null。

Class TransformerFactory

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

TransformerFactory

方法详细信息

newInstance

newInstance

提示进行故障排除

newTransformer

newTransformer

newTemplates

getAssociatedStylesheet

setURIResolver

getURIResolver

setFeature

getFeature

setAttribute

getAttribute

setErrorListener

getErrorListener