TransformerFactory (Java Platform SE 8 )

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

已知直接子类：

SAXTransformerFactory
```
public abstract class TransformerFactory
extends Object
```
一个transformerfactory实例可以用来创建Transformer和Templates对象。

系统属性，确定哪些工厂实现来创建命名"javax.xml.transform.TransformerFactory"。这个属性名称的TransformerFactory抽象类的一个具体子类。如果没有定义属性，则将使用一个平台默认值。

从以下版本开始：

一点五

构造方法摘要

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

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract Source`	`getAssociatedStylesheet(Source source, String media, String title, String charset)` 把样式表规范（S）通过 xml-stylesheet processing instruction匹配给定的标准XML文档相关联的 `Source`。
`abstract Object`	`getAttribute(String name)` 允许用户检索底层实现上的特定属性。
`abstract ErrorListener`	`getErrorListener()` 得到的transformerfactory错误事件处理程序。
`abstract boolean`	`getFeature(String name)` 查找一个特征的值。
`abstract URIResolver`	`getURIResolver()` 得到所使用的默认在转型过程中解决URI用于document()，XSL的对象：进口，或是包括。
`static TransformerFactory`	`newInstance()` 获得一个 `TransformerFactory`新实例。
`static TransformerFactory`	`newInstance(String factoryClassName, ClassLoader classLoader)` 获得从工厂类的新实例的名称 `TransformerFactory`。
`abstract Templates`	`newTemplates(Source source)` 将源程序转化为模板对象，这是源代码的一一个编译表示形式。
`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`s这个工厂创建。
`abstract void`	`setURIResolver(URIResolver resolver)` 设置一个对象所使用的默认在转型过程中解决URI用于document()，XSL的进口，或将包括。

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

- Constructor Detail
  - TransformerFactory
```
protected TransformerFactory()
```
    默认构造函数的保护。
- 方法详细信息
  - newInstance
```
public static TransformerFactory newInstance()
                                      throws TransformerFactoryConfigurationError
```
    获得一个TransformerFactory新实例。这种静态方法创建一个新的工厂实例。
    
    此方法使用以下命令查找程序来确定TransformerFactory实现类负载：
    - 使用javax.xml.transform.TransformerFactory系统性能。
    - 使用属性文件的“库/ JAXP。属性”在JRE目录。这个配置文件是标准的java.util.Properties 格式包含实现类的完全限定名的关键是上面定义的系统性能。
      的jaxp.properties文件只有一次由JAXP实现读取它的值然后储存以备将来使用。如果该文件不存在时，第一次尝试是从它读取，没有进一步的尝试，以检查其存在。它不可能在它被第一次看到改变在jaxp.properties任何财产的价值。
    - 使用服务提供商装载设施，由ServiceLoader类定义，试图定位和加载使用default loading mechanism服务的实现：服务提供者装载设备将使用current thread's context class loader尝试加载服务。如果上下文类加载器是空的，将使用的system class loader。
    - 否则，系统默认实现返回。
    一旦申请获得参考一 TransformerFactory可以使用工厂配置和获取变压器的实例。
    结果
    
    新的transformerfactory实例，没空。
    
    异常
    
    TransformerFactoryConfigurationError -扔下 service configuration error或者执行不可用或不能被实例化。
  - newInstance
```
public static TransformerFactory newInstance(String factoryClassName,
                                             ClassLoader classLoader)
                                      throws TransformerFactoryConfigurationError
```
    获得从工厂类的新实例的名称TransformerFactory。此功能是有用的当有多个供应商在类路径。它给应用程序提供了更多的控制，因为它可以指定要加载哪个提供程序。
    
    一旦申请获得参考一 TransformerFactory可以使用工厂配置和获取变压器的实例。
    
    解决问题的技巧
    
    设置jaxp.debug系统属性将导致这种方法印制大量的调试消息System.err关于它是什么做的，是在看。
    
    如果你有问题的话：
```
java djaxp。调试= 1你的…
```
    参数
    
    factoryClassName完全合格的工厂类的名称，提供了实现 javax.xml.transform.TransformerFactory。
    
    classLoader用于负荷工厂类 ClassLoader。如果 null电流 Thread上下文类加载器来加载工厂类。
    
    结果
    
    新的transformerfactory实例，没空。
    
    异常
    
    TransformerFactoryConfigurationError -如果 factoryClassName是 null，或工厂类不能被加载，实例化。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    newInstance()
  - newTransformer
```
public abstract Transformer newTransformer(Source source)
                                    throws TransformerConfigurationException
```
    过程Source成Transformer Object。是的Source XSLT文件符合 XSL Transformations (XSLT) Version 1.0。注意不要在多个Threads运行同时使用这Transformer。不同的TransformerFactories可以同时使用不同的Threads。
    
    参数
    
    source - XSLT文件用于创建 Transformer Source 。XML Sources例子包括 DOMSource， SAXSource，和 StreamSource。
    
    结果
    
    一个 Transformer对象可用于在一个单一的 Thread进行改造，不 null。
    
    异常
    
    TransformerConfigurationException -扔如果有错误解析 Source或不可能创造出一个 Transformer实例。
    
    另请参见：
    
    XSL Transformations (XSLT) Version 1.0
  - newTransformer
```
public abstract Transformer newTransformer()
                                    throws TransformerConfigurationException
```
    创建一个新的Transformer执行复制的Source的Result。即“身份转换”。
    
    结果
    
    可用于在一个线程中执行转换的一个变压器对象，从不空。
    
    异常
    
    TransformerConfigurationException -当它是不可能创造一个 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
```
    把样式表规范（S）通过 xml-stylesheet processing instruction匹配给定的标准XML文档相关联的Source。注意可以返回多个样式表，在这种情况下，他们是作为如果他们是在一个单一的样式表的进口或级联列表。
    
    参数
    
    source - XML源文档。
    
    media -媒体属性相匹配。可能是无效的，在这种情况下，优先将模板应用（即交替=没有）。
    
    title - title属性的值匹配。可能是空的。
    
    charset的charset属性值匹配。可能是空的。
    
    结果
    
    适合传递给 TransformerFactory一 Source Object。
    
    异常
    
    TransformerConfigurationException - 异常是如果错误occurings期间的 source解析扔。
    
    另请参见：
    
    Associating Style Sheets with XML documents Version 1.0
  - setURIResolver
```
public abstract void setURIResolver(URIResolver resolver)
```
    设置一个对象所使用的默认在转型过程中解决URI用于document()，XSL的进口，或将包括。
    
    参数
    
    resolver URIResolver -实现接口的对象，或空。
  - getURIResolver
```
public abstract URIResolver getURIResolver()
```
    得到所使用的默认在转型过程中解决URI用于document()，XSL的对象：进口，或是包括。
    
    结果
    
    在设置与seturiresolver URIResolver。
  - 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错误事件处理程序。
    
    结果
    
    当前的错误处理程序，该处理程序不应该是空的。

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

Constructor Detail

TransformerFactory

方法详细信息

newInstance

newInstance

解决问题的技巧

newTransformer

newTransformer

newTemplates

getAssociatedStylesheet

setURIResolver

getURIResolver

setFeature

getFeature

setAttribute

getAttribute

setErrorListener

getErrorListener