Java javax.xml.transform 类 Transformer（JDK5）

所有类

javax.xml.transform
类 Transformer

java.lang.Object
  javax.xml.transform.Transformer

public abstract class Transformer
   
   
   
   
extends Object
   
   
   
   

此抽象类的实例能够将源树转换为结果树。

可以通过 TransformerFactory.newTransformer 方法获取此类的实例。然后此实例可以用于处理来自不同源的 XML，并将转换输出写入各种接收器。

在多线程同时运行时不能使用此类的对象。不同线程可以同时使用不同的 Transformers。

Transformer 可以多次使用。可以在转换之间保留参数和输出属性。

Transformer

protected Transformer()

默认构造方法受到有意保护。

reset

public void reset()

将此 Transformer 重置为其初始配置。

Transformer 被重置为通过 TransformerFactory.newTransformer()、TransformerFactory.newTransformer(Source source) 或 Templates.newTransformer() 创建时的相同状态。reset() 的设计是为了允许重用现有 Transformer，以节省与创建新 Transformer 有关的资源。

不保证重置的 Transformer 具有相同的 URIResolver 或 ErrorListener Object，例如 Object.equals(Object obj)。但保证具有功能相同的 URIResolver 和 ErrorListener。

从以下版本开始：

1.5

transform

public abstract void transform(Source xmlSource,
                               Result outputTarget)
                        throws TransformerException

将 XML Source 转换为 Result。当实例化 Transformer 和对 Transformer 实例进行任何修改时，指定的转换行为由 TransformerFactory 的实际设置确定。

空 Source 表示为由 DocumentBuilder.newDocument() 构造的空文档。空 Source 的转换结果取决于转换行为；结果不总为空 Result。

参数：

xmlSource - 要转换的 XML 输入。

outputTarget - 转换 xmlSource 的 Result。

抛出：

TransformerException - 如果转换过程中发生不可恢复的错误。

setParameter

public abstract void setParameter(String name,
                                  Object value)

添加一个转换参数。

以两部分字符串形式传递限定名称，即用花括号括起来的名称空间 URI，后跟本地名称。如果名称中有 null URL，则 String 只包含本地名称。应用程序可以通过测试安全地检查非 null 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 对象。处理器负责提供正确的对象 coersion，或简单地传递在扩展中使用的对象。

抛出：

NullPointerException - 如果值为 null。

getParameter

public abstract Object getParameter(String name)

获取通过 setParameter 显式设置的参数。

此方法不返回默认参数值，默认参数值直到在转换过程中计算了节点上下文后才能确定。

参数：

name - 要获取的 Object

返回：

已通过 setParameter 设置的参数。

clearParameters

public abstract void clearParameters()

清除所有通过 setParameter 设置的参数。

setURIResolver

public abstract void setURIResolver(URIResolver resolver)

设置将用于解析在 document() 中使用的 URI 的对象。

如果解析器参数为 null，则将清除 URIResolver 值，且转换器将不再具有解析器。

参数：

resolver - 实现 URIResolver 接口的对象，或为 null。

getURIResolver

public abstract URIResolver getURIResolver()

获取将用于解析在 document() 中使用的 URI 的对象。

返回：

实现 URIResolver 接口的对象，或返回 null。