roxml 1.0 → 1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. data/MIT-LICENSE.txt +1 -1
  2. data/README +2 -0
  3. data/lib/roxml.rb +35 -33
  4. data/test/fixtures/book_text_with_attribute.xml +5 -0
  5. data/test/mocks/mocks.rb +12 -0
  6. data/test/test_roxml.rb +7 -0
  7. metadata +6 -49
  8. data/doc/classes/ROXML.html +0 -352
  9. data/doc/classes/ROXML.src/M000003.html +0 -19
  10. data/doc/classes/ROXML.src/M000004.html +0 -25
  11. data/doc/classes/ROXML.src/M000005.html +0 -22
  12. data/doc/classes/ROXML/ROXML_Class.html +0 -422
  13. data/doc/classes/ROXML/ROXML_Class.src/M000006.html +0 -27
  14. data/doc/classes/ROXML/ROXML_Class.src/M000007.html +0 -18
  15. data/doc/classes/ROXML/ROXML_Class.src/M000008.html +0 -19
  16. data/doc/classes/ROXML/ROXML_Class.src/M000009.html +0 -24
  17. data/doc/classes/ROXML/ROXML_Class.src/M000010.html +0 -24
  18. data/doc/classes/ROXML/ROXML_Class.src/M000011.html +0 -18
  19. data/doc/classes/ROXML/ROXML_Class.src/M000012.html +0 -18
  20. data/doc/classes/ROXML/XMLAttributeRef.html +0 -175
  21. data/doc/classes/ROXML/XMLAttributeRef.src/M000015.html +0 -19
  22. data/doc/classes/ROXML/XMLAttributeRef.src/M000016.html +0 -19
  23. data/doc/classes/ROXML/XMLObjectRef.html +0 -175
  24. data/doc/classes/ROXML/XMLObjectRef.src/M000013.html +0 -26
  25. data/doc/classes/ROXML/XMLObjectRef.src/M000014.html +0 -32
  26. data/doc/classes/ROXML/XMLRef.html +0 -212
  27. data/doc/classes/ROXML/XMLRef.src/M000017.html +0 -21
  28. data/doc/classes/ROXML/XMLRef.src/M000018.html +0 -18
  29. data/doc/classes/ROXML/XMLRef.src/M000019.html +0 -18
  30. data/doc/classes/ROXML/XMLTextRef.html +0 -193
  31. data/doc/classes/ROXML/XMLTextRef.src/M000020.html +0 -26
  32. data/doc/classes/ROXML/XMLTextRef.src/M000021.html +0 -33
  33. data/doc/classes/String.html +0 -165
  34. data/doc/classes/String.src/M000001.html +0 -23
  35. data/doc/classes/String.src/M000002.html +0 -23
  36. data/doc/created.rid +0 -1
  37. data/doc/files/lib/roxml_rb.html +0 -234
  38. data/doc/fr_class_index.html +0 -33
  39. data/doc/fr_file_index.html +0 -27
  40. data/doc/fr_method_index.html +0 -47
  41. data/doc/index.html +0 -24
  42. data/doc/rdoc-style.css +0 -208
