Tomcat源码的catalina中利用Digester解析conf/server.xml

_N_了吧唧的_

最近在学习Tomcat的源码，在catalina. createStartDigester方法中，Tomcat开发人员采用了Digester来读取conf/server.xml文件，以前读取xml文件一般采用Dom4j和SAX。由于对Digester比较陌生，所以今天抽时间研究了一下Digester是如何解析xml文件的。先简单阐述下Dom4j和SAX解析XML的却别：
Dom4j是把一个xml文件全部读取到内存中，构建成一个DOM树来解析，所以Dom4j适合读取比较小的xml文件。
SAX是基于文件流来解析xml文件的，在读取xml文件流时，SAX会通过节点来触发相应的操作，也可以说SAX是基于文件流的事情触发机制来解析xml文件的。
Digeter是apache的common项目，作用是将XML转化成对象，使用者直接从对象中获取xml的节点信息。Digester是对SAX的包装，它也是基于文件流来解析xml文件，只不过这些解析操作对用户是透明的。Tomcat的配置文件conf/server.xml就是用Digester来读取的。
一、    下载Digester的jar
(1)      Digester的jar下载地址（版本：2.0）
http://commons.apache.org/digester/
(2)      Digester依赖的Logging的jar下载地址（版本：1.1.1）
http://commons.apache.org/logging/
(3)      Digester依赖的BeanUtils的jar下载地址（版本：1.8.3）
http://commons.apache.org/beanutils/
二、    关键方法说明
(1)    serverDigester.addObjectCreate("Server","com.test.server.digester.Server")
当解析xml文件时，遇到“Server”就初始化一个“com.test.server.digester.Server”对象，并且把该对象压入栈顶
(2)    serverDigester.addSetProperties("Server", "port", "port")
给Server对象注册port属性，当解析到Server节点的port属性时调用Server的setPort方法
(3)    serverDigester.addSetNext("Server/Listener", "addListener","com.test.server.digester.Listener")
当解析Server节点下的Listener节点的时候，调用Server对象的addListener方法，把当前Listener对象写入到Server对象中。无论Server节点下有多少个Listener节点，都会调用addListener方法
(4)    serverDigester.addCallMethod("Server/Service/Engine", "setEngine", 0)
Service中添加Engine,调用当前top object的setEngine函数，参数个数为0
addCallMethod与addBeanPropertySetter方法等价
三、    注意事项
Xml中定义的属性要与对象中set和get方法一致，比如xml中定义了一个节点属性“engineType”，那么在java对象的set方法必须为setEngineType，除了首字母外，其他字母必须一致，不然在解析的时候会解析不到对应的属性值。不知道是否还有其他规则，没有摸清楚。