怎样在java中写xml:如何使用Java解析XML文档
怎样在java中写xml:如何使用Java解析XML文档Stringresource="info.xml"; DocumentBuilderFactorydbf=DocumentBuilderFactory.newInstance(); DocumentBuilderdb=dbf.newDocumentBuilder(); Documentdoc=db.parse(Thread.currentThread().getContextClassLoader().getResourceAsStream(resource)); XPathFactoryfactory=XPathFactory.newInstance(); XPathxpath=factory.newXPath(); XPathExpressioncompile=xpath.compile("/members/user[id=1]"); System.
在前面的文章中,我们介绍了XML文件的规范与使用。而且XML应用非常广泛,在很多的软件中,会使用XML作为配置文档。那这些配置文档是如何被解析的呢?本文我们将参考《通用源码阅读指导书——MyBatis源码详解》一书介绍如何使用Java解析XML文件。
前面的文章中我们已经说明XML表述了一种树状结构,并通过给出了XML片段的结构树。而XPath(XML Path Language,即,XML路径语言)作为一种小型的查询语言能够根据XML结构树在树中寻找节点。
XPath定义了一组语法,能够从结构树中筛选出满足要求的节点。如果读者对CSS选择器或者jQuery选择器比较熟悉的话,那掌握XPath的语法还是非常简单的,因为这些选择器的语法思路是相通的。
例如XML片段如下:
<?xmlversion="1.0"encoding="UTF-8"?>
<members>
<usertype="student">
<id>1</id>
<name>易哥</name>
<shcool>SunnySchool</shcool>
</user>
<usertype="student">
<id>2</id>
<name>莉莉</name>
<shcool>GardenSchool</shcool>
</user>
</members>
我们可以通过下表所示的例子来简单了解下XPath的语法。
路径表达式 含义 . 当前元素 .. 当前元素的父元素 user user元素 /user user根元素 user/id user元素的名为id的直接子元素 user//id user元素的名为id的直接或间接子元素 user/id[1] user元素的名为id的直接子元素中的第一个 user/*[1] user元素的第一个子元素 user/id[last()-1] user元素的名为id的直接子元素中的倒数第二个 //user[@type='student'] 所有type属性值为“student”的user元素 //user[id>3] 所有id子元素值大于3的的user元素
javax.xml.xpath包提供了强大的XPath解析功能,因此我们可以基于它实现XML的解析。
我们可以通过下面的代码解析该XML片段。
Stringresource="info.xml";
DocumentBuilderFactorydbf=DocumentBuilderFactory.newInstance();
DocumentBuilderdb=dbf.newDocumentBuilder();
Documentdoc=db.parse(Thread.currentThread().getContextClassLoader().getResourceAsStream(resource));
XPathFactoryfactory=XPathFactory.newInstance();
XPathxpath=factory.newXPath();
XPathExpressioncompile=xpath.compile("/members/user[id=1]");
System.out.println(compile.evaluate(doc));
得到下图所示的输出
在代码中,我们通过“/members/user[id=1]”定位出了一个user元素,该元素满足以下条件:
- 该元素是根元素members的直接子元素
- 该元素含有id子元素,且id子元素值为1
以上内容均参考《通用源码阅读指导书——MyBatis源码详解》一书,接下来,我们跟随本书看MyBatis如何解析配置文件。
MyBatis的配置文件与映射文件均是XML文件,因此解析并读取XML文档中的内容是MyBatis展开后续工作的基础。
MyBatis中的parsing包就是用来进行XML文件解析的包。在解析XML文件的过程,XPathParser类与XNode类是两个最为关键的类,下图给出了这两个类主要关系的类图。
通过图可以看出,XPathParser类中封装了“javax.xml.xpath.XPath”类的对象。我们已经知道XPath对象是XML解析的利器,因此XPathParser类便具有了XML解析的能力。
下面代码给出了XPathParser类的带注释的属性。
//代表要解析的整个XML文档
privatefinalDocumentdocument;
//是否开启验证
privatebooleanvalidation;
//EntityResolver,通过它可以声明寻找DTD文件的方法,例如通过本地寻找,而不是只能通过网络下载DTD文件
privateEntityResolverentityResolver;
//MyBatis配置文件中的properties节点的信息
privatePropertiesvariables;
//javax.xml.xpath.XPath工具
privateXPathxpath;
有必要说明一下,上述“private Properties variables”属性存储的内容就是MyBatis配置文件中properties节点的信息。properties节点会在解析配置文件的最开始就被解析,然后相关信息会被放入“private Properties variables”属性并在解析后续节点时发挥作用,这一点我们不再展开,感兴趣的读者可以参考《通用源码阅读指导书——MyBatis源码详解》一书的“11.3 文档解析中的变量替换”章节。
XPathParser存在多个重载的构造方法,它们均是根据传入的参数完成属性的初始化并构造出XML文档对应的Document对象。除去构造方法外,便是大量提供XML文档中节点解析功能的“eval*”方法,这些方法最后都调用了如下代码所示的evaluate方法。
/**
*进行XML节点的解析
*@paramexpression解析的语句
*@paramroot解析根
*@paramreturnType返回值类型
*@return解析结果
*/
privateObjectevaluate(Stringexpression Objectroot QNamereturnType){
try{
//对指定节点root运行解析语法expression,获得returnType类型的解析结果
returnxpath.evaluate(expression root returnType);
}catch(Exceptione){
thrownewBuilderException("ErrorevaluatingXPath.Cause:" e e);
}
}
在evaluate方法中,使用“javax.xml.xpath.XPath”对象进行了节点的解析。因此,整个XPathParser类本质就是对“javax.xml.xpath.XPath”的封装和调用,可以把XPathParser类看作是javax.xml.xpath.XPath类的包装类。
同样地,parsing包中的XNode类可以看作是“org.w3c.dom.Node”类的包装类。“org.w3c.dom.Node”类是用来表示DOM中节点的类,而XNode类只是在“org.w3c.dom.Node”类的基础上提取和补充了几个属性。下面给出了XNode对象的属性。
//org.w3c.dom.Node表示是XML中的一个节点
privatefinalNodenode;
//节点名,可以从org.w3c.dom.Node中获取
privatefinalStringname;
//节点体,可以从org.w3c.dom.Node中获取
privatefinalStringbody;
//节点的属性,可以从org.w3c.dom.Node中获取
privatefinalPropertiesattributes;
//MyBatis配置文件中的properties信息
privatefinalPropertiesvariables;
//XML解析器XPathParser
privatefinalXPathParserxpathParser;
XNode对象的上述属性中,name、body、attributes这三个属性是从“org.w3c.dom.Node”对象中提取出来的,variables、xpathParser这两个属性补充的。而我们知道XPathParser类具有解析XML节点的能力,也就是说,XNode类中封装了自身了的解析器。在一个类中封装自己的解析器,这是一种非常常见的做法,如此一来这个类不需要外界的帮助便可以解析自身,即获得了自解析能力。
大家可能会有过这样的经历:新安装的电脑上没有解压软件,于是从网络或者朋友那里得到了一份解压软件。可是,拿到手的解压软件安装包却是一个压缩文件。尚未安装解压软件的你必然没法打开压缩文件获得安装包。而自解压文件(SelF-eXtracting,简称SFX)能够帮助你摆脱这个困境。自解析类也有类似的优点,它减少了对外部类的依赖,具有更高的内聚性,也更为易用。
正是得益于XNode类的自解析特性,它本身提供了一些“eval*”方法,从而能够解析自身节点内的信息。
以上内容均参考《通用源码阅读指导书——MyBatis源码详解》一书。
阅读源码确实对编程能力的提升有很大的帮助。把《通用源码阅读指导书——MyBatis源码详解》推荐给大家。这是一本以MyBatis的源码为实例讲述源码阅读方法的书籍,并且附带有示例项目源码,MyBatis的全中文注解。书籍还总结了大量的编程知识和架构经验,对提升编程和架构能力十分有用。
最后,我是高级架构师易哥,这里是架构研究所。真心希望本文能让大家有所收获。
欢迎关注我们,我会偶尔出没分享软件架构和编程相关的干货知识。