www.gusucode.com > 一个基于extjs的强大聊天插件源码程序 > 一个基于extjs的强大聊天插件/extjame/ext-jame/js/ext2/source/data/Record.js
/* * Ext JS Library 2.0.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 <em>definition</em> information, and record * <em>value</em> 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.<br> * <p> * 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.<br> * <p> * 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 associative Array of data values keyed by the field name. * @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: <ul> * <li><b>name</b> : String<p style="margin-left:1em">The name by which the field is referenced within the Record. This is referenced by, * for example the <em>dataIndex</em> property in column definition objects passed to {@link Ext.grid.ColumnModel}</p></li> * <li><b>mapping</b> : String<p style="margin-left:1em">(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.</p></li> * <li><b>type</b> : String<p style="margin-left:1em">(Optional) The data type for conversion to displayable value. Possible values are * <ul><li>auto (Default, implies no conversion)</li> * <li>string</li> * <li>int</li> * <li>float</li> * <li>boolean</li> * <li>date</li></ul></p></li> * <li><b>sortType</b> : Mixed<p style="margin-left:1em">(Optional) A member of {@link Ext.data.SortTypes}.</p></li> * <li><b>sortDir</b> : String<p style="margin-left:1em">(Optional) Initial direction to sort. "ASC" or "DESC"</p></li> * <li><b>convert</b> : Function<p style="margin-left:1em">(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:<ul> * <li><b>v</b> : Mixed<p style="margin-left:1em">The data value as read by the Reader.</p></li> * <li><b>rec</b> : Mixed<p style="margin-left:1em">The data object containting the row as read by the Reader. * Depending on Reader type, this could be an Array, an object, or an XML element.</p></li> * </ul></p></li> * <li><b>dateFormat</b> : String<p style="margin-left:1em">(Optional) A format String for the Date.parseDate function.</p></li> * </ul> * <br>usage:<br><pre><code> 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({ title: 'Do my job please', author: 'noobie', totalPosts: 1, lastPost: new Date(), lastPoster: 'Animal', excerpt: 'No way dude!' }); myStore.add(myNewRecord); </code></pre> * <p>In the simplest case, if no properties other than <tt>name</tt> are required, a field definition * may consist of just a field name string.</p> * @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 = { /** * The data for this record an object hash. * @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. * <p> * 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. * <p> * 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); } };