Apache Commons-configuration 学习笔记

转载自 http://wangxin0072000.iteye.com

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如下:
<?xml version="1.0" encoding="ISO-8859-1" ?>   
<gui-definition>   
  <colors>   
    <background>#808080</background>   
    <text>#000000</text>   
    <header>#008000</header>   
    <link normal="#000080" visited="#800080"/>   
    <default>${colors.header}</default>   
  </colors>   
  <rowsPerPage>15</rowsPerPage>   
  <buttons>   
    <name>OK,Cancel,Help</name>   
    <name>Yes,No,Cancel</name>   
  </buttons>   
  <numberFormat pattern="###\,###.##"/>   
</gui-definition>

标准的XML文件都会有一个跟标签包裹住所有内容,这个标签的子标签认为是顶级名字空间
(这个说法可能不准确)不多说了看代码吧
XMLConfiguration config = new XMLConfiguration("XMLtest.xml");   
/**  
    *<colors>  
  *  <background>#808080</background>  
  *  <text>#000000</text>  
  *  <header>#008000</header>  
  *  <link normal="#000080" visited="#800080"/>  
  *  <default>${colors.header}</default>  
  *</colors>  
    *这是从上面的xml中摘抄的一段,我们现在来解析它,  
    *colors是根标签下的直接子标签,所以是顶级名字空间  
    */  
String backColor = config.getString("colors.background");   
String textColor = config.getString("colors.text");   
//现在我们知道了如何读取标签下的数据,那么如何读标签中的属性呢?看下面   
//<link normal="#000080" visited="#800080"/>   
String linkNormal = config.getString("colors.link[@normal]");   
//还支持引用呢!   
//<default>${colors.header}</default>   
String defColor = config.getString("colors.default");   
//也支持其他类型,但是一定要确定类型正确,否则要报异常哦   
//<rowsPerPage>15</rowsPerPage>   
int rowsPerPage = config.getInt("rowsPerPage");  

/**  
    *但是我们如何读取List呢  
    *看这里:  
    *<buttons>  
  *  <name>OK,Cancel,Help</name>  
  *  <name>Yes,No,Cancel</name>  
  *</buttons>  
  */  
  这时我们可以用:   
  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<String> buttons = config.getList("buttons.name");   
        for(String button:buttons){   
            System.out.println(button);   

这就可以了。


再来个更加复杂一点的XML
<?xml version="1.0" encoding="ISO-8859-1" ?>   
<database>   
  <tables>   
    <table tableType="system">   
      <name>users</name>   
      <fields>   
        <field>   
          <name>uid</name>   
          <type>long</type>   
        </field>   
        <field>   
          <name>uname</name>   
          <type>java.lang.String</type>   
        </field>   
        <field>   
          <name>firstName</name>   
          <type>java.lang.String</type>   
        </field>   
        <field>   
          <name>lastName</name>   
          <type>java.lang.String</type>   
        </field>   
        <field>   
          <name>email</name>   
          <type>java.lang.String</type>   
        </field>   
      </fields>   
    </table>   
    <table tableType="application">   
      <name>documents</name>   
      <fields>   
        <field>   
          <name>docid</name>   
          <type>long</type>   
        </field>   
        <field>   
          <name>name</name>   
          <type>java.lang.String</type>   
        </field>   
        <field>   
          <name>creationDate</name>   
          <type>java.util.Date</type>   
        </field>   
        <field>   
          <name>authorID</name>   
          <type>long</type>   
        </field>   
        <field>   
          <name>version</name>   
          <type>int</type>   
        </field>   
      </fields>   
    </table>   
  </tables>   
</database>  

这个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"));  

你可能感兴趣的:(apache,数据结构,编程,xml)