java.util.Properties類的使用

燮羽 2010-12-15

展開全文

Properties 類已不是新東西了，它在 Java 編程的早期就有了，并且?guī)缀鯖]有什么變化。J2SE 的 Tiger 版本增強(qiáng)了這個(gè)類，不僅可以用它在單獨(dú)一行中指定用等號(hào)分隔的多個(gè)鍵-值對，還可以用XML 文件裝載和保存這些鍵-值對。在馴服 Tiger的這一期文章中，John Zukowski 展示了如何駕馭這匹新一代的“役馬”。

J2SE 1.5 以前的版本要求直接使用 XML 解析器來裝載配置文件并存儲(chǔ)設(shè)置。雖然這并非是一件困難的事情，并且解析器是平臺(tái)的標(biāo)準(zhǔn)部分，但是額外的工作總是有點(diǎn)讓人煩。最近更新的 java.util.Properties 類現(xiàn)在提供了一種為程序裝載和存儲(chǔ)設(shè)置的更容易的方法： loadFromXML(InputStream is) 和 storeToXML(OutputStream os, String comment) 方法。

Properties 基本知識(shí)
如果不熟悉 java.util.Properties 類，那么現(xiàn)在告訴您它是用來在一個(gè)文件中存儲(chǔ)鍵-值對的，其中鍵和值是用等號(hào)分隔的，如清單 1 所示。

清單 1. 一組屬性示例
foo=bar
fu=baz

將清單 1 裝載到 Properties 對象中后，您就可以找到兩個(gè)鍵（ foo 和 fu ）和兩個(gè)值（ foo 的 bar 和 fu 的 baz ）了。這個(gè)類支持帶 \u 的嵌入 Unicode 字符串，但是這里重要的是每一項(xiàng)內(nèi)容都當(dāng)作 String 。

清單 2 顯示了如何裝載屬性文件并列出它當(dāng)前的一組鍵和值。只需傳遞這個(gè)文件的 InputStream 給 load() 方法，就會(huì)將每一個(gè)鍵-值對添加到 Properties 實(shí)例中。然后用 list() 列出所有屬性或者用 getProperty() 獲取單獨(dú)的屬性。
清單 2. 裝載屬性

Java代碼 
import java.util.*;  
import java.io.*;  
  
public class LoadSample {  
    public static void main(String args[]) throws Exception {  
      Properties prop = new Properties();  
      FileInputStream fis =   
        new FileInputStream("sample.properties");  
      prop.load(fis);  
      prop.list(System.out);  
      System.out.println("\nThe foo property: " +  
          prop.getProperty("foo"));  
    }  
}  

運(yùn)行 LoadSample 程序生成如清單 3 所示的輸出。注意 list() 方法的輸出中鍵-值對的順序與它們在輸入文件中的順序不一樣。 Properties 類在一個(gè)散列表（hashtable，事實(shí)上是一個(gè) Hashtable 子類）中儲(chǔ)存一組鍵-值對，所以不能保證順序。

清單 3. LoadSample 的輸出

-- listing properties --
fu=baz
foo=bar

The foo property: bar

XML 屬性文件
這里沒有什么新內(nèi)容。 Properties 類總是這樣工作的。不過，新的地方是從一個(gè) XML 文件中裝載一組屬性。它的 DTD 如清單 4 所示。

清單 4. 屬性 DTD

dtd 寫道

