Upgrade to ExtJS 3.1.1 - Released 02/08/2010
[extjs.git] / docs / source / JsonWriter.html
1 <html>\r
2 <head>\r
3   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    \r
4   <title>The source code</title>\r
5     <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />\r
6     <script type="text/javascript" src="../resources/prettify/prettify.js"></script>\r
7 </head>\r
8 <body  onload="prettyPrint();">\r
9     <pre class="prettyprint lang-js"><div id="cls-Ext.data.JsonWriter"></div>/**
10  * @class Ext.data.JsonWriter
11  * @extends Ext.data.DataWriter
12  * DataWriter extension for writing an array or single {@link Ext.data.Record} object(s) in preparation for executing a remote CRUD action.
13  */
14 Ext.data.JsonWriter = Ext.extend(Ext.data.DataWriter, {
15     <div id="cfg-Ext.data.JsonWriter-encode"></div>/**
16      * @cfg {Boolean} encode <tt>true</tt> to {@link Ext.util.JSON#encode encode} the
17      * {@link Ext.data.DataWriter#toHash hashed data}. Defaults to <tt>true</tt>.  When using
18      * {@link Ext.data.DirectProxy}, set this to <tt>false</tt> since Ext.Direct.JsonProvider will perform
19      * its own json-encoding.  In addition, if you're using {@link Ext.data.HttpProxy}, setting to <tt>false</tt>
20      * will cause HttpProxy to transmit data using the <b>jsonData</b> configuration-params of {@link Ext.Ajax#request}
21      * instead of <b>params</b>.  When using a {@link Ext.data.Store#restful} Store, some serverside frameworks are
22      * tuned to expect data through the jsonData mechanism.  In those cases, one will want to set <b>encode: <tt>false</tt></b>, as in
23      * let the lower-level connection object (eg: Ext.Ajax) do the encoding.
24      */
25     encode : true,
26     <div id="cfg-Ext.data.JsonWriter-encodeDelete"></div>/**
27      * @cfg {Boolean} encodeDelete False to send only the id to the server on delete, true to encode it in an object
28      * literal, eg: <pre><code>
29 {id: 1}
30  * </code></pre> Defaults to <tt>false</tt>
31      */
32     encodeDelete: false,
33     
34     constructor : function(config){
35         Ext.data.JsonWriter.superclass.constructor.call(this, config);    
36     },
37
38     <div id="method-Ext.data.JsonWriter-render"></div>/**
39      * Final action of a write event.  Apply the written data-object to params.
40      * @param {Object} http params-object to write-to.
41      * @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}.
42      * @param {Object/Object[]} data Data-object representing compiled Store-recordset.
43      */
44     render : function(params, baseParams, data) {
45         if (this.encode === true) {
46             // Encode here now.
47             Ext.apply(params, baseParams);
48             params[this.meta.root] = Ext.encode(data);
49         } else {
50             // defer encoding for some other layer, probably in {@link Ext.Ajax#request}.  Place everything into "jsonData" key.
51             var jdata = Ext.apply({}, baseParams);
52             jdata[this.meta.root] = data;
53             params.jsonData = jdata;
54         }
55     },
56     <div id="method-Ext.data.JsonWriter-createRecord"></div>/**
57      * Implements abstract Ext.data.DataWriter#createRecord
58      * @protected
59      * @param {Ext.data.Record} rec
60      * @return {Object}
61      */
62     createRecord : function(rec) {
63        return this.toHash(rec);
64     },
65     <div id="method-Ext.data.JsonWriter-updateRecord"></div>/**
66      * Implements abstract Ext.data.DataWriter#updateRecord
67      * @protected
68      * @param {Ext.data.Record} rec
69      * @return {Object}
70      */
71     updateRecord : function(rec) {
72         return this.toHash(rec);
73
74     },
75     <div id="method-Ext.data.JsonWriter-destroyRecord"></div>/**
76      * Implements abstract Ext.data.DataWriter#destroyRecord
77      * @protected
78      * @param {Ext.data.Record} rec
79      * @return {Object}
80      */
81     destroyRecord : function(rec){
82         if(this.encodeDelete){
83             var data = {};
84             data[this.meta.idProperty] = rec.id;
85             return data;
86         }else{
87             return rec.id;
88         }
89     }
90 });</pre>    \r
91 </body>\r
92 </html>