data/doc/classes/ROXML/XMLTextRef.src/M000020.html DELETED
@@ -1,26 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>update_xml (ROXML::XMLTextRef)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre><span class="ruby-comment cmt"># File lib/roxml.rb, line 162</span>
14
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_xml</span>(<span class="ruby-identifier">xml</span>, <span class="ruby-identifier">value</span>)
15
- <span class="ruby-identifier">parent</span> = (<span class="ruby-identifier">wrapper</span> <span class="ruby-value">? </span><span class="ruby-identifier">xml</span>.<span class="ruby-identifier">add_element</span>(<span class="ruby-identifier">wrapper</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">xml</span>)
16
- <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">array</span>
17
- <span class="ruby-identifier">value</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
18
- <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">add_element</span>(<span class="ruby-identifier">name</span>).<span class="ruby-identifier">text</span> = (<span class="ruby-identifier">cdata</span> <span class="ruby-value">? </span><span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">CData</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">v</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">v</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>)
19
- <span class="ruby-keyword kw">end</span>
20
- <span class="ruby-keyword kw">else</span>
21
- <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">add_element</span>(<span class="ruby-identifier">name</span>).<span class="ruby-identifier">text</span> = (<span class="ruby-identifier">cdata</span> <span class="ruby-value">? </span><span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">CData</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>)
22
- <span class="ruby-keyword kw">end</span>
23
- <span class="ruby-identifier">xml</span>
24
- <span class="ruby-keyword kw">end</span></pre>
25
- </body>
26
- </html>
data/doc/classes/ROXML/XMLTextRef.src/M000021.html DELETED
@@ -1,33 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>populate (ROXML::XMLTextRef)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre><span class="ruby-comment cmt"># File lib/roxml.rb, line 176</span>
14
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">populate</span>(<span class="ruby-identifier">xml</span>, <span class="ruby-identifier">instance</span>)
15
- <span class="ruby-identifier">data</span> = <span class="ruby-keyword kw">nil</span>
16
- <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">array</span>
17
- <span class="ruby-identifier">child</span> = <span class="ruby-identifier">xml</span>.<span class="ruby-identifier">elements</span>[<span class="ruby-value">1</span>, <span class="ruby-identifier">name</span>]
18
- <span class="ruby-identifier">data</span> = <span class="ruby-identifier">child</span>.<span class="ruby-identifier">text</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">child</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">child</span>.<span class="ruby-identifier">text</span>
19
- <span class="ruby-keyword kw">else</span>
20
- <span class="ruby-identifier">xpath</span> = (<span class="ruby-identifier">wrapper</span> <span class="ruby-value">? </span><span class="ruby-node">&quot;#{wrapper}/#{name}&quot;</span> <span class="ruby-operator">:</span> <span class="ruby-node">&quot;#{name}&quot;</span>)
21
- <span class="ruby-identifier">data</span> = []
22
- <span class="ruby-identifier">xml</span>.<span class="ruby-identifier">each_element</span>(<span class="ruby-identifier">xpath</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span>
23
- <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">text</span>
24
- <span class="ruby-identifier">data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">text</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">to_latin</span>
25
- <span class="ruby-keyword kw">end</span>
26
- <span class="ruby-keyword kw">end</span>
27
-
28
- <span class="ruby-keyword kw">end</span>
29
- <span class="ruby-identifier">instance</span>.<span class="ruby-identifier">instance_variable_set</span>(<span class="ruby-node">&quot;@#{accessor}&quot;</span>, <span class="ruby-identifier">data</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">data</span>
30
- <span class="ruby-identifier">instance</span>
31
- <span class="ruby-keyword kw">end</span></pre>
32
- </body>
33
- </html>
data/doc/classes/String.html DELETED
@@ -1,165 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
- <head>
8
- <title>Class: String</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
- <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
12
- <script type="text/javascript">
13
- // <![CDATA[
14
-
15
- function popupCode( url ) {
16
- window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
- }
18
-
19
- function toggleCode( id ) {
20
- if ( document.getElementById )
21
- elem = document.getElementById( id );
22
- else if ( document.all )
23
- elem = eval( "document.all." + id );
24
- else
25
- return false;
26
-
27
- elemStyle = elem.style;
28
-
29
- if ( elemStyle.display != "block" ) {
30
- elemStyle.display = "block"
31
- } else {
32
- elemStyle.display = "none"
33
- }
34
-
35
- return true;
36
- }
37
-
38
- // Make codeblocks hidden by default
39
- document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
-
41
- // ]]>
42
- </script>
43
-
44
- </head>
45
- <body>
46
-
47
-
48
-
49
- <div id="classHeader">
50
- <table class="header-table">
51
- <tr class="top-aligned-row">
52
- <td><strong>Class</strong></td>
53
- <td class="class-name-in-header">String</td>
54
- </tr>
55
- <tr class="top-aligned-row">
56
- <td><strong>In:</strong></td>
57
- <td>
58
- <a href="../files/lib/roxml_rb.html">
59
- lib/roxml.rb
60
- </a>
61
- <br />
62
- </td>
63
- </tr>
64
-
65
- <tr class="top-aligned-row">
66
- <td><strong>Parent:</strong></td>
67
- <td>
68
- Object
69
- </td>
70
- </tr>
71
- </table>
72
- </div>
73
- <!-- banner header -->
74
-
75
- <div id="bodyContent">
76
-
77
-
78
-
79
- <div id="contextContent">
80
-
81
- <div id="description">
82
- <p>
83
- Extension of <a href="String.html">String</a> class to handle conversion
84
- from/to UTF-8/ISO-8869-1
85
- </p>
86
-
87
- </div>
88
-
89
-
90
- </div>
91
-
92
- <div id="method-list">
93
- <h3 class="section-bar">Methods</h3>
94
-
95
- <div class="name-list">
96
- <a href="#M000002">to_latin</a>&nbsp;&nbsp;
97
- <a href="#M000001">to_utf</a>&nbsp;&nbsp;
98
- </div>
99
- </div>
100
-
101
- </div>
102
-
103
-
104
- <!-- if includes -->
105
-
106
- <div id="section">
107
-
108
-
109
-
110
-
111
-
112
-
113
-
114
-
115
- <!-- if method_list -->
116
- <div id="methods">
117
- <h3 class="section-bar">Public Instance methods</h3>
118
-
119
- <div id="method-M000002" class="method-detail">
120
- <a name="M000002"></a>
121
-
122
- <div class="method-heading">
123
- <a href="String.src/M000002.html" target="Code" class="method-signature"
124
- onclick="popupCode('String.src/M000002.html');return false;">
125
- <span class="method-name">to_latin</span><span class="method-args">()</span>
126
- </a>
127
- </div>
128
-
129
- <div class="method-description">
130
- <p>
131
- Convert this string to iso-8850-1
132
- </p>
133
- </div>
134
- </div>
135
-
136
- <div id="method-M000001" class="method-detail">
137
- <a name="M000001"></a>
138
-
139
- <div class="method-heading">
140
- <a href="String.src/M000001.html" target="Code" class="method-signature"
141
- onclick="popupCode('String.src/M000001.html');return false;">
142
- <span class="method-name">to_utf</span><span class="method-args">()</span>
143
- </a>
144
- </div>
145
-
146
- <div class="method-description">
147
- <p>
148
- Return an utf-8 representation of this string.
149
- </p>
150
- </div>
151
- </div>
152
-
153
-
154
- </div>
155
-
156
-
157
- </div>
158
-
159
-
160
- <div id="validator-badges">
161
- <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
162
- </div>
163
-
164
- </body>
165
- </html>
data/doc/classes/String.src/M000001.html DELETED
@@ -1,23 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>to_utf (String)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre><span class="ruby-comment cmt"># File lib/roxml.rb, line 484</span>
14
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_utf</span>
15
- <span class="ruby-keyword kw">begin</span>
16
- <span class="ruby-constant">Iconv</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">&quot;utf-8&quot;</span>, <span class="ruby-value str">&quot;iso-8859-1&quot;</span>).<span class="ruby-identifier">iconv</span>(<span class="ruby-keyword kw">self</span>)
17
- <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Iconv</span><span class="ruby-operator">::</span><span class="ruby-constant">IllegalSequence</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
18
- <span class="ruby-constant">STDERR</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;!! Failed converting from UTF-8 -&gt; ISO-8859-1 (#{self}). Already the right charset?&quot;</span>
19
- <span class="ruby-keyword kw">self</span>
20
- <span class="ruby-keyword kw">end</span>
21
- <span class="ruby-keyword kw">end</span></pre>
22
- </body>
23
- </html>
data/doc/classes/String.src/M000002.html DELETED
@@ -1,23 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html>
7
- <head>
8
- <title>to_latin (String)</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
11
- </head>
12
- <body class="standalone-code">
13
- <pre><span class="ruby-comment cmt"># File lib/roxml.rb, line 496</span>
14
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_latin</span>
15
- <span class="ruby-keyword kw">begin</span>
16
- <span class="ruby-constant">Iconv</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">&quot;iso-8859-1&quot;</span>, <span class="ruby-value str">&quot;utf-8&quot;</span>).<span class="ruby-identifier">iconv</span>(<span class="ruby-keyword kw">self</span>)
17
- <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Iconv</span><span class="ruby-operator">::</span><span class="ruby-constant">IllegalSequence</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
18
- <span class="ruby-constant">STDERR</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;!! Failed converting from ISO-8859-1 -&gt; UTF-8 (#{self}). Already the right charset?&quot;</span>
19
- <span class="ruby-keyword kw">self</span>
20
- <span class="ruby-keyword kw">end</span>
21
- <span class="ruby-keyword kw">end</span></pre>
22
- </body>
23
- </html>
data/doc/created.rid DELETED
@@ -1 +0,0 @@
1
- Sat Jul 01 14:31:23 EDT 2006
data/doc/files/lib/roxml_rb.html DELETED
@@ -1,234 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
-
6
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
- <head>
8
- <title>File: roxml.rb</title>
9
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
- <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
- <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
12
- <script type="text/javascript">
13
- // <![CDATA[
14
-
15
- function popupCode( url ) {
16
- window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
- }
18
-
19
- function toggleCode( id ) {
20
- if ( document.getElementById )
21
- elem = document.getElementById( id );
22
- else if ( document.all )
23
- elem = eval( "document.all." + id );
24
- else
25
- return false;
26
-
27
- elemStyle = elem.style;
28
-
29
- if ( elemStyle.display != "block" ) {
30
- elemStyle.display = "block"
31
- } else {
32
- elemStyle.display = "none"
33
- }
34
-
35
- return true;
36
- }
37
-
38
- // Make codeblocks hidden by default
39
- document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
-
41
- // ]]>
42
- </script>
43
-
44
- </head>
45
- <body>
46
-
47
-
48
-
49
- <div id="fileHeader">
50
- <h1>roxml.rb</h1>
51
- <table class="header-table">
52
- <tr class="top-aligned-row">
53
- <td><strong>Path:</strong></td>
54
- <td>lib/roxml.rb
55
- </td>
56
- </tr>
57
- <tr class="top-aligned-row">
58
- <td><strong>Last Update:</strong></td>
59
- <td>Sat Jul 01 14:16:11 EDT 2006</td>
60
- </tr>
61
- </table>
62
- </div>
63
- <!-- banner header -->
64
-
65
- <div id="bodyContent">
66
-
67
-
68
-
69
- <div id="contextContent">
70
-
71
- <div id="description">
72
- <p>
73
- <a href="../../classes/ROXML.html">ROXML</a> Ruby Object to XML mapping
74
- library. For more information visit <a
75
- href="http://roxml.rubyforge.org">roxml.rubyforge.org</a>
76
- </p>
77
- <p>
78
- Copyright &#169; 2004-2006 Zak Mandhro and Anders Engstrom
79
- </p>
80
- <p>
81
- Permission is hereby granted, free of charge, to any person obtaining a
82
- copy of this software and associated documentation files (the
83
- &quot;Software&quot;), to deal in the Software without restriction,
84
- including without limitation the rights to use, copy, modify, merge,
85
- publish, distribute, sublicense, and/or sell copies of the Software, and to
86
- permit persons to whom the Software is furnished to do so, subject to the
87
- following conditions:
88
- </p>
89
- <p>
90
- The above copyright notice and this permission notice shall be included in
91
- all copies or substantial portions of the Software.
92
- </p>
93
- <p>
94
- THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND,
95
- EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
96
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
97
- NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
98
- DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
99
- OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
100
- USE OR OTHER DEALINGS IN THE SOFTWARE.
101
- </p>
102
- <h1>Quick Start Guide</h1>
103
- <p>
104
- This is a short usage example. See <a
105
- href="../../classes/ROXML/ROXML_Class.html">ROXML::ROXML_Class</a> and
106
- packaged test cases for more information.
107
- </p>
108
- <p>
109
- Consider an XML document representing a Library containing a number of
110
- Books. You can map this structure to Ruby classes that provide addition
111
- useful behavior. With <a href="../../classes/ROXML.html">ROXML</a>, you can
112
- annotate the Ruby classes as follows:
113
- </p>
114
- <pre>
115
- class Book
116
- include ROXML
117
-
118
- xml_attribute :isbn, &quot;ISBN&quot;
119
- xml_text :title
120
- xml_text :description, nil, ROXML::TAG_CDATA
121
- xml_text :author
122
- end
123
-
124
- class Library
125
- include ROXML
126
-
127
- xml_text :name, &quot;NAME&quot;, ROXML::TAG_CDATA
128
- xml_object :books, Book, ROXML::TAG_ARRAY, &quot;books&quot;
129
- end
130
- </pre>
131
- <p>
132
- To create a library and put a number of books in it we could run the
133
- following code:
134
- </p>
135
- <pre>
136
- book = Book.new()
137
- book.isbn = &quot;0201710897&quot;
138
- book.title = &quot;The PickAxe&quot;
139
- book.description = &quot;Best Ruby book out there!&quot;
140
- book.author = &quot;David Thomas, Andrew Hunt, Dave Thomas&quot;
141
-
142
- lib = Library.new()
143
- lib.name = &quot;Favorite Books&quot;
144
- lib &lt;&lt; book
145
- </pre>
146
- <p>
147
- To save this information to an XML file:
148
- </p>
149
- <pre>
150
- File.open(&quot;library.xml&quot;, &quot;w&quot;) do |f|
151
- lib.to_xml.write(f, 0)
152
- end
153
- </pre>
154
- <p>
155
- To later populate the library object from the XML file:
156
- </p>
157
- <pre>
158
- lib = Library.parse(File.read(&quot;library.xml&quot;))
159
- </pre>
160
- <p>
161
- Similarly, to do a one-to-one mapping between XML objects, such as book and
162
- publisher, you would use the <b>xml_object</b> annotation. For example:
163
- </p>
164
- <pre>
165
- &lt;book isbn=&quot;0974514055&quot;&gt;
166
- &lt;title&gt;Programming Ruby - 2nd Edition&lt;/title&gt;
167
- &lt;description&gt;Second edition of the great book.&lt;/description&gt;
168
- &lt;publisher&gt;
169
- &lt;name&gt;Pragmatic Bookshelf&lt;/name&gt;
170
- &lt;/publisher&gt;
171
- &lt;/book&gt;
172
- </pre>
173
- <p>
174
- can be mapped using the following code:
175
- </p>
176
- <pre>
177
- class BookWithPublisher
178
- include ROXML
179
-
180
- xml_name :book
181
- xml_object :publisher, Publisher
182
- end
183
- </pre>
184
- <p>
185
- Note: In the above example, <em>xml_name</em> annotation tells <a
186
- href="../../classes/ROXML.html">ROXML</a> to set the element name to
187
- &quot;book&quot; for mapping to XML. The default is XML element name is the
188
- class name in lowercase; &quot;bookwithpublisher&quot; in this case.
189
- </p>
190
- <p>
191
- For more information on available annotations, see <a
192
- href="../../classes/ROXML/ROXML_Class.html">ROXML::ROXML_Class</a>
193
- </p>
194
-
195
- </div>
196
-
197
- <div id="requires-list">
198
- <h3 class="section-bar">Required files</h3>
199
-
200
- <div class="name-list">
201
- rexml/document&nbsp;&nbsp;
202
- iconv&nbsp;&nbsp;
203
- </div>
204
- </div>
205
-
206
- </div>
207
-
208
-
209
- </div>
210
-
211
-
212
- <!-- if includes -->
213
-
214
- <div id="section">
215
-
216
-
217
-
218
-
219
-
220
-
221
-
222
-
223
- <!-- if method_list -->
224
-
225
-
226
- </div>
227
-
228
-
229
- <div id="validator-badges">
230
- <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
231
- </div>
232
-
233
- </body>
234
- </html>