Java代碼 
<?xml version="1.0" encoding="UTF-8"?>   
<!-- DTD for properties -->   
<!ELEMENT properties ( comment?, entry* ) >   
<!ATTLIST properties version CDATA #FIXED "1.0">   
<!ELEMENT comment (#PCDATA) >   
<!ELEMENT entry (#PCDATA) >   
<!ATTLIST entry key CDATA #REQUIRED>  

如果不想細(xì)讀 XML DTD，那么可以告訴您它其實(shí)就是說在外圍 <properties> 標(biāo)簽中包裝的是一個(gè) <comment> 標(biāo)簽，后面是任意數(shù)量的 <entry> 標(biāo)簽。對每一個(gè) <entry> 標(biāo)簽，有一個(gè)鍵屬性，輸入的內(nèi)容就是它的值。清單 5 顯示了清單 1中的屬性文件的 XML 版本是什么樣子的。

清單 5. XML 版本的屬性文件

Java代碼 
<?xml version="1.0" encoding="UTF-8"?>  
<!DOCTYPE properties SYSTEM "http://java./dtd/properties.dtd">  
<properties>  
<comment>Hi</comment>  
<entry key="foo">bar</entry>  
<entry key="fu">baz</entry>  
</properties>  

如果清單 6 所示，讀取 XML 版本的 Properties 文件與讀取老格式的文件沒什么不同。
清單 6. 讀取 XML Properties 文件

Java代碼 
import java.util.*;  
import java.io.*;  
  
public class LoadSampleXML {  
    public static void main(String args[]) throws Exception {  
      Properties prop = new Properties();  
      FileInputStream fis =  
        new FileInputStream("sampleprops.xml");  
      prop.loadFromXML(fis);  
      prop.list(System.out);  
      System.out.println("\nThe foo property: " +  
          prop.getProperty("foo"));  
    }  
}  

關(guān)于資源綁定的說明
雖然 java.util.Properties 類現(xiàn)在除了支持鍵-值對，還支持屬性文件作為 XML 文件，不幸的是，沒有內(nèi)置的選項(xiàng)可以將 ResourceBundle 作為一個(gè) XML 文件處理。是的， PropertyResourceBundle 不使用 Properties 對象來裝載綁定，不過裝載方法的使用是硬編碼到類中的，而不使用較新的 loadFromXML() 方法。

運(yùn)行清單 6 中的程序產(chǎn)生與原來的程序相同的輸出，如清單 2所示。

保存 XML 屬性
新的 Properties 還有一個(gè)功能是將屬性存儲(chǔ)到 XML 格式的文件中。雖然 store() 方法仍然會(huì)創(chuàng)建一個(gè)類似清單 1 所示的文件，但是現(xiàn)在可以用新的 storeToXML() 方法創(chuàng)建如清單 5 所示的文件。只要傳遞一個(gè) OutputStream 和一個(gè)用于注釋的 String 就可以了。清單 7 展示了新的 storeToXML() 方法。

清單 7. 將 Properties 存儲(chǔ)為 XML 文件

Java代碼 
import java.util.*;  
import java.io.*;  
  
public class StoreXML {  
    public static void main(String args[]) throws Exception {  
      Properties prop = new Properties();  
      prop.setProperty("one-two", "buckle my shoe");  
      prop.setProperty("three-four", "shut the door");  
      prop.setProperty("five-six", "pick up sticks");  
      prop.setProperty("seven-eight", "lay them straight");  
      prop.setProperty("nine-ten", "a big, fat hen");  
      FileOutputStream fos =  
        new FileOutputStream("rhyme.xml");  
      prop.storeToXML(fos, "Rhyme");  
      fos.close();  
    }  
}  

運(yùn)行清單 7 中的程序產(chǎn)生的輸出如清單 8 所示。

清單 8. 存儲(chǔ)的 XML 文件

Java代碼 
<?xml version="1.0" encoding="UTF-8"?>  
<!DOCTYPE properties SYSTEM "http://java./dtd/properties.dtd">  
<properties>  
<comment>Rhyme</comment>  
<entry key="seven-eight">lay them straight</entry>  
<entry key="five-six">pick up sticks</entry>  
<entry key="nine-ten">a big, fat hen</entry>  
<entry key="three-four">shut the door</entry>  
<entry key="one-two">buckle my shoe</entry>  
</properties>  

結(jié)束語
使用 XML 文件還是使用老式的 a=b 類型的文件完全取決于您自己。老式文件從內(nèi)存的角度看肯定是輕量級的。不過，由于 XML 的普遍使用，人們會(huì)期望 XML 格式流行起來，因?yàn)樗呀?jīng)被廣泛使用了，只不過沒有用到 Properties 對象。選擇完全在您。分析軟件包 private XMLUtils 類的源代碼以獲得關(guān)于所使用的 XML 解析的更多信息。

Java代碼 
import java.io.FileInputStream;  
import java.io.IOException;  
import java.io.InputStream;  
import java.util.Properties;  
/** 
* 實(shí)現(xiàn)properties文件的讀取 
* @author bbflyerwww 
* @date 2006-08-02 
*/  
public class PTest {  
      public static void main(String[] args) {  
          try {  
              long start = System.currentTimeMillis();  
              InputStream is = new FileInputStream("conf.properties");  
              Properties p = new Properties();  
              p.load(is);  
              is.close();  
              System.out.println("SIZE : " + p.size());  
              System.out.println("homepage : " + p.getProperty("homepage"));  
              System.out.println("author : " + p.getProperty("author"));  
              System.out.println("school : " + p.getProperty("school"));  
              System.out.println("date : " + p.getProperty("date"));  
              long end = System.currentTimeMillis();   
              System.out.println("Cost : " + (end - start));  
          } catch (IOException ioe) {  
              ioe.printStackTrace();  
          }  
      }  
}  

conf.properties

Java代碼 
# Configuration fileauthor = bbflyerwww  
school = WuHan University  
date = 2006-08-02  

Result

SIZE:4
author : bbflyerwww
school : WuHan University
date : 2006-08-02
Cost : 0

本站是提供個(gè)人知識(shí)管理的網(wǎng)絡(luò)存儲(chǔ)空間，所有內(nèi)容均由用戶發(fā)布，不代表本站觀點(diǎn)。請注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購買等信息，謹(jǐn)防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容，請點(diǎn)擊一鍵舉報(bào)。

轉(zhuǎn)藏 分享

QQ空間 QQ好友新浪微博微信

獻(xiàn)花（0） +1

來自：燮羽 > 《Java》

舉報(bào)/認(rèn)領(lǐng)