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。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class TransformerFactory

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

TransformerFactory

方法详细信息

newInstance

newInstance

提示进行故障排除

newTransformer

newTransformer

newTemplates

getAssociatedStylesheet

setURIResolver

getURIResolver

setFeature

getFeature

setAttribute

getAttribute

setErrorListener

getErrorListener