X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/6746dc89c47ed01b165cc1152533605f97eb8e8d..f562e4c6e5fac7bcb445985b99acbea4d706e6f0:/src/data/writer/Writer.js diff --git a/src/data/writer/Writer.js b/src/data/writer/Writer.js index f3af79e9..1dc7238e 100644 --- a/src/data/writer/Writer.js +++ b/src/data/writer/Writer.js @@ -14,68 +14,64 @@ If you are unsure which license is appropriate for your use, please contact the */ /** * @author Ed Spencer - * @class Ext.data.writer.Writer - * @extends Object - * - *
Base Writer class used by most subclasses of {@link Ext.data.proxy.Server}. This class is - * responsible for taking a set of {@link Ext.data.Operation} objects and a {@link Ext.data.Request} - * object and modifying that request based on the Operations.
- * - *For example a Ext.data.writer.Json would format the Operations and their {@link Ext.data.Model} - * instances based on the config options passed to the JsonWriter's constructor.
- * - *Writers are not needed for any kind of local storage - whether via a - * {@link Ext.data.proxy.WebStorage Web Storage proxy} (see {@link Ext.data.proxy.LocalStorage localStorage} - * and {@link Ext.data.proxy.SessionStorage sessionStorage}) or just in memory via a - * {@link Ext.data.proxy.Memory MemoryProxy}.
+ * + * Base Writer class used by most subclasses of {@link Ext.data.proxy.Server}. This class is responsible for taking a + * set of {@link Ext.data.Operation} objects and a {@link Ext.data.Request} object and modifying that request based on + * the Operations. + * + * For example a Ext.data.writer.Json would format the Operations and their {@link Ext.data.Model} instances based on + * the config options passed to the JsonWriter's constructor. + * + * Writers are not needed for any kind of local storage - whether via a {@link Ext.data.proxy.WebStorage Web Storage + * proxy} (see {@link Ext.data.proxy.LocalStorage localStorage} and {@link Ext.data.proxy.SessionStorage + * sessionStorage}) or just in memory via a {@link Ext.data.proxy.Memory MemoryProxy}. */ Ext.define('Ext.data.writer.Writer', { alias: 'writer.base', alternateClassName: ['Ext.data.DataWriter', 'Ext.data.Writer'], /** - * @cfg {Boolean} writeAllFields True to write all fields from the record to the server. If set to false it - * will only send the fields that were modified. Defaults to true. Note that any fields that have - * {@link Ext.data.Field#persist} set to false will still be ignored. + * @cfg {Boolean} writeAllFields + * True to write all fields from the record to the server. If set to false it will only send the fields that were + * modified. Note that any fields that have {@link Ext.data.Field#persist} set to false will still be ignored. */ writeAllFields: true, /** - * @cfg {String} nameProperty This property is used to read the key for each value that will be sent to the server. - * For example: - *
-Ext.define('Person', {
- extend: 'Ext.data.Model',
- fields: [{
- name: 'first',
- mapping: 'firstName'
- }, {
- name: 'last',
- mapping: 'lastName'
- }, {
- name: 'age'
- }]
-});
-new Ext.data.writer.Writer({
- writeAllFields: true,
- nameProperty: 'mapping'
-});
-
-// This will be sent to the server
-{
- firstName: 'first name value',
- lastName: 'last name value',
- age: 1
-}
-
- *
- * Defaults to name. If the value is not present, the field name will always be used.
+ * @cfg {String} nameProperty
+ * This property is used to read the key for each value that will be sent to the server. For example:
+ *
+ * Ext.define('Person', {
+ * extend: 'Ext.data.Model',
+ * fields: [{
+ * name: 'first',
+ * mapping: 'firstName'
+ * }, {
+ * name: 'last',
+ * mapping: 'lastName'
+ * }, {
+ * name: 'age'
+ * }]
+ * });
+ * new Ext.data.writer.Writer({
+ * writeAllFields: true,
+ * nameProperty: 'mapping'
+ * });
+ *
+ * // This will be sent to the server
+ * {
+ * firstName: 'first name value',
+ * lastName: 'last name value',
+ * age: 1
+ * }
+ *
+ * If the value is not present, the field name will always be used.
*/
nameProperty: 'name',
/**
* Creates new Writer.
- * @param {Object} config (optional) Config object.
+ * @param {Object} [config] Config object.
*/
constructor: function(config) {
Ext.apply(this, config);
@@ -100,11 +96,11 @@ new Ext.data.writer.Writer({
},
/**
- * Formats the data for each record before sending it to the server. This
- * method should be overridden to format the data in a way that differs from the default.
+ * Formats the data for each record before sending it to the server. This method should be overridden to format the
+ * data in a way that differs from the default.
* @param {Object} record The record that we are writing to the server.
- * @return {Object} An object literal of name/value keys to be written to the server.
- * By default this method returns the data property on the record.
+ * @return {Object} An object literal of name/value keys to be written to the server. By default this method returns
+ * the data property on the record.
*/
getRecordData: function(record) {
var isPhantom = record.phantom === true,