Xml -ror

From Sandoz

http://www.germane-software.com/software/rexml/docs/tutorial.html

1) Accessing Elements

Contents 1 ====== 2 ====== 3 == 3.1 == 3.1.1 ======= 3.1.2 ===== 3.1.3 = 3.1.4 == 3.1.5 = 3.1.6 =============== 3.1.7 ==== 3.1.8 ====

======

doc = Document.new File.new("mydoc.xml") doc.elements.each("inventory/section") { |element| puts element.attributes["name"] }

1. -> health
2. -> food

doc.elements.each("*/section/item") { |element| puts element.attributes["upc"] }

1. -> 123456789
2. -> 445322344
3. -> 485672034
4. -> 132957764

root = doc.root puts root.attributes["title"]

1. -> OmniCorp Store #45x10^3

puts root.elements["section/item[@stock='44']"].attributes["upc"]

1. -> 132957764

puts root.elements["section"].attributes["name"]

1. -> health (returns the first encountered matching element)

puts root.elements[1].attributes["name"]

1. -> health (returns the FIRST child element)

root.detect {|node| node.kind_of? Element and node.attributes["name"] == "food" }

2) The source document

======

<inventory title="OmniCorp Store #45x10^3">

 <section name="health">
   <item upc="123456789" stock="12">
     <name>Invisibility Cream</name>
     <price>14.50</price>
     <description>Makes you invisible</description>
   </item>
   <item upc="445322344" stock="18">
     <name>Levitation Salve</name>
     <price>23.99</price>
     <description>Levitate yourself for up to 3 hours per application</description>
   </item>
 </section>
 <section name="food">
   <item upc="485672034" stock="653">
     <name>Blork and Freen Instameal</name>
     <price>4.95</price>
     <description>A tasty meal in a tablet; just add water</description>
   </item>
   <item upc="132957764" stock="44">
     <name>Grob winglets</name>
     <price>3.56</price>
     <description>Tender winglets of Grob. Just add water</description>
   </item>
 </section>

</inventory>

Using XPath

==

1. The invisibility cream is the first <item>

invisibility = XPath.first( doc, "//item" )

1. Prints out all of the prices

XPath.each( doc, "//price") { |element| puts element.text }

1. Gets an array of all of the "name" elements in the document.

names = XPath.match( doc, "//name" )

Using to_a()

==

all_elements = doc.elements.to_a all_children = doc.to_a all_upc_strings = doc.elements.to_a( "//item/attribute::upc" ) all_name_elements = doc.elements.to_a( "//name" )

Entity Replacement

=======

doc = Document.new '<!DOCTYPE foo [ <!ENTITY ent "replace"> ]><a>&ent;</a>' doc.root.text #-> "replace"

Creating elements

=====

el = someelement.add_element "myel"

1. creates an element named "myel", adds it to "someelement", and returns it

el2 = el.add_element "another", {"id"=>"10"}

1. does the same, but also sets attribute "id" of el2 to "10"

el3 = Element.new "blah" el1.elements << el3 el3.attributes["myid"] = "sean"

1. creates el3 "blah", adds it to el1, then sets attribute "myid" to "sean"

Adding text

=

el1 = Element.new "myelement" el1.text = "Hello world!"

1. -> <myelement>Hello world!</myelement>

el1.add_text "Hello dolly"

1. -> <myelement>Hello world!Hello dolly</element>

el1.add Text.new("Goodbye")

1. -> <myelement>Hello world!Hello dollyGoodbye</element>

el1 << Text.new(" cruel world")

1. -> <myelement>Hello world!Hello dollyGoodbye cruel world</element>

Encoded Output

==

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

Inserts

=

doc = Document.new "<a><one/><three/></a>" doc.root[1,0] = Element.new "two"

1. -> <a><one/><two/><three/></a>

three = doc.elements["a/three"] doc.root.insert_after three, Element.new "four"

1. -> <a><one/><two/><three/><four/></a>
2. A convenience method allows you to insert before/after an XPath:

doc.root.insert_after( "//one", Element.new("one-five") )

1. -> <a><one/><one-five/><two/><three/><four/></a>
2. Another convenience method allows you to insert after/before an element:

four = doc.elements["//four"] four.previous_sibling = Element.new("three-five")

1. -> <a><one/><one-five/><two/><three/><three-five/><four/></a>

Automatic raw text handling

===============

doc = REXML::Document.new( source, { :raw => %w{ tag1 tag2 tag3 } }

Raw documents

====

doc = REXML::Document.new( source, { :raw => :all })

Stream parsing

====

list = MyListener.new source = File.new "mydoc.xml" REXML::Document.parse_stream(source, list)