X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/2e847cf21b8ab9d15fa167b315ca5b2fa92638fc..7a654f8d43fdb43d78b63d90528bed6e86b608cc:/docs/source/Array.html diff --git a/docs/source/Array.html b/docs/source/Array.html new file mode 100644 index 00000000..e51b813e --- /dev/null +++ b/docs/source/Array.html @@ -0,0 +1,67 @@ +
\ No newline at end of file/** + * @author Ed Spencer + * @class Ext.data.reader.Array + * @extends Ext.data.reader.Json + * + * <p>Data reader class to create an Array of {@link Ext.data.Model} objects from an Array. + * Each element of that Array represents a row of data fields. The + * fields are pulled into a Record object using as a subscript, the <code>mapping</code> property + * of the field definition if it exists, or the field's ordinal position in the definition.</p> + * + * <p><u>Example code:</u></p> + * +<pre><code> +Employee = Ext.define('Employee', { + extend: 'Ext.data.Model', + fields: [ + 'id', + {name: 'name', mapping: 1}, // "mapping" only needed if an "id" field is present which + {name: 'occupation', mapping: 2} // precludes using the ordinal position as the index. + ] +}); + +var myReader = new Ext.data.reader.Array({ + model: 'Employee' +}, Employee); +</code></pre> + * + * <p>This would consume an Array like this:</p> + * +<pre><code> +[ [1, 'Bill', 'Gardener'], [2, 'Ben', 'Horticulturalist'] ] +</code></pre> + * + * @constructor + * Create a new ArrayReader + * @param {Object} meta Metadata configuration options. + */ +Ext.define('Ext.data.reader.Array', { + extend: 'Ext.data.reader.Json', + alternateClassName: 'Ext.data.ArrayReader', + alias : 'reader.array', + + /** + * @private + * Most of the work is done for us by JsonReader, but we need to overwrite the field accessors to just + * reference the correct position in the array. + */ + buildExtractors: function() { + this.callParent(arguments); + + var fields = this.model.prototype.fields.items, + length = fields.length, + extractorFunctions = [], + i; + + for (i = 0; i < length; i++) { + extractorFunctions.push(function(index) { + return function(data) { + return data[index]; + }; + }(fields[i].mapping || i)); + } + + this.extractorFunctions = extractorFunctions; + } +}); +