讓J2SE1.5從 XML 中裝載屬性

來源:互聯網
上載者:User
j2se|xml   Properties 類已不是新東西了,它在 Java 編程的早期就有了,並且幾乎沒有什麼變化。J2SE 的 Tiger 版本增強了這個類,不僅可以用它在單獨一行中指定用等號分隔的多個鍵-值對,還可以用XML 檔案裝載和儲存這些鍵-值對。在 馴服 Tiger的系列文章中,John Zukowski 展示了如何駕馭這匹新一代的“役馬”。

  J2SE 1.5 以前的版本要求直接使用 XML 解析器來裝載設定檔並儲存設定。雖然這並非是一件困難的事情,並且解析器是平台的標準部分,但是額外的工作總是有點讓人煩。最新動向的 java.util.Properties 類現在提供了一種為程式裝載和儲存設定的更容易的方法: loadFromXML(InputStream is) 和 storeToXML(OutputStream os, String comment) 方法。

   Properties 基本知識

  如果不熟悉 java.util.Properties 類,那麼現在告訴您它是用來在一個檔案中儲存鍵-值對的,其中鍵和值是用等號分隔的,如清單 1 所示。

  清單 1. 一組屬性樣本

foo=bar
fu=baz


  將清單 1 裝載到 Properties 對象中後,您就可以找到兩個鍵( foo 和 fu )和兩個值( foo 的 bar 和 fu 的 baz )了。這個類支援帶 \u 的嵌入 Unicode 字串,但是這裡重要的是每一項內容都當作 String 。

   現在有了 J2SE 1.5 Beta 1

  清單 2 顯示了如何裝載屬性檔案並列出它當前的一組鍵和值。只需傳遞這個檔案的 InputStream 給 load() 方法,就會將每一個鍵-值對添加到 Properties 執行個體中。然後用 list() 列出所有屬性或者用 getProperty() 擷取單獨的屬性。

  清單 2. 裝載屬性

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"));
 }
}


  運行 LoadSample 程式產生如清單 3 所示的輸出。注意 list() 方法的輸出中鍵-值對的順序與它們在輸入檔案中的順序不一樣。 Properties 類在一個散列表(hashtable,事實上是一個 Hashtable 子類)中儲存一組鍵-值對,所以不能保證順序。

  清單 3. LoadSample 的輸出

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

The foo property: bar


   XML 屬性檔案

  這裡沒有什麼新內容。 Properties 類總是這樣工作的。不過,新的地方是從一個 XML 檔案中裝載一組屬性。它的 DTD 如清單 4 所示。

  清單 4. 屬性 DTD

<?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>


  如果不想細讀 XML DTD,那麼可以告訴您它其實就是說在外圍 <properties> 標籤中封裝的是一個 <comment> 標籤,後面是任意數量的 <entry> 標籤。對每一個 <entry> 標籤,有一個鍵屬性,輸入的內容就是它的值。清單 5 顯示了 清單 1中的屬性檔案的 XML 版本是什麼樣子的。

  清單 5. XML 版本的屬性檔案

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


  如果清單 6 所示,讀取 XML 版本的 Properties 檔案與讀取老格式的檔案沒什麼不同。

  清單 6. 讀取 XML Properties 檔案

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"));
 }
}


   關於資源綁定的說明

  雖然 java.util.Properties 類現在除了支援鍵-值對,還支援屬性檔案作為 XML 檔案,不幸的是,沒有內建的選項可以將 ResourceBundle 作為一個 XML 檔案處理。是的, PropertyResourceBundle 不使用 Properties 對象來裝載綁定,不過裝載方法的使用是寫入程式碼到類中的,而不使用較新的 loadFromXML() 方法。

  運行清單 6 中的程式產生與原來的程式相同的輸出,如 清單 2所示。

   儲存 XML 屬性

  新的 Properties 還有一個功能是將屬性儲存區到 XML 格式的檔案中。雖然 store() 方法仍然會建立一個類似 清單 1 所示的檔案,但是現在可以用新的 storeToXML() 方法建立如 清單 5 所示的檔案。只要傳遞一個 OutputStream 和一個用於注釋的 String 就可以了。清單 7 展示了新的 storeToXML() 方法。

  清單 7. 將 Properties 儲存為 XML 檔案

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();
 }
}


  運行清單 7 中的程式產生的輸出如清單 8 所示。

  清單 8. 儲存的 XML 檔案

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/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>


   結束語

  使用 XML 檔案還是使用老式的 a=b 類型的檔案完全取決於您自己。老式檔案從記憶體的角度看肯定是輕量級的。不過,由於 XML 的普遍使用,人們會期望 XML 格式流行起來,因為它已經被廣泛使用了,只不過沒有用到 Properties 對象。選擇完全在您。分析軟體包 private XMLUtils 類的原始碼以獲得關於所使用的 XML 解析的更多資訊。

相關文章

Alibaba Cloud 10 Year Anniversary

With You, We are Shaping a Digital World, 2009-2019

Learn more >

Apsara Conference 2019

The Rise of Data Intelligence, September 25th - 27th, Hangzhou, China

Learn more >

Alibaba Cloud Free Trial

Learn and experience the power of Alibaba Cloud with a free trial worth $300-1200 USD

Learn more >

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。