Ruby中XML格式資料處理庫REXML的使用方法指南_ruby專題

以樹方式使用 REXML
REXML 的目的是 正好夠用。在最大程度上，它能很好地完成任務。 實際上， REXML 支援兩種不同樣式的 XML 處理 ― “樹”和“流”。 第一種樣式是 DOM 所嘗試要做的更簡單的版本；第二種樣式是 SAX 所嘗試要做的更簡單的版本。 讓我們先研究樹樣式。假設我們要提取上一個樣本中的同一個地址簿文檔。 下面的樣本來自我所建立的經修改的 eval.rb ； 標準 eval.rb （連結到 Ruby 教程）可以根據對複雜物件的運算式求值顯示非常長的計算結果 ― 我的 eval.rb 在沒有錯誤發生的情況下不作出反應：
如何使用 REXML 來引用嵌套資料

ruby> require "rexml/document"ruby> include REXMLruby> addrbook = (Document.new File.new "address.xml").rootruby> persons = addrbook.elements.to_a("//person")ruby> puts persons[1].elements["address"].attributes["city"]New York

這個運算式很普通。 .to_a() 方法建立文檔中所有 <person> 元素的數組，在其它命名中它可能是有用的。 元素有點象 DOM 節點，但它其實更接近於 XML 本身（而且使用起來也更簡單）。 .to_a() 的參數是 XPath，在這種情況下，可以標識文檔中任何地方的所有 <person> 元素。如果我們只需要第一層上的元素，可以使用：
建立匹配元素的數組

ruby> persons = addrbook.elements.to_a("/addressbook/person")

我們甚至可以更直接地將 XPath 用作 .elements 屬性的重載索引。例如：
使用 REXML 來引用嵌套資料的另一種方法

ruby> puts addrbook.elements["//person[2]/address"].attributes["city"]New York

請注意，XPath 使用基於 1 的索引，不象 Ruby 和 Python 數組使用基於 0 的索引。換句話說， 它仍是我們正在檢查其所在城市的同一個人。通過查看 REXML 請注意，XPath 使用基於 1 的索引，不象 Ruby 和 Python 數組使用基於 0 的索引。換句話說， 它仍是我們正在檢查其所在城市的同一個人。通過查看
用 REXML 顯示元素的 XML 摘要代碼

ruby> puts addrbook.elements["//person[2]/address"]<address city='New York' street='118 St.' number='344' state='NY'/>ruby> puts addrbook.elements["//person[2]/contact-info"]<contact-info> <email address='robb@iro.ibm.com'/> <home-phone number='03-3987873'/></contact-info>

此外，XPath 不必只與一個元素匹配。我們已在定義 persons 數組時看見過，但另一個樣本強調了這一點：
將多個元素與 XPath 匹配

ruby> puts addrbook.elements.to_a("//person/address[@state='CA']")<address city='Sacramento' street='Spruce Rd.' number='99' state='CA'/><address city='Los Angeles' street='Pine Rd.' number='1234' state='CA'/>

與此相反， .elements 屬性的索引只產生 第一個匹配的元素：
當 XPath 只匹配第一次出現時

ruby> puts addrbook.elements.to_a("//person/address[@state='CA']")<address city='Sacramento' street='Spruce Rd.' number='99' state='CA'/><address city='Los Angeles' street='Pine Rd.' number='1234' state='CA'/>

也可以通過 REXML 中的 XPath 類使用 XPath 地址， 它具有諸如 .first() 、 .each() 和 .match() 這樣的方法。
REXML 元素的一個獨特的慣用方法是 .each 迭代器。雖然 Ruby 有一個可對集合進行操作的迴圈結構 for ， 但 Ruby 程式員通常更喜歡使用迭代器方法來將控制傳遞給代碼塊。下面的兩種結構是等價的， 但第二種結構有更為自然的 Ruby 感覺：
通過在 REXML 中匹配 XPath 進行迭代

ruby> for addr in addrbook.elements.to_a("//address[@state='CA']")  |  puts addr.attributes["city"]  | endSacramentoLos Angelesruby> addrbook.elements.each("//address[@state='CA']") {  |  |addr| puts addr.attributes["city"]  | }SacramentoLos Angeles

以流方式使用 REXML
出於“正好夠用”的目的， REXML 的樹方式可能是 Ruby 語言最簡單的方法。 但 REXML 還提供了一種流方式，它象是 SAX 的更輕量級的變體。 正如使用 SAX 一樣， REXML 沒有嚮應用程式程式員提供來自 XML 文檔的預設資料結構。 相反，“listener”或“handler”類負責提供響應文檔流中各種事件的一組方法。 以下是常用集合：開始標記、結束標記、遇到的元素文本等等。
雖然流方式遠遠沒有象以樹方式工作那樣容易，但通常它的速度要快很多。 REXML 教程聲稱流方式的速度要快 1500倍。 雖然我沒有嘗試過對它進行基準測試，但我猜想這是一種有限的情況（我的小樣本在樹方式中也是瞬間完成的）。 總之，如果速度要緊，那麼速度上的差異很可能是顯著的。
讓我們研究一個非常簡單的樣本，它所做的事情與上面的“列出加州城市”樣本相同。 對它進行擴充以用於複雜的文檔處理相對比較簡單：
REXML 中 XML 文檔的流處理

ruby> require "rexml/document"ruby> require "rexml/streamlistener"ruby> include REXMLruby> class Handler  |  include StreamListener  |  def tag_start name, attrs  |    if name=="address" and attrs.assoc("state")[1]=="CA"  |     puts attrs.assoc("city")[1]  |    end  |  end  | endruby> Document.parse_stream((File.new "address.xml"), Handler.new)SacramentoLos Angeles

流處理樣本中要注意的一件事情是，標記屬性被作為一組數組傳遞， 它要處理的工作比起散列要稍微多一點（但可能在庫中建立會更快）。

編碼問題
REXML所有文本節點中都是以UTF-8編碼的，所有調用的代碼都要注意這一點，在程式中，傳遞給REXML的字串必須是經過UTF-8編碼的。

REXML不可能總是正確猜測出你的文本的編碼方式，所以它總是假定為UTF-8編碼。同時，如果你試圖添加其他編碼方式的文本，REXML不會發 出警告。添加者必須保證自己添加的是UTF-8的文本。如果添加標準的ASCII 7位編碼，是沒有關係的。如果使用ISO8859-1文本，必須在添加之前轉換為UTF-8編碼。可以使用text.unpack("C").pack("U")。變更編碼進行輸出，只有Document.write()和Document.to_s() 支援。如果需要輸出特定編碼的節點，必須用Output把輸出對象封裝起來。

e = Element.new "<a/>"e.text = "f\xfcr"  # ISO-8859-1 '??'o = ''e.write( Output.new( o, "ISO-8859-1" ) )

可以向Output傳遞任何支援的編碼。