1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7 <meta http-equiv="content-type" content="text/html; charset=undefined" />
8 <meta name="generator" content="JsDoc Toolkit" />
11 <title>JsDoc Reference - Roo.data.XmlReader</title>
14 <link rel="stylesheet" type="text/css" href="../../css/roojs.css" />
15 <link rel="stylesheet" type="text/css" href="../default.css" />
18 <script type="text/javascript" src="../page.js">
25 <body onload="RooDocsPage.onload();">
28 <div class="body-wrap">
30 <!-- ============================== links to methods. ================================= -->
32 <div class="top-tools">
34 <a class="inner-link" href="#Roo.data.XmlReader-props"><img src="resources/s.gif" class="item-icon icon-prop">Properties</a>
35 <a class="inner-link" href="#Roo.data.XmlReader-methods"><img src="resources/s.gif" class="item-icon icon-method">Methods</a>
36 <a class="inner-link" href="#Roo.data.XmlReader-events"><img src="resources/s.gif" class="item-icon icon-event">Events</a>
37 <a class="inner-link" href="#Roo.data.XmlReader-configs"><img src="resources/s.gif" class="item-icon icon-config">Config Options</a>
38 <a class="bookmark" href="NEED_TO_CREATE_DIRECT_LINK_HREF"><img src="resources/s.gif" class="item-icon icon-fav">Direct Link</a>
43 <!-- ============================== inheritance Block. ================================= -->
45 <div class="inheritance res-block">
46 <pre class="res-block-inner"><a href="./Roo.data.DataReader.html#constructor" roo:cls="Roo.data.DataReader.html#constructor">Roo.data.DataReader</a>
47 <img src="../../images/default/s.gif" height="1" width="20"/><img class="elbow" src="../../images/default/tree/elbow-end.gif"/>Roo.data.XmlReader
52 <!-- ============================== class title / details ============================ -->
55 <h1 class="classTitle">
57 Class Roo.data.XmlReader
60 <table cellspacing="0" class="class-summary-table">
62 <tr><td class="label">Package:</td><td class="hd-info">Roo.data</td></tr>
64 <tr><td class="label">Defined In:</td><td class="hd-info">
66 <a href="./src/Roo_data_XmlReader.js.html">Roo/data/XmlReader.js</a>.
69 <tr><td class="label">Class:</td><td class="hd-info">XmlReader</td></tr>
74 <tr><td class="label">Extends:</td><td class="hd-info">
75 <a href="./Roo.data.DataReader.html#constructor" roo:cls="Roo.data.DataReader.html#constructor">Roo.data.DataReader</a>
83 <!-- ============================== class summary ========================== -->
84 <div class="description">
85 Data reader class to create an Array of {<b>link</b> Roo.data.Record} objects from an XML document<br/>based on mappings in a provided Roo.data.Record constructor.<br><br><br/><p><br/><em>Note that in order for the browser to parse a returned XML document, the Content-Type<br/>header in the HTTP response must be set to "text/xml".</em><br/><p><br/>Example code:<br/><pre><code><br/>var RecordDef = Roo.data.Record.create([<br/> {name: 'name', mapping: 'name'}, // "mapping" property not needed if it's the same as "name"<br/> {name: 'occupation'} // This field will use "occupation" as the mapping.<br/>]);<br/>var myReader = new Roo.data.XmlReader({<br/> totalRecords: "results", // The element which contains the total dataset size (optional)<br/> record: "row", // The repeated element which contains row information<br/> id: "id" // The element within the row that provides an ID for the record (optional)<br/>}, RecordDef);<br/></code></pre><br/><p><br/>This would consume an XML file like this:<br/><pre><code><br/><?xml?><br/><dataset><br/> <results>2</results><br/> <row><br/> <id>1</id><br/> <name>Bill</name><br/> <occupation>Gardener</occupation><br/> </row><br/> <row><br/> <id>2</id><br/> <name>Ben</name><br/> <occupation>Horticulturalist</occupation><br/> </row><br/></dataset><br/></code></pre>
89 <!-- ============================== Class comment block... ========================== -->
91 <div class="comments">
92 <b>Class Comments / Notes</B> =>
93 <u onclick="parent.CommentDialog.showCommentId = 'Roo.data.XmlReader';">[Add Your comment/notes about this class]</u>
95 <iframe frameborder="0" id="comments-Roo.data" style="border: none;width:100%;"
96 src="/blog.php/GtkDjsComments/Roo.data.XmlReader.html"></iframe>
101 <!-- ============================== config options ========================== -->
106 <div class="hr"></div>
107 <a id="Roo.data.XmlReader-configs"></a>
113 <table cellspacing="0" class="member-table">
114 <caption>Config Options (Usually are also Properties)</caption>
118 <th class="sig-header" colspan="2">Options</th>
120 <th class="msource-header">Defined By</th>
127 <tr class="config-row expandable config-row-alt0 notInherited">
128 <td class="micon"><a class="exi" href="#expand"> </a></td>
131 <a id="Roo.data.XmlReader-cfg-id" name=".id"></a>
132 <div class="fixedFont">
133 <b class="itemname">id</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
139 <div class="short">The DomQuery path relative from the record element to the element that contains<br/>a record identifier value.</div>
143 <div class="long">The DomQuery path relative from the record element to the element that contains<br/>a record identifier value.</div>
157 <tr class="config-row expandable config-row-alt1 notInherited">
158 <td class="micon"><a class="exi" href="#expand"> </a></td>
161 <a id="Roo.data.XmlReader-cfg-record" name=".record"></a>
162 <div class="fixedFont">
163 <b class="itemname">record</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
169 <div class="short">The DomQuery path to the repeated element which contains record information.</div>
173 <div class="long">The DomQuery path to the repeated element which contains record information.</div>
187 <tr class="config-row expandable config-row-alt0 notInherited">
188 <td class="micon"><a class="exi" href="#expand"> </a></td>
191 <a id="Roo.data.XmlReader-cfg-success" name=".success"></a>
192 <div class="fixedFont">
193 <b class="itemname">success</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
199 <div class="short">The DomQuery path to the success attribute used by forms.</div>
203 <div class="long">The DomQuery path to the success attribute used by forms.</div>
217 <tr class="config-row expandable config-row-alt1 notInherited">
218 <td class="micon"><a class="exi" href="#expand"> </a></td>
221 <a id="Roo.data.XmlReader-cfg-totalRecords" name=".totalRecords"></a>
222 <div class="fixedFont">
223 <b class="itemname">totalRecords</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
229 <div class="short">The DomQuery path from which to retrieve the total number of records<br/>in the dataset.</div>
233 <div class="long">The DomQuery path from which to retrieve the total number of records<br/>in the dataset. This is only needed if the whole dataset is not passed in one go, but is being<br/>paged from the remote server.</div>
257 <!-- ============================== public properties ==================== -->
261 <a id="Roo.data.XmlReader-props"></a>
267 <table cellspacing="0" class="member-table">
268 <caption class="Empty">Public Properties - Has None</caption>
274 <!-- ============================== methods summary / details ======================== -->
277 <a id="Roo.data.XmlReader-methods"></a>
278 <!-- constructor?? -->
285 <!-- then dynamics first -->
292 <table cellspacing="0" class="member-table">
293 <caption>Public Methods</caption>
295 <th class="sig-header" colspan="2">Method</th>
296 <th class="msource-header">Defined By</th>
306 <tr class="method-row config-row-alt0 expandable notInherited">
307 <td class="micon"><a class="exi" href="#expand"> </a></td>
311 <a id="Roo.data-method-XmlReader" name=".XmlReader"></a>
312 <div class="fixedFont">
313 <span class="attributes">new <B>Roo.data.</B></span><b class="itemname">XmlReader</b>
315 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>meta</i></B>, Mixed <B><i>recordType</i></B>)
323 <div class="short">Create a new Roo.data.XmlReader</div>
330 Create a new Roo.data.XmlReader
333 <dl class="detailList">
334 <dt class="heading">Parameters:</dt>
337 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>meta</b>
340 <dd>Metadata configuration options</dd>
343 <span class="fixedFont">Mixed</span> <b>recordType</b>
346 <dd>The definition of the data record type to produce. This can be either a valid<br/>Record subclass created with {<b>link</b> Roo.data.Record<b>create</b>}, or an array of objects with which to call<br/>Roo.data.Record.create. See the {<b>link</b> Roo.data.Record} class for more details.</dd>
370 <tr class="method-row config-row-alt1 expandable">
371 <td class="micon"><a class="exi" href="#expand"> </a></td>
375 <a id="Roo.data.DataReader-method-newRow" name=".newRow"></a>
376 <div class="fixedFont">
377 <span class="attributes"></span><b class="itemname">newRow</b>
379 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>data</i></B>)
385 <a href="./Roo.data.Record.html#constructor" roo:cls="Roo.data.Record.html#constructor">Roo.data.Record</a>
394 <div class="short">Create an empty record</div>
400 Create an empty record
407 <dl class="detailList">
408 <dt class="heading">Parameters:</dt>
411 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>data</b>
414 <dd>(optional) - overlay some values</dd>
422 <dl class="detailList">
423 <dt class="heading">Returns:</dt>
425 <dd><span class="fixedFont"><a href="./Roo.data.Record.html#constructor" roo:cls="Roo.data.Record.html#constructor">Roo.data.Record</a></span> record created.</dd>
441 <a href="./Roo.data.DataReader.html#constructor" roo:cls="Roo.data.DataReader.html#constructor">Roo.data.DataReader</a>
447 <tr class="method-row config-row-alt0 expandable notInherited">
448 <td class="micon"><a class="exi" href="#expand"> </a></td>
452 <a id="Roo.data.XmlReader-method-read" name=".read"></a>
453 <div class="fixedFont">
454 <span class="attributes"></span><b class="itemname">read</b>
456 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>response</i></B>)
462 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
471 <div class="short">This method is only used by a DataProxy which has retrieved data from a remote server.</div>
477 This method is only used by a DataProxy which has retrieved data from a remote server.
484 <dl class="detailList">
485 <dt class="heading">Parameters:</dt>
488 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>response</b>
491 <dd>The XHR object which contains the parsed XML document. The response is expected<br/>to contain a method called 'responseXML' that returns an XML document object.</dd>
499 <dl class="detailList">
500 <dt class="heading">Returns:</dt>
502 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> records A data block which is used by an {<b>link</b> Roo.data.Store} as<br/>a cache of Roo.data.Records.</dd>
524 <tr class="method-row config-row-alt1 expandable notInherited">
525 <td class="micon"><a class="exi" href="#expand"> </a></td>
529 <a id="Roo.data.XmlReader-method-readRecords" name=".readRecords"></a>
530 <div class="fixedFont">
531 <span class="attributes"></span><b class="itemname">readRecords</b>
533 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>doc</i></B>)
539 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
548 <div class="short">Create a data block containing Roo.data.Records from an XML document.</div>
554 Create a data block containing Roo.data.Records from an XML document.
561 <dl class="detailList">
562 <dt class="heading">Parameters:</dt>
565 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>doc</b>
568 <dd>A parsed XML document.</dd>
576 <dl class="detailList">
577 <dt class="heading">Returns:</dt>
579 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> records A data block which is used by an {<b>link</b> Roo.data.Store} as<br/>a cache of Roo.data.Records.</dd>
604 <!-- ============================== events summary / details ======================== -->
607 <a id="Roo.data.XmlReader-events"></a>
613 <table cellspacing="0" class="member-table">
614 <caption class="Empty">Events - Has None</caption>
625 <!-- ============================== footer ================================= -->
626 <div class="fineprint" style="clear:both">
628 Documentation generated by <a href="http://www.akbkhome.com" target="_blankt">Introspection Doc Generator</a> on Mon Apr 07 2014 13:33:44 GMT+0800 (HKT)
630 <a href="http://www.jsdoctoolkit.org/" target="_blank">JsDoc Toolkit</a>