java javax.xml_javax.xml.transform (Java Platform SE 8 )

该包定义了用于处理转换指令的通用API，并执行从源到结果的转换。 这些接口不依赖于SAX或DOM标准，并尝试尽可能少地做出关于转换的源和细节的假设。 它通过定义Source和Result接口来实现这一点。

创建对象

输入和输出规范

该API定义了两个接口对象，称为Source和Result 。 为了将Source和Result对象传递给接口，必须使用具体的类。 这些对象中的每一个都定义了一个FEATURE字符串(我是URL的形式)，可以传递给TransformerFactory.getFeature(java.lang.String)以查看给定类型的Source或Result对象是否受支持。 例如，要测试是否支持DOMSource和StreamResult，您可以应用以下测试。

TransformerFactory tfactory = TransformerFactory.newInstance(); if (tfactory.getFeature(DOMSource.FEATURE) && tfactory.getFeature(StreamResult.FEATURE)) { ... }

Namespaces在处理XML对象时提出了一个问题的区域。 合格名称以XML标记显示为前缀名称。 但前缀本身并不持有身份。 相反，它是上下文映射到拥有身份的URI。 因此，当Java程序中通过“xyz：foo”等合格名称时，必须提供将“xyz”映射到命名空间的方法。

一个解决方案是创建一个保存命名空间URI的“QName”对象，以及前缀和本地名称，但这并不总是最佳的解决方案，例如，当您要使用唯一的字符串作为键一个字典对象。 没有字符串表示也使得很难在XML文档的上下文之外指定命名空间的标识。

为了将命名空间值传递给转换，例如在Transformer对象上设置属性或参数时，此规范定义了一个String“qname”对象参数作为两部分字符串传递，命名空间URI由大括号括起来{})，后跟本地名称。 如果qname具有空URI，则String对象仅包含本地名称。 应用程序可以通过测试来查看名称的第一个字符是否为“{”字符，从而安全地检查非空URI。

例如，如果从使用定义的元素获取URI和本地名称，则合格名称将为“{http://xyz.foo.com/yada/baz.html}foo”。 请注意，前缀丢失。

结果树序列化

此方法创建一个有效地将源复制到结果的Transformer。 此方法可用于从SAX事件创建DOM或从DOM或SAX事件创建XML或HTML流。

异常和错误报告

转换API会抛出三种类型的异常异常。 当使用“javax.xml.transform.TransformerFactory”系统属性指定的转换工厂类无法找到或实例化时，通常会抛出此错误。

如果由于任何原因无法创建Transformer，则可能会抛出TransformerConfigurationException。

转换警告和错误发送到ErrorListener ，此时应用程序可能会决定报告错误或警告，并可能会决定为非致命错误异常 。 这两个对象上的ErrorListener始终是有效的，非null ，无论是由应用程序设置还是由处理器提供的默认实现。 处理器提供的默认实现将会将所有警告和错误报告给System.err ，并且不会抛出任何异常 s。 强烈鼓励应用程序注册和使用ErrorListener ，以确保警告和错误的正确行为。

解决转换中的URI

API提供了一种从样式表指令中引用的URI或通过调用应用程序解析的转换内的URI的方法。 URIResolver.resolve方法使用两个String参数，即样式表指令中找到的URI或作为转换过程的一部分构建的URI，如果需要绝对URI，则第一个参数将作为绝对的基本URI。 返回的Source对象必须由变压器使用，如实现的功能所规定。