/*
* Ext JS Library 2.2
* Copyright(c) 2006-2008, Ext JS, LLC.
* licensing@extjs.com
*
* http://extjs.com/license
*/
/** * @class Ext.data.Record * Instances of this class encapsulate both Record definition information, and Record * value information for use in {@link Ext.data.Store} objects, or any code which needs * to access Records cached in an {@link Ext.data.Store} object. * * Constructors for this class are generated by passing an Array of field definition objects to {@link #create}. * Instances are usually only created by {@link Ext.data.Reader} implementations when processing unformatted data * objects. * * Record objects generated by this constructor inherit all the methods of Ext.data.Record listed below. * @constructor * This constructor should not be used to create Record objects. Instead, use the constructor generated by * {@link #create}. The parameters are the same. * @param {Array} data An object, the properties of which provide values for the new Record's fields. * @param {Object} id (Optional) The id of the Record. This id should be unique, and is used by the * {@link Ext.data.Store} object which owns the Record to index its collection of Records. If * not specified an integer id is generated. */ Ext.data.Record = function(data, id){ this.id = (id || id === 0) ? id : ++Ext.data.Record.AUTO_ID; this.data = data; }; /** * Generate a constructor for a specific Record layout. * @param {Array} o An Array of field definition objects which specify field names, and optionally, * data types, and a mapping for an {@link Ext.data.Reader} to extract the field's value from a data object. * Each field definition object may contain the following properties: * name : StringThe name by which the field is referenced within the Record. This is referenced by, * for example, the dataIndex property in column definition objects passed to {@link Ext.grid.ColumnModel} * mapping : String(Optional) A path specification for use by the {@link Ext.data.Reader} implementation * that is creating the Record to access the data value from the data object. If an {@link Ext.data.JsonReader} * is being used, then this is a string containing the javascript expression to reference the data relative to * the Record item's root. If an {@link Ext.data.XmlReader} is being used, this is an {@link Ext.DomQuery} path * to the data item relative to the Record element. If the mapping expression is the same as the field name, * this may be omitted. * type : String(Optional) The data type for conversion to displayable value. Possible values are * auto (Default, implies no conversion) * string * int * float * boolean * date * sortType : Mixed(Optional) A member of {@link Ext.data.SortTypes}. * sortDir : String(Optional) Initial direction to sort. "ASC" or "DESC" * convert : Function(Optional) A function which converts the value provided * by the Reader into an object that will be stored in the Record. It is passed the * following parameters: * v : MixedThe data value as read by the Reader. * rec : MixedThe data object containing the row as read by the Reader. * Depending on Reader type, this could be an Array, an object, or an XML element. * * dateFormat : String(Optional) A format String for the Date.parseDate function. * defaultValue : Mixed(Optional) The default value passed to the Reader when the field does * not exist in the data object (i.e. undefined). (defaults to "") * * usage: var TopicRecord = Ext.data.Record.create([ {name: 'title', mapping: 'topic_title'}, {name: 'author', mapping: 'username'}, {name: 'totalPosts', mapping: 'topic_replies', type: 'int'}, {name: 'lastPost', mapping: 'post_time', type: 'date'}, {name: 'lastPoster', mapping: 'user2'}, {name: 'excerpt', mapping: 'post_text'} ]); var myNewRecord = new TopicRecord({ topic_title: 'Do my job please', username: 'noobie', topic_replies: 1, post_time: new Date(), user2: 'Animal', post_text: 'No way dude!' }); myStore.add(myNewRecord); * In the simplest case, if no properties other than name are required, a field definition * may consist of just a field name string. * @method create * @return {function} A constructor which is used to create new Records according * to the definition. * @static */ Ext.data.Record.create = function(o){ var f = Ext.extend(Ext.data.Record, {}); var p = f.prototype; p.fields = new Ext.util.MixedCollection(false, function(field){ return field.name; }); for(var i = 0, len = o.length; i < len; i++){ p.fields.add(new Ext.data.Field(o[i])); } f.getField = function(name){ return p.fields.get(name); }; return f; }; Ext.data.Record.AUTO_ID = 1000; Ext.data.Record.EDIT = 'edit'; Ext.data.Record.REJECT = 'reject'; Ext.data.Record.COMMIT = 'commit'; Ext.data.Record.prototype = { /** * An object hash representing the data for this Record. * @property data * @type {Object} */ /** * The unique ID of the Record as specified at construction time. * @property id * @type {Object} */ /** * Readonly flag - true if this Record has been modified. * @type Boolean */ dirty : false, editing : false, error: null, /** * This object contains a key and value storing the original values of all modified fields or is null if no fields have been modified. * @property modified * @type {Object} */ modified: null, // private join : function(store){ this.store = store; }, /** * Set the named field to the specified value. * @param {String} name The name of the field to set. * @param {Object} value The value to set the field to. */ set : function(name, value){ if(String(this.data[name]) == String(value)){ return; } this.dirty = true; if(!this.modified){ this.modified = {}; } if(typeof this.modified[name] == 'undefined'){ this.modified[name] = this.data[name]; } this.data[name] = value; if(!this.editing && this.store){ this.store.afterEdit(this); } }, /** * Get the value of the named field. * @param {String} name The name of the field to get the value of. * @return {Object} The value of the field. */ get : function(name){ return this.data[name]; }, /** * Begin an edit. While in edit mode, no events are relayed to the containing store. */ beginEdit : function(){ this.editing = true; this.modified = {}; }, /** * Cancels all changes made in the current edit operation. */ cancelEdit : function(){ this.editing = false; delete this.modified; }, /** * End an edit. If any data was modified, the containing store is notified. */ endEdit : function(){ this.editing = false; if(this.dirty && this.store){ this.store.afterEdit(this); } }, /** * Usually called by the {@link Ext.data.Store} which owns the Record. * Rejects all changes made to the Record since either creation, or the last commit operation. * Modified fields are reverted to their original values. * * Developers should subscribe to the {@link Ext.data.Store#update} event to have their code notified * of reject operations. * @param {Boolean} silent (optional) True to skip notification of the owning store of the change (defaults to false) */ reject : function(silent){ var m = this.modified; for(var n in m){ if(typeof m[n] != "function"){ this.data[n] = m[n]; } } this.dirty = false; delete this.modified; this.editing = false; if(this.store && silent !== true){ this.store.afterReject(this); } }, /** * Usually called by the {@link Ext.data.Store} which owns the Record. * Commits all changes made to the Record since either creation, or the last commit operation. * * Developers should subscribe to the {@link Ext.data.Store#update} event to have their code notified * of commit operations. * @param {Boolean} silent (optional) True to skip notification of the owning store of the change (defaults to false) */ commit : function(silent){ this.dirty = false; delete this.modified; this.editing = false; if(this.store && silent !== true){ this.store.afterCommit(this); } }, /** * Gets a hash of only the fields that have been modified since this Record was created or commited. * @return Object */ getChanges : function(){ var m = this.modified, cs = {}; for(var n in m){ if(m.hasOwnProperty(n)){ cs[n] = this.data[n]; } } return cs; }, // private hasError : function(){ return this.error != null; }, // private clearError : function(){ this.error = null; }, /** * Creates a copy of this Record. * @param {String} id (optional) A new Record id if you don't want to use this Record's id * @return {Record} */ copy : function(newId) { return new this.constructor(Ext.apply({}, this.data), newId || this.id); }, /** * Returns true if the field passed has been modified since the load or last commit. * @param {String} fieldName * @return {Boolean} */ isModified : function(fieldName){ return !!(this.modified && this.modified.hasOwnProperty(fieldName)); } };
