Apache Commons-configuration 学习笔记
1 如果要使用configuration这个包，首先要保证使用JDK1.2以上，还要引入如下jar包
commons-beanutils
commons-lang
commons-logging
commons-collections
commons-digester
commons-codec
commons-jxpath
2 commons-configuration最新的版本是1.5，最主要的作用是读取资源文件，每一种文件格式都有一个对应的类，如下
properties文件--PropertiesConfiguration类
xml文件--XMLConfiguration
.ini文件--INIConfiguration
.plist文件--PropertyListConfiguration
还可以从JNDI中读取properties--JNDIConfiguration
当然还可以使用system的properties--SystemConfiguration
等等...
3 上面已经对它做了基本的介绍，下面看看这个包怎么用吧
比如我们要读一个properties文件：在classpath下面建立目录te,之后在te下面建立
test.properties
ip=127.0.0.1
port=8080
id=111
application.name = Killer App
application.version = 1.6.2
application.title = ${application.name} ${application.version}
keys=cn,com,org,uk,edu,jp,hk
//注意路径默认指向的是classpath的根目录
Configuration config = new PropertiesConfiguration("te/test.properties");
String ip=config.getString("ip");
int port=config.getInt("port");
String title=config.getString("application.title");
//再举个Configuration的比较实用的方法吧,在读取配置文件的时候有可能这个键值对应的值为空，那么在下面这个方法中
//你就可以为它设置默认值。比如下面这个例子就会在test.properties这个文件中找id的值，如果找不到就会给id设置值为123
//这样就保证了java的包装类不会返回空值。虽然功能很简单，但是很方便很实用。
Integer id=config.getInteger("id", new Integer(123));
//如果在properties 文件中有如下属性keys=cn,com,org,uk,edu,jp,hk
//可以实用下面的方式读取：
String[] keys1=config.getStringArray("keys");
List keys2=config.getList("keys");
首先要把这个文件读到程序中，我们可以用上面的类，所有的读取文件的类都 继承自AbstractConfiguration类，
而这个类实现了Configuration接口，如果我们只有比较简单的需求，那么可以直接向上转型为Configuration类型，如果向上
转型为AbstractConfiguration类，那么可以做一些配置工作。
比如刚刚看到的 keys=cn,com,org,uk,edu,jp,hk这个例子中如果是keys=cn/com/org/uk/edu/jp/hk
那么如果还按照原来的方式读取，读到的将是"cn/com/org/uk/edu/jp/hk"这个字符串，所以要先改变分割符之后在读
即
AbstractConfiguration.setDefaultListDelimiter('/');
Configuration config = new PropertiesConfiguration("te/Vasp.properties");
String[] keys=config.getStringArray("keys");
List key2=config.getList("keys");
如果你看它的源码，你会在 AbstractConfiguration这个类中找到：
private static char defaultListDelimiter = ',';
如果你确定要解析的文件是properties ,那么你完全可以使用
PropertiesConfiguration config = new PropertiesConfiguration("tt/t.properties");
代替
Configuration config = new PropertiesConfiguration("tt/t.properties");
这么写似乎不符合面向接口编程，但是它可以使用PropertiseConfiguration中特殊的方法。
比如，你如果你想修改propertise文件，那么可以这样：
config.setProperty("id", "sss");
config.save();
当然，你还可以使用isAutoSave这个方法：
config.isAutoSave();
config.setProperty("tttt", "sss");
properties这个类还支持文件的继承，比如在test.properties这个文件中有
include = test1.properties
同时在classpath中又有test1.properties这个文件，那么PropertiesConfiguration类就可以
从test1.properties文件中读取信息。
读取XML
假如有个XML，名叫：XMLtest.xml如下：
#808080 #000000 #008000 ${colors.header} 15 OK,Cancel,Help Yes,No,Cancel
标准的XML文件都会有一个跟标签包裹住所有内容，这个标签的子标签认为是顶级名字空间
（这个说法可能不准确）不多说了看代码吧
XMLConfiguration config = new XMLConfiguration("XMLtest.xml");
/**
*
* #808080
* #000000
* #008000
*
* ${colors.header}
*
*这是从上面的xml中摘抄的一段，我们现在来解析它，
*colors是根标签下的直接子标签，所以是顶级名字空间
*/
String backColor = config.getString("colors.background");
String textColor = config.getString("colors.text");
//现在我们知道了如何读取标签下的数据，那么如何读标签中的属性呢？看下面
//
String linkNormal = config.getString("colors.link[@normal]");
//还支持引用呢！
//${colors.header}
String defColor = config.getString("colors.default");
//也支持其他类型，但是一定要确定类型正确，否则要报异常哦
//15
int rowsPerPage = config.getInt("rowsPerPage");
/**
*但是我们如何读取List呢
*看这里:
*
* OK,Cancel,Help
* Yes,No,Cancel
*
*/
这时我们可以用：
List buttons = config.getList("buttons.name");
for(String button:buttons){
System.out.println(button);
}
但是显示的是
OK Cancel Help Yes No Cancel
我们想要的是
OK,Cancel,Help Yes,No,Cancel
如果看过之前的文章就会知道，我们有一些设置没有设
也就是我们要禁用List分隔符delimiter.在AbstractionConfiguration
这个类中（XMLConfiguration的父类）有这个setDelimiterParsingDisabled方法可以
禁用分隔符。但是要在读取XML文件之前设置这个属性。所以代码改为
XMLConfiguration config = new XMLConfiguration();
config.setDelimiterParsingDisabled(true);
config.setFileName("XMLtest.xml");
config.load();
List buttons = config.getList("buttons.name");
for(String button:buttons){
System.out.println(button);
这就可以了。
再来个更加复杂一点的XML
users uid long uname java.lang.String firstName java.lang.String lastName java.lang.String java.lang.String
documents docid long name java.lang.String creationDate java.util.Date authorID long version int
这个XML的结构是根节点为database
database
|-table
|-name
|-fields
|-field
|-field
|-table
|-name
|-fields
|-field
|-field
眼尖的一眼就能看穿这是一个数据库的定义文件,那么我们如何读取呢？
好吧，我们接上文，来看看吧
XMLConfiguration config = new XMLConfiguration();
config.setDelimiterParsingDisabled(true);
config.setFileName("tt/test2.xml");
config.load();
Object prop = config.getProperty("tables.table.name");
if(prop instanceof Collection)
{
System.out.println("Number of tables: " + ((Collection) prop).size());
}
前面的我就不说了，看看这句
Object prop = config.getProperty("tables.table.name");
if(prop instanceof Collection)
{
System.out.println("Number of tables: " + ((Collection) prop).size());
}
config读取属性的时候，会去看得到的是否是多个值，如果是，则把这些值存为一个Collection
对象。 所以会打印出
Number of tables: 2
在使用getProperty方法时，我们给不同的节点路径会给我们不同的值，直接看例子：
//return users
System.out.println(config.getProperty("tables.table(0).name"));
//return system
System.out.println(config.getProperty("tables.table(0)[@tableType]"));
//return documents
System.out.println(config.getProperty("tables.table(1).name"));
//return null,因为只有两个table所以这个值为null
System.out.println(config.getProperty("tables.table(2).name"));
//return [docid, name, creationDate, authorID, version]
//如果所要找的节点不存在唯一值，则返回Collection类型
System.out.println(config.getProperty("tables.table(1).fields.field.name"));
//[long, long]
//与上面的相同，返回值不唯一
System.out.println(config.getProperty("tables.table.fields.field(0).type"));
//return creationDate
System.out.println(config.getProperty("tables.table(1).fields.field(2).name"));