//首先创建一个TransformerFactory对象,再由此创建Transformer对象。
TransformerFactory tf=TransformerFactory.newInstance();
Transformer t=tf.newTransformer ();
//获取Transformser对象的输出属性,亦即XSLT引擎的缺省输出属性,这是一个
//java.util.Properties对象。
Properties properties = t.getOutputProperties();
//设置新的输出属性:输出字符编码为GB2312,这样可以支持中文字符,XSLT引擎所输出
//的XML文档如果包含了中文字符,可以正常显示,不会出现所谓的"汉字问题"。
//请留意OutputKeys类的字符串常数OutputKeys.ENCODING。
properties.setProperty(OutputKeys.ENCODING,"GB2312");
/更新XSLT引擎的输出属性。
t.setOutputProperties(properties);
//调用XSLT引擎,按照输出属性中的设置,输出DOM Tree中的内容到输出介质中。
t.transform(DOMSource_Object,StreamResult_Object);
从上面的程序代码,我们不难看出,通过设置XSLT引擎(Transformer类)的输出属性,可以控制DOM Tree中的内容的输出格式,这对于我们定制输出内容是很有帮助的。那么JAXP的XSLT引擎(Transformer类)有那些输出属性可以设置呢? javax.xml.transform.OutputKeys类定义了很多字符串常数,它们都是可以自由设置的输出属性,常用的输出属性如下所示:
public static final java.lang.String METHOD
可以设为"xml"、"html"、"text"等值。
public static final java.lang.String VERSION
所遵循规范的版本号,如果METHOD设为"xml",那么它的值应该设为"1.0",如果METHOD设为"html",那么它的值应该设为"4.0",如果METHOD设为"text",那么这个输出属性会被忽略。
public static final java.lang.String ENCODING
设置输出时所采用的编码方式,比如"GB2312"、"UTF-8"等等,如果将其设置为"GB2312",可以解决所谓的"汉字问题"。
public static final java.lang.String OMIT_XML_DECLARATION
设置输出到XML文档中时是否忽略XML声明,亦即类似于:
＜?xml version="1.0" standalone="yes" encoding="utf-8" ?＞
这样的代码。它可选的值有"yes"、"no"。
public static final java.lang.String INDENT
IDENT设定XSLT引擎在输出XML文档时,是否自动添加额外的空格,它可选的值为"yes"、"no"。
public static final java.lang.String MEDIA_TYPE
MEDIA_TYPE设定输出文档的MIME类型。
如果设定XSLT引擎的输出属性呢?下面我们来总结一下:
首先是获取XSLT引擎(Transformer类)的缺省输出属性的集合,这需要使用Transformer类的getOutputProperties()方法,返回值是一个java.util.Properties对象。
Properties properties = transformer.getOutputProperties();
然后是设定新的输出属性,比如:
properties.setProperty(OutputKeys.ENCODING,"GB2312");
properties.setProperty(OutputKeys.METHOD,"html");
properties.setProperty(OutputKeys.VERSION,"4.0");
………………………………………………………
最后是更新XSLT引擎(Transformer类)的缺省输出属性的集合,这需要使用Transformer类的setOutputProperties()方法,参数是一个java.util.Properties对象。
我们编写了一个新的程序,其中应用了OutputKeys类,用以控制XSLT引擎的输出属性,该程序的架构和前一个程序(AddRecord3.java)大致相同,不过输出结果略有不同。完整的代码请参考下列文件: AddRecord3.java(见附件)、user.xml(见附件)。该例子的运行环境为:Windows XP Professional、JDK 1.3.1。为了能够正常编译运行AddRecord3.java这个程序,你需要到网址去下载安装JAXP 1.1或者Java XML Pack(Java XML Pack内含JAXP了)。
方法四:使用Xalan XML Serializer
方法四其实是方法三的一个变种,它需要Apache Xalan和Apache Xerces的支持才能够运行。例子代码如下所示:
//首先创建一个DOMSource对象,该构造函数的参数可以是一个Document对象
//doc代表更改后的DOM Tree。
DOMSource domSource = new DOMSource (doc);
//创建一个DOMResult对象,临时保存XSLT引擎的输出结果。
DOMResult domResult = new DOMResult();
//下面调用JAXP中的XSLT引擎来实现输出DOM Tree中的数据到XML文件中的功能。
//XSLT引擎的输入为DOMSource对象,输出为DOMResut对象。
try
{
//首先创建一个TransformerFactory对象,再由此创建Transformer对象。Transformer
//类相当于一个XSLT引擎。通常我们使用它来处理XSL文件,但是在这里我们使
//用它来输出XML文档。
TransformerFactory tf=TransformerFactory.newInstance();
Transformer t=tf.newTransformer ();
//设置XSLT引擎的属性(必不可少,否则会产生"汉字问题")。
Properties properties = t.getOutputProperties();
properties.setProperty(OutputKeys.ENCODING,"GB2312");
t.setOutputProperties(properties);
//关键的一步, 调用Transformer对象 (XSLT引擎)的transform()方法,该方法的第一
//个参数是DOMSource对象,第二个参数是DOMResult对象。
t.transform(domSource,domResult);
//创建缺省的Xalan XML Serializer,使用它将临时存放在DOMResult对象
//(domResult)中的内容以输出流的形式输出到输出介质中。
Serializer serializer = SerializerFactory.getSerializer
(OutputProperties.getDefaultMethodProperties("xml"));
//设置Xalan XML Serializer的输出属性,这一步必不可少,否则也可能产生
//所谓的"汉字问题"。
Properties prop=serializer.getOutputFormat();
prop.setProperty("encoding","GB2312");
serializer.setOutputFormat(prop);
//创建一个File对象,代表DOM Tree所包含的数据的输出介质,这是一个XML文件。
File f = new File ("xuser3.xml");
//创建文件输出流对象fos,请留意构造函数的参数。
FileOutputStream fos=new FileOutputStream(f);
//设置Xalan XML Serializer的输出流。
serializer.setOutputStream(fos);
//串行化输出结果。
serializer.asDOMSerializer().serialize(domResult.getNode());
}
catch (Exception tce)
{
tce.printStackTrace();
}
这个方法不太常用,而且似乎有点画蛇添足,所以我们就不展开讨论了。完整的例子请参考下列文件: AddRecord4.java(见附件)、user.xml(见附件)。该例子的运行环境为:Windows XP Professional、JDK 1.3.1。为了能够正常编译运行AddRecord4.java这个程序,你需要到网址去下载安装Apache Xalan和Apache Xerces。
或者是到网址去下载安装Java XML Pack。因为最新的Java XML Pack(Winter 01 版)包含了Apache Xalan和Apache Xerces技术在内。
结论:
本文简略的讨论了Java语言编程中更新XML文档的四种方法。第一种方法是直接读写XML文件,这种方法十分繁琐,而且比较容易出错,极少使用,除非你需要开发自己的XML Parser,否则不会使用这种方法。第二种方法是使用Apache Crimson的XmlDocument类,这种方法极为简单,使用方便,如果你选用Apache Crimson作为XML解析器,那么不妨使用这种方法,不过这种方法似乎效率不高(源于效率低下的Apache Crimson),另外,高版本的JAXP或者是Java XML Pack、JWSDP不直接支持Apache Crimson,亦即这种方法不通用。第三种方法是使用JAXP的XSLT引擎(Transformer类)来输出XML文档,这种方法也许是标准的方法了,使用起来十分灵活,特别是可以自如控制输出格式,我们推荐采用这种方法。第四种方法是第三种方法的变种,采用了Xalan XML Serializer,引入了串行化操作,对于大量文档的修改/输出有优越性,可惜的是要重复设置XSLT引擎的属性和XML Serializer的输出属性,比较麻烦,而且依赖于Apache Xalan和Apache Xerces技术,通用性略显不足。
除了上面讨论的四种方法以外,实际上应用别的API(比如JDOM、Castor、XML4J、Oracle XML Parser V2)也有很多办法可以更新XML文档,限于篇幅,在这里就不一一讨论了。