X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/c930e9176a5a85509c5b0230e2bff5c22a591432..c8256059947f3aa8f5b0a9a2acf55e2142bb4742:/docs/source/JsonWriter.html diff --git a/docs/source/JsonWriter.html b/docs/source/JsonWriter.html index 8a25ed19..34706b2b 100644 --- a/docs/source/JsonWriter.html +++ b/docs/source/JsonWriter.html @@ -1,29 +1,23 @@ - -
-/** + + + ++ \ No newline at end of fileThe source code + + + + +/*! + * Ext JS Library 3.2.1 + * Copyright(c) 2006-2010 Ext JS, Inc. + * licensing@extjs.com + * http://www.extjs.com/license + */ +/** * @class Ext.data.JsonWriter * @extends Ext.data.DataWriter * DataWriter extension for writing an array or single {@link Ext.data.Record} object(s) in preparation for executing a remote CRUD action. */ -Ext.data.JsonWriter = function(config) { - Ext.data.JsonWriter.superclass.constructor.call(this, config); - - // careful to respect "returnJson", renamed to "encode" - // TODO: remove after v3 final release - if (this.returnJson != undefined) { - this.encode = this.returnJson; - } -} -Ext.extend(Ext.data.JsonWriter, Ext.data.DataWriter, { - /** - * @cfg {Boolean} returnJson Deprecated. Use {@link Ext.data.JsonWriter#encode} instead. - */ - returnJson : undefined, +Ext.data.JsonWriter = Ext.extend(Ext.data.DataWriter, { /** * @cfg {Boolean} encode true to {@link Ext.util.JSON#encode encode} the * {@link Ext.data.DataWriter#toHash hashed data}. Defaults to true. When using @@ -31,54 +25,74 @@ Ext.extend(Ext.data.JsonWriter, Ext.data.DataWriter, { * its own json-encoding. In addition, if you're using {@link Ext.data.HttpProxy}, setting to false * will cause HttpProxy to transmit data using the jsonData configuration-params of {@link Ext.Ajax#request} * instead of params. When using a {@link Ext.data.Store#restful} Store, some serverside frameworks are - * tuned to expect data through the jsonData mechanism. In those cases, one will want to set encode: false + * tuned to expect data through the jsonData mechanism. In those cases, one will want to set encode: false, as in + * let the lower-level connection object (eg: Ext.Ajax) do the encoding. */ encode : true, + /** + * @cfg {Boolean} encodeDelete False to send only the id to the server on delete, true to encode it in an object + * literal, eg:- +});Defaults to false + */ + encodeDelete: false, + + constructor : function(config){ + Ext.data.JsonWriter.superclass.constructor.call(this, config); + }, /** * Final action of a write event. Apply the written data-object to params. - * @param {String} action [Ext.data.Api.actions.create|read|update|destroy] - * @param {Record[]} rs - * @param {Object} http params - * @param {Object} data object populated according to DataReader meta-data "root" and "idProperty" + * @param {Object} http params-object to write-to. + * @param {Object} baseParams as defined by {@link Ext.data.Store#baseParams}. The baseParms must be encoded by the extending class, eg: {@link Ext.data.JsonWriter}, {@link Ext.data.XmlWriter}. + * @param {Object/Object[]} data Data-object representing compiled Store-recordset. */ - render : function(action, rs, params, data) { - Ext.apply(params, data); - - if (this.encode === true) { // <-- @deprecated returnJson - if (Ext.isArray(rs) && data[this.meta.idProperty]) { - params[this.meta.idProperty] = Ext.encode(params[this.meta.idProperty]); - } - params[this.meta.root] = Ext.encode(params[this.meta.root]); + render : function(params, baseParams, data) { + if (this.encode === true) { + // Encode here now. + Ext.apply(params, baseParams); + params[this.meta.root] = Ext.encode(data); + } else { + // defer encoding for some other layer, probably in {@link Ext.Ajax#request}. Place everything into "jsonData" key. + var jdata = Ext.apply({}, baseParams); + jdata[this.meta.root] = data; + params.jsonData = jdata; } }, /** - * createRecord + * Implements abstract Ext.data.DataWriter#createRecord * @protected * @param {Ext.data.Record} rec + * @return {Object} */ createRecord : function(rec) { - var data = this.toHash(rec); - delete data[this.meta.idProperty]; - return data; + return this.toHash(rec); }, /** - * updateRecord + * Implements abstract Ext.data.DataWriter#updateRecord * @protected * @param {Ext.data.Record} rec + * @return {Object} */ updateRecord : function(rec) { return this.toHash(rec); }, /** - * destroyRecord + * Implements abstract Ext.data.DataWriter#destroyRecord * @protected * @param {Ext.data.Record} rec + * @return {Object} */ - destroyRecord : function(rec) { - return rec.id; + destroyRecord : function(rec){ + if(this.encodeDelete){ + var data = {}; + data[this.meta.idProperty] = rec.id; + return data; + }else{ + return rec.id; + } } -});+{id: 1} + *