Upgrade to ExtJS 3.2.0 - Released 03/30/2010
[extjs.git] / docs / source / Connection.html
index 9c91d3b..fea6193 100644 (file)
-<html>\r
-<head>\r
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    \r
-  <title>The source code</title>\r
-    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />\r
-    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>\r
-</head>\r
-<body  onload="prettyPrint();">\r
-    <pre class="prettyprint lang-js">(function(){\r
-    var BEFOREREQUEST = "beforerequest",\r
-        REQUESTCOMPLETE = "requestcomplete",\r
-        REQUESTEXCEPTION = "requestexception",\r
-        UNDEFINED = undefined,\r
-        LOAD = 'load',\r
-        POST = 'POST',\r
-        GET = 'GET',\r
-        WINDOW = window;\r
-\r
-    <div id="cls-Ext.data.Connection"></div>/**\r
-     * @class Ext.data.Connection\r
-     * @extends Ext.util.Observable\r
-     * <p>The class encapsulates a connection to the page's originating domain, allowing requests to be made\r
-     * either to a configured URL, or to a URL specified at request time.</p>\r
-     * <p>Requests made by this class are asynchronous, and will return immediately. No data from\r
-     * the server will be available to the statement immediately following the {@link #request} call.\r
-     * To process returned data, use a\r
-     * <a href="#request-option-success" ext:member="request-option-success" ext:cls="Ext.data.Connection">success callback</a>\r
-     * in the request options object,\r
-     * or an {@link #requestcomplete event listener}.</p>\r
-     * <p><h3>File Uploads</h3><a href="#request-option-isUpload" ext:member="request-option-isUpload" ext:cls="Ext.data.Connection">File uploads</a> are not performed using normal "Ajax" techniques, that\r
-     * is they are <b>not</b> performed using XMLHttpRequests. Instead the form is submitted in the standard\r
-     * manner with the DOM <tt>&lt;form></tt> element temporarily modified to have its\r
-     * <a href="http://www.w3.org/TR/REC-html40/present/frames.html#adef-target">target</a> set to refer\r
-     * to a dynamically generated, hidden <tt>&lt;iframe></tt> which is inserted into the document\r
-     * but removed after the return data has been gathered.</p>\r
-     * <p>The server response is parsed by the browser to create the document for the IFRAME. If the\r
-     * server is using JSON to send the return object, then the\r
-     * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17">Content-Type</a> header\r
-     * must be set to "text/html" in order to tell the browser to insert the text unchanged into the document body.</p>\r
-     * <p>Characters which are significant to an HTML parser must be sent as HTML entities, so encode\r
-     * "&lt;" as "&amp;lt;", "&amp;" as "&amp;amp;" etc.</p>\r
-     * <p>The response text is retrieved from the document, and a fake XMLHttpRequest object\r
-     * is created containing a <tt>responseText</tt> property in order to conform to the\r
-     * requirements of event handlers and callbacks.</p>\r
-     * <p>Be aware that file upload packets are sent with the content type <a href="http://www.faqs.org/rfcs/rfc2388.html">multipart/form</a>\r
-     * and some server technologies (notably JEE) may require some custom processing in order to\r
-     * retrieve parameter names and parameter values from the packet content.</p>\r
-     * @constructor\r
-     * @param {Object} config a configuration object.\r
-     */\r
-    Ext.data.Connection = function(config){\r
-        Ext.apply(this, config);\r
-        this.addEvents(\r
-            <div id="event-Ext.data.Connection-beforerequest"></div>/**\r
-             * @event beforerequest\r
-             * Fires before a network request is made to retrieve a data object.\r
-             * @param {Connection} conn This Connection object.\r
-             * @param {Object} options The options config object passed to the {@link #request} method.\r
-             */\r
-            BEFOREREQUEST,\r
-            <div id="event-Ext.data.Connection-requestcomplete"></div>/**\r
-             * @event requestcomplete\r
-             * Fires if the request was successfully completed.\r
-             * @param {Connection} conn This Connection object.\r
-             * @param {Object} response The XHR object containing the response data.\r
-             * See <a href="http://www.w3.org/TR/XMLHttpRequest/">The XMLHttpRequest Object</a>\r
-             * for details.\r
-             * @param {Object} options The options config object passed to the {@link #request} method.\r
-             */\r
-            REQUESTCOMPLETE,\r
-            <div id="event-Ext.data.Connection-requestexception"></div>/**\r
-             * @event requestexception\r
-             * Fires if an error HTTP status was returned from the server.\r
-             * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html">HTTP Status Code Definitions</a>\r
-             * for details of HTTP status codes.\r
-             * @param {Connection} conn This Connection object.\r
-             * @param {Object} response The XHR object containing the response data.\r
-             * See <a href="http://www.w3.org/TR/XMLHttpRequest/">The XMLHttpRequest Object</a>\r
-             * for details.\r
-             * @param {Object} options The options config object passed to the {@link #request} method.\r
-             */\r
-            REQUESTEXCEPTION\r
-        );\r
-        Ext.data.Connection.superclass.constructor.call(this);\r
-    };\r
-\r
-    Ext.extend(Ext.data.Connection, Ext.util.Observable, {\r
-        <div id="cfg-Ext.data.Connection-url"></div>/**\r
-         * @cfg {String} url (Optional) <p>The default URL to be used for requests to the server. Defaults to undefined.</p>\r
-         * <p>The <code>url</code> config may be a function which <i>returns</i> the URL to use for the Ajax request. The scope\r
-         * (<code><b>this</b></code> reference) of the function is the <code>scope</code> option passed to the {@link #request} method.</p>\r
-         */\r
-        <div id="cfg-Ext.data.Connection-extraParams"></div>/**\r
-         * @cfg {Object} extraParams (Optional) An object containing properties which are used as\r
-         * extra parameters to each request made by this object. (defaults to undefined)\r
-         */\r
-        <div id="cfg-Ext.data.Connection-defaultHeaders"></div>/**\r
-         * @cfg {Object} defaultHeaders (Optional) An object containing request headers which are added\r
-         *  to each request made by this object. (defaults to undefined)\r
-         */\r
-        <div id="cfg-Ext.data.Connection-method"></div>/**\r
-         * @cfg {String} method (Optional) The default HTTP method to be used for requests.\r
-         * (defaults to undefined; if not set, but {@link #request} params are present, POST will be used;\r
-         * otherwise, GET will be used.)\r
-         */\r
-        <div id="cfg-Ext.data.Connection-timeout"></div>/**\r
-         * @cfg {Number} timeout (Optional) The timeout in milliseconds to be used for requests. (defaults to 30000)\r
-         */\r
-        timeout : 30000,\r
-        <div id="cfg-Ext.data.Connection-autoAbort"></div>/**\r
-         * @cfg {Boolean} autoAbort (Optional) Whether this request should abort any pending requests. (defaults to false)\r
-         * @type Boolean\r
-         */\r
-        autoAbort:false,\r
-\r
-        <div id="cfg-Ext.data.Connection-disableCaching"></div>/**\r
-         * @cfg {Boolean} disableCaching (Optional) True to add a unique cache-buster param to GET requests. (defaults to true)\r
-         * @type Boolean\r
-         */\r
-        disableCaching: true,\r
-\r
-        <div id="cfg-Ext.data.Connection-disableCachingParam"></div>/**\r
-         * @cfg {String} disableCachingParam (Optional) Change the parameter which is sent went disabling caching\r
-         * through a cache buster. Defaults to '_dc'\r
-         * @type String\r
-         */\r
-        disableCachingParam: '_dc',\r
-\r
-        <div id="method-Ext.data.Connection-request"></div>/**\r
-         * <p>Sends an HTTP request to a remote server.</p>\r
-         * <p><b>Important:</b> Ajax server requests are asynchronous, and this call will\r
-         * return before the response has been received. Process any returned data\r
-         * in a callback function.</p>\r
-         * <pre><code>\r
-Ext.Ajax.request({\r
-   url: 'ajax_demo/sample.json',\r
-   success: function(response, opts) {\r
-      var obj = Ext.decode(response.responseText);\r
-      console.dir(obj);\r
-   },\r
-   failure: function(response, opts) {\r
-      console.log('server-side failure with status code ' + response.status);\r
-   }\r
-});\r
-         * </code></pre>\r
-         * <p>To execute a callback function in the correct scope, use the <tt>scope</tt> option.</p>\r
-         * @param {Object} options An object which may contain the following properties:<ul>\r
-         * <li><b>url</b> : String/Function (Optional)<div class="sub-desc">The URL to\r
-         * which to send the request, or a function to call which returns a URL string. The scope of the\r
-         * function is specified by the <tt>scope</tt> option. Defaults to the configured\r
-         * <tt>{@link #url}</tt>.</div></li>\r
-         * <li><b>params</b> : Object/String/Function (Optional)<div class="sub-desc">\r
-         * An object containing properties which are used as parameters to the\r
-         * request, a url encoded string or a function to call to get either. The scope of the function\r
-         * is specified by the <tt>scope</tt> option.</div></li>\r
-         * <li><b>method</b> : String (Optional)<div class="sub-desc">The HTTP method to use\r
-         * for the request. Defaults to the configured method, or if no method was configured,\r
-         * "GET" if no parameters are being sent, and "POST" if parameters are being sent.  Note that\r
-         * the method name is case-sensitive and should be all caps.</div></li>\r
-         * <li><b>callback</b> : Function (Optional)<div class="sub-desc">The\r
-         * function to be called upon receipt of the HTTP response. The callback is\r
-         * called regardless of success or failure and is passed the following\r
-         * parameters:<ul>\r
-         * <li><b>options</b> : Object<div class="sub-desc">The parameter to the request call.</div></li>\r
-         * <li><b>success</b> : Boolean<div class="sub-desc">True if the request succeeded.</div></li>\r
-         * <li><b>response</b> : Object<div class="sub-desc">The XMLHttpRequest object containing the response data.\r
-         * See <a href="http://www.w3.org/TR/XMLHttpRequest/">http://www.w3.org/TR/XMLHttpRequest/</a> for details about\r
-         * accessing elements of the response.</div></li>\r
-         * </ul></div></li>\r
-         * <li><a id="request-option-success"></a><b>success</b> : Function (Optional)<div class="sub-desc">The function\r
-         * to be called upon success of the request. The callback is passed the following\r
-         * parameters:<ul>\r
-         * <li><b>response</b> : Object<div class="sub-desc">The XMLHttpRequest object containing the response data.</div></li>\r
-         * <li><b>options</b> : Object<div class="sub-desc">The parameter to the request call.</div></li>\r
-         * </ul></div></li>\r
-         * <li><b>failure</b> : Function (Optional)<div class="sub-desc">The function\r
-         * to be called upon failure of the request. The callback is passed the\r
-         * following parameters:<ul>\r
-         * <li><b>response</b> : Object<div class="sub-desc">The XMLHttpRequest object containing the response data.</div></li>\r
-         * <li><b>options</b> : Object<div class="sub-desc">The parameter to the request call.</div></li>\r
-         * </ul></div></li>\r
-         * <li><b>scope</b> : Object (Optional)<div class="sub-desc">The scope in\r
-         * which to execute the callbacks: The "this" object for the callback function. If the <tt>url</tt>, or <tt>params</tt> options were\r
-         * specified as functions from which to draw values, then this also serves as the scope for those function calls.\r
-         * Defaults to the browser window.</div></li>\r
-         * <li><b>timeout</b> : Number (Optional)<div class="sub-desc">The timeout in milliseconds to be used for this request. Defaults to 30 seconds.</div></li>\r
-         * <li><b>form</b> : Element/HTMLElement/String (Optional)<div class="sub-desc">The <tt>&lt;form&gt;</tt>\r
-         * Element or the id of the <tt>&lt;form&gt;</tt> to pull parameters from.</div></li>\r
-         * <li><a id="request-option-isUpload"></a><b>isUpload</b> : Boolean (Optional)<div class="sub-desc"><b>Only meaningful when used\r
-         * with the <tt>form</tt> option</b>.\r
-         * <p>True if the form object is a file upload (will be set automatically if the form was\r
-         * configured with <b><tt>enctype</tt></b> "multipart/form-data").</p>\r
-         * <p>File uploads are not performed using normal "Ajax" techniques, that is they are <b>not</b>\r
-         * performed using XMLHttpRequests. Instead the form is submitted in the standard manner with the\r
-         * DOM <tt>&lt;form></tt> element temporarily modified to have its\r
-         * <a href="http://www.w3.org/TR/REC-html40/present/frames.html#adef-target">target</a> set to refer\r
-         * to a dynamically generated, hidden <tt>&lt;iframe></tt> which is inserted into the document\r
-         * but removed after the return data has been gathered.</p>\r
-         * <p>The server response is parsed by the browser to create the document for the IFRAME. If the\r
-         * server is using JSON to send the return object, then the\r
-         * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17">Content-Type</a> header\r
-         * must be set to "text/html" in order to tell the browser to insert the text unchanged into the document body.</p>\r
-         * <p>The response text is retrieved from the document, and a fake XMLHttpRequest object\r
-         * is created containing a <tt>responseText</tt> property in order to conform to the\r
-         * requirements of event handlers and callbacks.</p>\r
-         * <p>Be aware that file upload packets are sent with the content type <a href="http://www.faqs.org/rfcs/rfc2388.html">multipart/form</a>\r
-         * and some server technologies (notably JEE) may require some custom processing in order to\r
-         * retrieve parameter names and parameter values from the packet content.</p>\r
-         * </div></li>\r
-         * <li><b>headers</b> : Object (Optional)<div class="sub-desc">Request\r
-         * headers to set for the request.</div></li>\r
-         * <li><b>xmlData</b> : Object (Optional)<div class="sub-desc">XML document\r
-         * to use for the post. Note: This will be used instead of params for the post\r
-         * data. Any params will be appended to the URL.</div></li>\r
-         * <li><b>jsonData</b> : Object/String (Optional)<div class="sub-desc">JSON\r
-         * data to use as the post. Note: This will be used instead of params for the post\r
-         * data. Any params will be appended to the URL.</div></li>\r
-         * <li><b>disableCaching</b> : Boolean (Optional)<div class="sub-desc">True\r
-         * to add a unique cache-buster param to GET requests.</div></li>\r
-         * </ul></p>\r
-         * <p>The options object may also contain any other property which might be needed to perform\r
-         * postprocessing in a callback because it is passed to callback functions.</p>\r
-         * @return {Number} transactionId The id of the server transaction. This may be used\r
-         * to cancel the request.\r
-         */\r
-        request : function(o){\r
-            var me = this;\r
-            if(me.fireEvent(BEFOREREQUEST, me, o)){\r
-                if (o.el) {\r
-                    if(!Ext.isEmpty(o.indicatorText)){\r
-                        me.indicatorText = '<div class="loading-indicator">'+o.indicatorText+"</div>";\r
-                    }\r
-                    if(me.indicatorText) {\r
-                        Ext.getDom(o.el).innerHTML = me.indicatorText;\r
-                    }\r
-                    o.success = (Ext.isFunction(o.success) ? o.success : function(){}).createInterceptor(function(response) {\r
-                        Ext.getDom(o.el).innerHTML = response.responseText;\r
-                    });\r
-                }\r
-\r
-                var p = o.params,\r
-                    url = o.url || me.url,\r
-                    method,\r
-                    cb = {success: me.handleResponse,\r
-                          failure: me.handleFailure,\r
-                          scope: me,\r
-                          argument: {options: o},\r
-                          timeout : o.timeout || me.timeout\r
-                    },\r
-                    form,\r
-                    serForm;\r
-\r
-\r
-                if (Ext.isFunction(p)) {\r
-                    p = p.call(o.scope||WINDOW, o);\r
-                }\r
-\r
-                p = Ext.urlEncode(me.extraParams, Ext.isObject(p) ? Ext.urlEncode(p) : p);\r
-\r
-                if (Ext.isFunction(url)) {\r
-                    url = url.call(o.scope || WINDOW, o);\r
-                }\r
-\r
-                if((form = Ext.getDom(o.form))){\r
-                    url = url || form.action;\r
-                     if(o.isUpload || /multipart\/form-data/i.test(form.getAttribute("enctype"))) {\r
-                         return me.doFormUpload.call(me, o, p, url);\r
-                     }\r
-                    serForm = Ext.lib.Ajax.serializeForm(form);\r
-                    p = p ? (p + '&' + serForm) : serForm;\r
-                }\r
-\r
-                method = o.method || me.method || ((p || o.xmlData || o.jsonData) ? POST : GET);\r
-\r
-                if(method === GET && (me.disableCaching && o.disableCaching !== false) || o.disableCaching === true){\r
-                    var dcp = o.disableCachingParam || me.disableCachingParam;\r
-                    url = Ext.urlAppend(url, dcp + '=' + (new Date().getTime()));\r
-                }\r
-\r
-                o.headers = Ext.apply(o.headers || {}, me.defaultHeaders || {});\r
-\r
-                if(o.autoAbort === true || me.autoAbort) {\r
-                    me.abort();\r
-                }\r
-\r
-                if((method == GET || o.xmlData || o.jsonData) && p){\r
-                    url = Ext.urlAppend(url, p);\r
-                    p = '';\r
-                }\r
-                return (me.transId = Ext.lib.Ajax.request(method, url, cb, p, o));\r
-            }else{\r
-                return o.callback ? o.callback.apply(o.scope, [o,UNDEFINED,UNDEFINED]) : null;\r
-            }\r
-        },\r
-\r
-        <div id="method-Ext.data.Connection-isLoading"></div>/**\r
-         * Determine whether this object has a request outstanding.\r
-         * @param {Number} transactionId (Optional) defaults to the last transaction\r
-         * @return {Boolean} True if there is an outstanding request.\r
-         */\r
-        isLoading : function(transId){\r
-            return transId ? Ext.lib.Ajax.isCallInProgress(transId) : !! this.transId;\r
-        },\r
-\r
-        <div id="method-Ext.data.Connection-abort"></div>/**\r
-         * Aborts any outstanding request.\r
-         * @param {Number} transactionId (Optional) defaults to the last transaction\r
-         */\r
-        abort : function(transId){\r
-            if(transId || this.isLoading()){\r
-                Ext.lib.Ajax.abort(transId || this.transId);\r
-            }\r
-        },\r
-\r
-        // private\r
-        handleResponse : function(response){\r
-            this.transId = false;\r
-            var options = response.argument.options;\r
-            response.argument = options ? options.argument : null;\r
-            this.fireEvent(REQUESTCOMPLETE, this, response, options);\r
-            if(options.success){\r
-                options.success.call(options.scope, response, options);\r
-            }\r
-            if(options.callback){\r
-                options.callback.call(options.scope, options, true, response);\r
-            }\r
-        },\r
-\r
-        // private\r
-        handleFailure : function(response, e){\r
-            this.transId = false;\r
-            var options = response.argument.options;\r
-            response.argument = options ? options.argument : null;\r
-            this.fireEvent(REQUESTEXCEPTION, this, response, options, e);\r
-            if(options.failure){\r
-                options.failure.call(options.scope, response, options);\r
-            }\r
-            if(options.callback){\r
-                options.callback.call(options.scope, options, false, response);\r
-            }\r
-        },\r
-\r
-        // private\r
-        doFormUpload : function(o, ps, url){\r
-            var id = Ext.id(),\r
-                doc = document,\r
-                frame = doc.createElement('iframe'),\r
-                form = Ext.getDom(o.form),\r
-                hiddens = [],\r
-                hd,\r
-                encoding = 'multipart/form-data',\r
-                buf = {\r
-                    target: form.target,\r
-                    method: form.method,\r
-                    encoding: form.encoding,\r
-                    enctype: form.enctype,\r
-                    action: form.action\r
-                };\r
-\r
-            Ext.fly(frame).set({\r
-                id: id,\r
-                name: id,\r
-                cls: 'x-hidden'\r
-\r
-            });\r
-\r
-            doc.body.appendChild(frame);\r
-\r
-            //Reset the Frame to neutral domain\r
-            Ext.fly(frame).set({\r
-               src : Ext.SSL_SECURE_URL\r
-            });\r
-\r
-            // This is required so that IE doesn't pop the response up in a new window.\r
-            if(Ext.isIE){\r
-               document.frames[id].name = id;\r
-            }\r
-\r
-\r
-            Ext.fly(form).set({\r
-                target: id,\r
-                method: POST,\r
-                enctype: encoding,\r
-                encoding: encoding,\r
-                action: url || buf.action\r
-            });\r
-\r
-            // add dynamic params\r
-            Ext.iterate(Ext.urlDecode(ps, false), function(k, v){\r
-                hd = doc.createElement('input');\r
-                Ext.fly(hd).set({\r
-                    type: 'hidden',\r
-                    value: v,\r
-                    name: k\r
-                });\r
-                form.appendChild(hd);\r
-                hiddens.push(hd);\r
-            });\r
-\r
-            function cb(){\r
-                var me = this,\r
-                    // bogus response object\r
-                    r = {responseText : '',\r
-                         responseXML : null,\r
-                         argument : o.argument},\r
-                    doc,\r
-                    firstChild;\r
-\r
-                try{\r
-                    doc = frame.contentWindow.document || frame.contentDocument || WINDOW.frames[id].document;\r
-                    if(doc){\r
-                        if(doc.body){\r
-                            if(/textarea/i.test((firstChild = doc.body.firstChild || {}).tagName)){ // json response wrapped in textarea\r
-                                r.responseText = firstChild.value;\r
-                            }else{\r
-                                r.responseText = doc.body.innerHTML;\r
-                            }\r
-                        }\r
-                        //in IE the document may still have a body even if returns XML.\r
-                        r.responseXML = doc.XMLDocument || doc;\r
-                    }\r
-                }\r
-                catch(e) {}\r
-\r
-                Ext.EventManager.removeListener(frame, LOAD, cb, me);\r
-\r
-                me.fireEvent(REQUESTCOMPLETE, me, r, o);\r
-\r
-                function runCallback(fn, scope, args){\r
-                    if(Ext.isFunction(fn)){\r
-                        fn.apply(scope, args);\r
-                    }\r
-                }\r
-\r
-                runCallback(o.success, o.scope, [r, o]);\r
-                runCallback(o.callback, o.scope, [o, true, r]);\r
-\r
-                if(!me.debugUploads){\r
-                    setTimeout(function(){Ext.removeNode(frame);}, 100);\r
-                }\r
-            }\r
-\r
-            Ext.EventManager.on(frame, LOAD, cb, this);\r
-            form.submit();\r
-\r
-            Ext.fly(form).set(buf);\r
-            Ext.each(hiddens, function(h) {\r
-                Ext.removeNode(h);\r
-            });\r
-        }\r
-    });\r
-})();\r
-\r
-<div id="cls-Ext.Ajax"></div>/**\r
- * @class Ext.Ajax\r
- * @extends Ext.data.Connection\r
- * <p>The global Ajax request class that provides a simple way to make Ajax requests\r
- * with maximum flexibility.</p>\r
- * <p>Since Ext.Ajax is a singleton, you can set common properties/events for it once\r
- * and override them at the request function level only if necessary.</p>\r
- * <p>Common <b>Properties</b> you may want to set are:<div class="mdetail-params"><ul>\r
- * <li><b><tt>{@link #method}</tt></b><p class="sub-desc"></p></li>\r
- * <li><b><tt>{@link #extraParams}</tt></b><p class="sub-desc"></p></li>\r
- * <li><b><tt>{@link #url}</tt></b><p class="sub-desc"></p></li>\r
- * </ul></div>\r
- * <pre><code>\r
-// Default headers to pass in every request\r
-Ext.Ajax.defaultHeaders = {\r
-    'Powered-By': 'Ext'\r
-};\r
- * </code></pre>\r
- * </p>\r
- * <p>Common <b>Events</b> you may want to set are:<div class="mdetail-params"><ul>\r
- * <li><b><tt>{@link Ext.data.Connection#beforerequest beforerequest}</tt></b><p class="sub-desc"></p></li>\r
- * <li><b><tt>{@link Ext.data.Connection#requestcomplete requestcomplete}</tt></b><p class="sub-desc"></p></li>\r
- * <li><b><tt>{@link Ext.data.Connection#requestexception requestexception}</tt></b><p class="sub-desc"></p></li>\r
- * </ul></div>\r
- * <pre><code>\r
-// Example: show a spinner during all Ajax requests\r
-Ext.Ajax.on('beforerequest', this.showSpinner, this);\r
-Ext.Ajax.on('requestcomplete', this.hideSpinner, this);\r
-Ext.Ajax.on('requestexception', this.hideSpinner, this);\r
- * </code></pre>\r
- * </p>\r
- * <p>An example request:</p>\r
- * <pre><code>\r
-// Basic request\r
-Ext.Ajax.{@link Ext.data.Connection#request request}({\r
-   url: 'foo.php',\r
-   success: someFn,\r
-   failure: otherFn,\r
-   headers: {\r
-       'my-header': 'foo'\r
-   },\r
-   params: { foo: 'bar' }\r
-});\r
-\r
-// Simple ajax form submission\r
-Ext.Ajax.{@link Ext.data.Connection#request request}({\r
-    form: 'some-form',\r
-    params: 'foo=bar'\r
-});\r
- * </code></pre>\r
- * </p>\r
- * @singleton\r
- */\r
-Ext.Ajax = new Ext.data.Connection({\r
-    <div id="cfg-Ext.Ajax-url"></div>/**\r
-     * @cfg {String} url @hide\r
-     */\r
-    <div id="cfg-Ext.Ajax-extraParams"></div>/**\r
-     * @cfg {Object} extraParams @hide\r
-     */\r
-    <div id="cfg-Ext.Ajax-defaultHeaders"></div>/**\r
-     * @cfg {Object} defaultHeaders @hide\r
-     */\r
-    <div id="cfg-Ext.Ajax-method"></div>/**\r
-     * @cfg {String} method (Optional) @hide\r
-     */\r
-    <div id="cfg-Ext.Ajax-timeout"></div>/**\r
-     * @cfg {Number} timeout (Optional) @hide\r
-     */\r
-    <div id="cfg-Ext.Ajax-autoAbort"></div>/**\r
-     * @cfg {Boolean} autoAbort (Optional) @hide\r
-     */\r
-\r
-    <div id="cfg-Ext.Ajax-disableCaching"></div>/**\r
-     * @cfg {Boolean} disableCaching (Optional) @hide\r
-     */\r
-\r
-    <div id="prop-Ext.Ajax-disableCaching"></div>/**\r
-     * @property  disableCaching\r
-     * True to add a unique cache-buster param to GET requests. (defaults to true)\r
-     * @type Boolean\r
-     */\r
-    <div id="prop-Ext.Ajax-url"></div>/**\r
-     * @property  url\r
-     * The default URL to be used for requests to the server. (defaults to undefined)\r
-     * If the server receives all requests through one URL, setting this once is easier than\r
-     * entering it on every request.\r
-     * @type String\r
-     */\r
-    <div id="prop-Ext.Ajax-extraParams"></div>/**\r
-     * @property  extraParams\r
-     * An object containing properties which are used as extra parameters to each request made\r
-     * by this object (defaults to undefined). Session information and other data that you need\r
-     * to pass with each request are commonly put here.\r
-     * @type Object\r
-     */\r
-    <div id="prop-Ext.Ajax-defaultHeaders"></div>/**\r
-     * @property  defaultHeaders\r
-     * An object containing request headers which are added to each request made by this object\r
-     * (defaults to undefined).\r
-     * @type Object\r
-     */\r
-    <div id="prop-Ext.Ajax-method"></div>/**\r
-     * @property  method\r
-     * The default HTTP method to be used for requests. Note that this is case-sensitive and\r
-     * should be all caps (defaults to undefined; if not set but params are present will use\r
-     * <tt>"POST"</tt>, otherwise will use <tt>"GET"</tt>.)\r
-     * @type String\r
-     */\r
-    <div id="prop-Ext.Ajax-timeout"></div>/**\r
-     * @property  timeout\r
-     * The timeout in milliseconds to be used for requests. (defaults to 30000)\r
-     * @type Number\r
-     */\r
-\r
-    <div id="prop-Ext.Ajax-autoAbort"></div>/**\r
-     * @property  autoAbort\r
-     * Whether a new request should abort any pending requests. (defaults to false)\r
-     * @type Boolean\r
-     */\r
-    autoAbort : false,\r
-\r
-    <div id="method-Ext.Ajax-serializeForm"></div>/**\r
-     * Serialize the passed form into a url encoded string\r
-     * @param {String/HTMLElement} form\r
-     * @return {String}\r
-     */\r
-    serializeForm : function(form){\r
-        return Ext.lib.Ajax.serializeForm(form);\r
-    }\r
-});\r
-</pre>    \r
-</body>\r
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    
+  <title>The source code</title>
+    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
+    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+</head>
+<body  onload="prettyPrint();">
+    <pre class="prettyprint lang-js">/*!
+ * Ext JS Library 3.2.0
+ * Copyright(c) 2006-2010 Ext JS, Inc.
+ * licensing@extjs.com
+ * http://www.extjs.com/license
+ */
+(function(){
+    var BEFOREREQUEST = "beforerequest",
+        REQUESTCOMPLETE = "requestcomplete",
+        REQUESTEXCEPTION = "requestexception",
+        UNDEFINED = undefined,
+        LOAD = 'load',
+        POST = 'POST',
+        GET = 'GET',
+        WINDOW = window;
+
+    <div id="cls-Ext.data.Connection"></div>/**
+     * @class Ext.data.Connection
+     * @extends Ext.util.Observable
+     * <p>The class encapsulates a connection to the page's originating domain, allowing requests to be made
+     * either to a configured URL, or to a URL specified at request time.</p>
+     * <p>Requests made by this class are asynchronous, and will return immediately. No data from
+     * the server will be available to the statement immediately following the {@link #request} call.
+     * To process returned data, use a
+     * <a href="#request-option-success" ext:member="request-option-success" ext:cls="Ext.data.Connection">success callback</a>
+     * in the request options object,
+     * or an {@link #requestcomplete event listener}.</p>
+     * <p><h3>File Uploads</h3><a href="#request-option-isUpload" ext:member="request-option-isUpload" ext:cls="Ext.data.Connection">File uploads</a> are not performed using normal "Ajax" techniques, that
+     * is they are <b>not</b> performed using XMLHttpRequests. Instead the form is submitted in the standard
+     * manner with the DOM <tt>&lt;form></tt> element temporarily modified to have its
+     * <a href="http://www.w3.org/TR/REC-html40/present/frames.html#adef-target">target</a> set to refer
+     * to a dynamically generated, hidden <tt>&lt;iframe></tt> which is inserted into the document
+     * but removed after the return data has been gathered.</p>
+     * <p>The server response is parsed by the browser to create the document for the IFRAME. If the
+     * server is using JSON to send the return object, then the
+     * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17">Content-Type</a> header
+     * must be set to "text/html" in order to tell the browser to insert the text unchanged into the document body.</p>
+     * <p>Characters which are significant to an HTML parser must be sent as HTML entities, so encode
+     * "&lt;" as "&amp;lt;", "&amp;" as "&amp;amp;" etc.</p>
+     * <p>The response text is retrieved from the document, and a fake XMLHttpRequest object
+     * is created containing a <tt>responseText</tt> property in order to conform to the
+     * requirements of event handlers and callbacks.</p>
+     * <p>Be aware that file upload packets are sent with the content type <a href="http://www.faqs.org/rfcs/rfc2388.html">multipart/form</a>
+     * and some server technologies (notably JEE) may require some custom processing in order to
+     * retrieve parameter names and parameter values from the packet content.</p>
+     * @constructor
+     * @param {Object} config a configuration object.
+     */
+    Ext.data.Connection = function(config){
+        Ext.apply(this, config);
+        this.addEvents(
+            <div id="event-Ext.data.Connection-beforerequest"></div>/**
+             * @event beforerequest
+             * Fires before a network request is made to retrieve a data object.
+             * @param {Connection} conn This Connection object.
+             * @param {Object} options The options config object passed to the {@link #request} method.
+             */
+            BEFOREREQUEST,
+            <div id="event-Ext.data.Connection-requestcomplete"></div>/**
+             * @event requestcomplete
+             * Fires if the request was successfully completed.
+             * @param {Connection} conn This Connection object.
+             * @param {Object} response The XHR object containing the response data.
+             * See <a href="http://www.w3.org/TR/XMLHttpRequest/">The XMLHttpRequest Object</a>
+             * for details.
+             * @param {Object} options The options config object passed to the {@link #request} method.
+             */
+            REQUESTCOMPLETE,
+            <div id="event-Ext.data.Connection-requestexception"></div>/**
+             * @event requestexception
+             * Fires if an error HTTP status was returned from the server.
+             * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html">HTTP Status Code Definitions</a>
+             * for details of HTTP status codes.
+             * @param {Connection} conn This Connection object.
+             * @param {Object} response The XHR object containing the response data.
+             * See <a href="http://www.w3.org/TR/XMLHttpRequest/">The XMLHttpRequest Object</a>
+             * for details.
+             * @param {Object} options The options config object passed to the {@link #request} method.
+             */
+            REQUESTEXCEPTION
+        );
+        Ext.data.Connection.superclass.constructor.call(this);
+    };
+
+    Ext.extend(Ext.data.Connection, Ext.util.Observable, {
+        <div id="cfg-Ext.data.Connection-url"></div>/**
+         * @cfg {String} url (Optional) <p>The default URL to be used for requests to the server. Defaults to undefined.</p>
+         * <p>The <code>url</code> config may be a function which <i>returns</i> the URL to use for the Ajax request. The scope
+         * (<code><b>this</b></code> reference) of the function is the <code>scope</code> option passed to the {@link #request} method.</p>
+         */
+        <div id="cfg-Ext.data.Connection-extraParams"></div>/**
+         * @cfg {Object} extraParams (Optional) An object containing properties which are used as
+         * extra parameters to each request made by this object. (defaults to undefined)
+         */
+        <div id="cfg-Ext.data.Connection-defaultHeaders"></div>/**
+         * @cfg {Object} defaultHeaders (Optional) An object containing request headers which are added
+         *  to each request made by this object. (defaults to undefined)
+         */
+        <div id="cfg-Ext.data.Connection-method"></div>/**
+         * @cfg {String} method (Optional) The default HTTP method to be used for requests.
+         * (defaults to undefined; if not set, but {@link #request} params are present, POST will be used;
+         * otherwise, GET will be used.)
+         */
+        <div id="cfg-Ext.data.Connection-timeout"></div>/**
+         * @cfg {Number} timeout (Optional) The timeout in milliseconds to be used for requests. (defaults to 30000)
+         */
+        timeout : 30000,
+        <div id="cfg-Ext.data.Connection-autoAbort"></div>/**
+         * @cfg {Boolean} autoAbort (Optional) Whether this request should abort any pending requests. (defaults to false)
+         * @type Boolean
+         */
+        autoAbort:false,
+
+        <div id="cfg-Ext.data.Connection-disableCaching"></div>/**
+         * @cfg {Boolean} disableCaching (Optional) True to add a unique cache-buster param to GET requests. (defaults to true)
+         * @type Boolean
+         */
+        disableCaching: true,
+
+        <div id="cfg-Ext.data.Connection-disableCachingParam"></div>/**
+         * @cfg {String} disableCachingParam (Optional) Change the parameter which is sent went disabling caching
+         * through a cache buster. Defaults to '_dc'
+         * @type String
+         */
+        disableCachingParam: '_dc',
+
+        <div id="method-Ext.data.Connection-request"></div>/**
+         * <p>Sends an HTTP request to a remote server.</p>
+         * <p><b>Important:</b> Ajax server requests are asynchronous, and this call will
+         * return before the response has been received. Process any returned data
+         * in a callback function.</p>
+         * <pre><code>
+Ext.Ajax.request({
+   url: 'ajax_demo/sample.json',
+   success: function(response, opts) {
+      var obj = Ext.decode(response.responseText);
+      console.dir(obj);
+   },
+   failure: function(response, opts) {
+      console.log('server-side failure with status code ' + response.status);
+   }
+});
+         * </code></pre>
+         * <p>To execute a callback function in the correct scope, use the <tt>scope</tt> option.</p>
+         * @param {Object} options An object which may contain the following properties:<ul>
+         * <li><b>url</b> : String/Function (Optional)<div class="sub-desc">The URL to
+         * which to send the request, or a function to call which returns a URL string. The scope of the
+         * function is specified by the <tt>scope</tt> option. Defaults to the configured
+         * <tt>{@link #url}</tt>.</div></li>
+         * <li><b>params</b> : Object/String/Function (Optional)<div class="sub-desc">
+         * An object containing properties which are used as parameters to the
+         * request, a url encoded string or a function to call to get either. The scope of the function
+         * is specified by the <tt>scope</tt> option.</div></li>
+         * <li><b>method</b> : String (Optional)<div class="sub-desc">The HTTP method to use
+         * for the request. Defaults to the configured method, or if no method was configured,
+         * "GET" if no parameters are being sent, and "POST" if parameters are being sent.  Note that
+         * the method name is case-sensitive and should be all caps.</div></li>
+         * <li><b>callback</b> : Function (Optional)<div class="sub-desc">The
+         * function to be called upon receipt of the HTTP response. The callback is
+         * called regardless of success or failure and is passed the following
+         * parameters:<ul>
+         * <li><b>options</b> : Object<div class="sub-desc">The parameter to the request call.</div></li>
+         * <li><b>success</b> : Boolean<div class="sub-desc">True if the request succeeded.</div></li>
+         * <li><b>response</b> : Object<div class="sub-desc">The XMLHttpRequest object containing the response data.
+         * See <a href="http://www.w3.org/TR/XMLHttpRequest/">http://www.w3.org/TR/XMLHttpRequest/</a> for details about
+         * accessing elements of the response.</div></li>
+         * </ul></div></li>
+         * <li><a id="request-option-success"></a><b>success</b> : Function (Optional)<div class="sub-desc">The function
+         * to be called upon success of the request. The callback is passed the following
+         * parameters:<ul>
+         * <li><b>response</b> : Object<div class="sub-desc">The XMLHttpRequest object containing the response data.</div></li>
+         * <li><b>options</b> : Object<div class="sub-desc">The parameter to the request call.</div></li>
+         * </ul></div></li>
+         * <li><b>failure</b> : Function (Optional)<div class="sub-desc">The function
+         * to be called upon failure of the request. The callback is passed the
+         * following parameters:<ul>
+         * <li><b>response</b> : Object<div class="sub-desc">The XMLHttpRequest object containing the response data.</div></li>
+         * <li><b>options</b> : Object<div class="sub-desc">The parameter to the request call.</div></li>
+         * </ul></div></li>
+         * <li><b>scope</b> : Object (Optional)<div class="sub-desc">The scope in
+         * which to execute the callbacks: The "this" object for the callback function. If the <tt>url</tt>, or <tt>params</tt> options were
+         * specified as functions from which to draw values, then this also serves as the scope for those function calls.
+         * Defaults to the browser window.</div></li>
+         * <li><b>timeout</b> : Number (Optional)<div class="sub-desc">The timeout in milliseconds to be used for this request. Defaults to 30 seconds.</div></li>
+         * <li><b>form</b> : Element/HTMLElement/String (Optional)<div class="sub-desc">The <tt>&lt;form&gt;</tt>
+         * Element or the id of the <tt>&lt;form&gt;</tt> to pull parameters from.</div></li>
+         * <li><a id="request-option-isUpload"></a><b>isUpload</b> : Boolean (Optional)<div class="sub-desc"><b>Only meaningful when used
+         * with the <tt>form</tt> option</b>.
+         * <p>True if the form object is a file upload (will be set automatically if the form was
+         * configured with <b><tt>enctype</tt></b> "multipart/form-data").</p>
+         * <p>File uploads are not performed using normal "Ajax" techniques, that is they are <b>not</b>
+         * performed using XMLHttpRequests. Instead the form is submitted in the standard manner with the
+         * DOM <tt>&lt;form></tt> element temporarily modified to have its
+         * <a href="http://www.w3.org/TR/REC-html40/present/frames.html#adef-target">target</a> set to refer
+         * to a dynamically generated, hidden <tt>&lt;iframe></tt> which is inserted into the document
+         * but removed after the return data has been gathered.</p>
+         * <p>The server response is parsed by the browser to create the document for the IFRAME. If the
+         * server is using JSON to send the return object, then the
+         * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17">Content-Type</a> header
+         * must be set to "text/html" in order to tell the browser to insert the text unchanged into the document body.</p>
+         * <p>The response text is retrieved from the document, and a fake XMLHttpRequest object
+         * is created containing a <tt>responseText</tt> property in order to conform to the
+         * requirements of event handlers and callbacks.</p>
+         * <p>Be aware that file upload packets are sent with the content type <a href="http://www.faqs.org/rfcs/rfc2388.html">multipart/form</a>
+         * and some server technologies (notably JEE) may require some custom processing in order to
+         * retrieve parameter names and parameter values from the packet content.</p>
+         * </div></li>
+         * <li><b>headers</b> : Object (Optional)<div class="sub-desc">Request
+         * headers to set for the request.</div></li>
+         * <li><b>xmlData</b> : Object (Optional)<div class="sub-desc">XML document
+         * to use for the post. Note: This will be used instead of params for the post
+         * data. Any params will be appended to the URL.</div></li>
+         * <li><b>jsonData</b> : Object/String (Optional)<div class="sub-desc">JSON
+         * data to use as the post. Note: This will be used instead of params for the post
+         * data. Any params will be appended to the URL.</div></li>
+         * <li><b>disableCaching</b> : Boolean (Optional)<div class="sub-desc">True
+         * to add a unique cache-buster param to GET requests.</div></li>
+         * </ul></p>
+         * <p>The options object may also contain any other property which might be needed to perform
+         * postprocessing in a callback because it is passed to callback functions.</p>
+         * @return {Number} transactionId The id of the server transaction. This may be used
+         * to cancel the request.
+         */
+        request : function(o){
+            var me = this;
+            if(me.fireEvent(BEFOREREQUEST, me, o)){
+                if (o.el) {
+                    if(!Ext.isEmpty(o.indicatorText)){
+                        me.indicatorText = '<div class="loading-indicator">'+o.indicatorText+"</div>";
+                    }
+                    if(me.indicatorText) {
+                        Ext.getDom(o.el).innerHTML = me.indicatorText;
+                    }
+                    o.success = (Ext.isFunction(o.success) ? o.success : function(){}).createInterceptor(function(response) {
+                        Ext.getDom(o.el).innerHTML = response.responseText;
+                    });
+                }
+
+                var p = o.params,
+                    url = o.url || me.url,
+                    method,
+                    cb = {success: me.handleResponse,
+                          failure: me.handleFailure,
+                          scope: me,
+                          argument: {options: o},
+                          timeout : o.timeout || me.timeout
+                    },
+                    form,
+                    serForm;
+
+
+                if (Ext.isFunction(p)) {
+                    p = p.call(o.scope||WINDOW, o);
+                }
+
+                p = Ext.urlEncode(me.extraParams, Ext.isObject(p) ? Ext.urlEncode(p) : p);
+
+                if (Ext.isFunction(url)) {
+                    url = url.call(o.scope || WINDOW, o);
+                }
+
+                if((form = Ext.getDom(o.form))){
+                    url = url || form.action;
+                     if(o.isUpload || /multipart\/form-data/i.test(form.getAttribute("enctype"))) {
+                         return me.doFormUpload.call(me, o, p, url);
+                     }
+                    serForm = Ext.lib.Ajax.serializeForm(form);
+                    p = p ? (p + '&' + serForm) : serForm;
+                }
+
+                method = o.method || me.method || ((p || o.xmlData || o.jsonData) ? POST : GET);
+
+                if(method === GET && (me.disableCaching && o.disableCaching !== false) || o.disableCaching === true){
+                    var dcp = o.disableCachingParam || me.disableCachingParam;
+                    url = Ext.urlAppend(url, dcp + '=' + (new Date().getTime()));
+                }
+
+                o.headers = Ext.apply(o.headers || {}, me.defaultHeaders || {});
+
+                if(o.autoAbort === true || me.autoAbort) {
+                    me.abort();
+                }
+
+                if((method == GET || o.xmlData || o.jsonData) && p){
+                    url = Ext.urlAppend(url, p);
+                    p = '';
+                }
+                return (me.transId = Ext.lib.Ajax.request(method, url, cb, p, o));
+            }else{
+                return o.callback ? o.callback.apply(o.scope, [o,UNDEFINED,UNDEFINED]) : null;
+            }
+        },
+
+        <div id="method-Ext.data.Connection-isLoading"></div>/**
+         * Determine whether this object has a request outstanding.
+         * @param {Number} transactionId (Optional) defaults to the last transaction
+         * @return {Boolean} True if there is an outstanding request.
+         */
+        isLoading : function(transId){
+            return transId ? Ext.lib.Ajax.isCallInProgress(transId) : !! this.transId;
+        },
+
+        <div id="method-Ext.data.Connection-abort"></div>/**
+         * Aborts any outstanding request.
+         * @param {Number} transactionId (Optional) defaults to the last transaction
+         */
+        abort : function(transId){
+            if(transId || this.isLoading()){
+                Ext.lib.Ajax.abort(transId || this.transId);
+            }
+        },
+
+        // private
+        handleResponse : function(response){
+            this.transId = false;
+            var options = response.argument.options;
+            response.argument = options ? options.argument : null;
+            this.fireEvent(REQUESTCOMPLETE, this, response, options);
+            if(options.success){
+                options.success.call(options.scope, response, options);
+            }
+            if(options.callback){
+                options.callback.call(options.scope, options, true, response);
+            }
+        },
+
+        // private
+        handleFailure : function(response, e){
+            this.transId = false;
+            var options = response.argument.options;
+            response.argument = options ? options.argument : null;
+            this.fireEvent(REQUESTEXCEPTION, this, response, options, e);
+            if(options.failure){
+                options.failure.call(options.scope, response, options);
+            }
+            if(options.callback){
+                options.callback.call(options.scope, options, false, response);
+            }
+        },
+
+        // private
+        doFormUpload : function(o, ps, url){
+            var id = Ext.id(),
+                doc = document,
+                frame = doc.createElement('iframe'),
+                form = Ext.getDom(o.form),
+                hiddens = [],
+                hd,
+                encoding = 'multipart/form-data',
+                buf = {
+                    target: form.target,
+                    method: form.method,
+                    encoding: form.encoding,
+                    enctype: form.enctype,
+                    action: form.action
+                };
+
+            Ext.fly(frame).set({
+                id: id,
+                name: id,
+                cls: 'x-hidden'
+
+            });
+
+            doc.body.appendChild(frame);
+
+            //Reset the Frame to neutral domain
+            Ext.fly(frame).set({
+               src : Ext.SSL_SECURE_URL
+            });
+
+            // This is required so that IE doesn't pop the response up in a new window.
+            if(Ext.isIE){
+               document.frames[id].name = id;
+            }
+
+
+            Ext.fly(form).set({
+                target: id,
+                method: POST,
+                enctype: encoding,
+                encoding: encoding,
+                action: url || buf.action
+            });
+
+            // add dynamic params
+            Ext.iterate(Ext.urlDecode(ps, false), function(k, v){
+                hd = doc.createElement('input');
+                Ext.fly(hd).set({
+                    type: 'hidden',
+                    value: v,
+                    name: k
+                });
+                form.appendChild(hd);
+                hiddens.push(hd);
+            });
+
+            function cb(){
+                var me = this,
+                    // bogus response object
+                    r = {responseText : '',
+                         responseXML : null,
+                         argument : o.argument},
+                    doc,
+                    firstChild;
+
+                try{
+                    doc = frame.contentWindow.document || frame.contentDocument || WINDOW.frames[id].document;
+                    if(doc){
+                        if(doc.body){
+                            if(/textarea/i.test((firstChild = doc.body.firstChild || {}).tagName)){ // json response wrapped in textarea
+                                r.responseText = firstChild.value;
+                            }else{
+                                r.responseText = doc.body.innerHTML;
+                            }
+                        }
+                        //in IE the document may still have a body even if returns XML.
+                        r.responseXML = doc.XMLDocument || doc;
+                    }
+                }
+                catch(e) {}
+
+                Ext.EventManager.removeListener(frame, LOAD, cb, me);
+
+                me.fireEvent(REQUESTCOMPLETE, me, r, o);
+
+                function runCallback(fn, scope, args){
+                    if(Ext.isFunction(fn)){
+                        fn.apply(scope, args);
+                    }
+                }
+
+                runCallback(o.success, o.scope, [r, o]);
+                runCallback(o.callback, o.scope, [o, true, r]);
+
+                if(!me.debugUploads){
+                    setTimeout(function(){Ext.removeNode(frame);}, 100);
+                }
+            }
+
+            Ext.EventManager.on(frame, LOAD, cb, this);
+            form.submit();
+
+            Ext.fly(form).set(buf);
+            Ext.each(hiddens, function(h) {
+                Ext.removeNode(h);
+            });
+        }
+    });
+})();
+
+<div id="cls-Ext.Ajax"></div>/**
+ * @class Ext.Ajax
+ * @extends Ext.data.Connection
+ * <p>The global Ajax request class that provides a simple way to make Ajax requests
+ * with maximum flexibility.</p>
+ * <p>Since Ext.Ajax is a singleton, you can set common properties/events for it once
+ * and override them at the request function level only if necessary.</p>
+ * <p>Common <b>Properties</b> you may want to set are:<div class="mdetail-params"><ul>
+ * <li><b><tt>{@link #method}</tt></b><p class="sub-desc"></p></li>
+ * <li><b><tt>{@link #extraParams}</tt></b><p class="sub-desc"></p></li>
+ * <li><b><tt>{@link #url}</tt></b><p class="sub-desc"></p></li>
+ * </ul></div>
+ * <pre><code>
+// Default headers to pass in every request
+Ext.Ajax.defaultHeaders = {
+    'Powered-By': 'Ext'
+};
+ * </code></pre>
+ * </p>
+ * <p>Common <b>Events</b> you may want to set are:<div class="mdetail-params"><ul>
+ * <li><b><tt>{@link Ext.data.Connection#beforerequest beforerequest}</tt></b><p class="sub-desc"></p></li>
+ * <li><b><tt>{@link Ext.data.Connection#requestcomplete requestcomplete}</tt></b><p class="sub-desc"></p></li>
+ * <li><b><tt>{@link Ext.data.Connection#requestexception requestexception}</tt></b><p class="sub-desc"></p></li>
+ * </ul></div>
+ * <pre><code>
+// Example: show a spinner during all Ajax requests
+Ext.Ajax.on('beforerequest', this.showSpinner, this);
+Ext.Ajax.on('requestcomplete', this.hideSpinner, this);
+Ext.Ajax.on('requestexception', this.hideSpinner, this);
+ * </code></pre>
+ * </p>
+ * <p>An example request:</p>
+ * <pre><code>
+// Basic request
+Ext.Ajax.{@link Ext.data.Connection#request request}({
+   url: 'foo.php',
+   success: someFn,
+   failure: otherFn,
+   headers: {
+       'my-header': 'foo'
+   },
+   params: { foo: 'bar' }
+});
+
+// Simple ajax form submission
+Ext.Ajax.{@link Ext.data.Connection#request request}({
+    form: 'some-form',
+    params: 'foo=bar'
+});
+ * </code></pre>
+ * </p>
+ * @singleton
+ */
+Ext.Ajax = new Ext.data.Connection({
+    <div id="cfg-Ext.Ajax-url"></div>/**
+     * @cfg {String} url @hide
+     */
+    <div id="cfg-Ext.Ajax-extraParams"></div>/**
+     * @cfg {Object} extraParams @hide
+     */
+    <div id="cfg-Ext.Ajax-defaultHeaders"></div>/**
+     * @cfg {Object} defaultHeaders @hide
+     */
+    <div id="cfg-Ext.Ajax-method"></div>/**
+     * @cfg {String} method (Optional) @hide
+     */
+    <div id="cfg-Ext.Ajax-timeout"></div>/**
+     * @cfg {Number} timeout (Optional) @hide
+     */
+    <div id="cfg-Ext.Ajax-autoAbort"></div>/**
+     * @cfg {Boolean} autoAbort (Optional) @hide
+     */
+
+    <div id="cfg-Ext.Ajax-disableCaching"></div>/**
+     * @cfg {Boolean} disableCaching (Optional) @hide
+     */
+
+    <div id="prop-Ext.Ajax-disableCaching"></div>/**
+     * @property  disableCaching
+     * True to add a unique cache-buster param to GET requests. (defaults to true)
+     * @type Boolean
+     */
+    <div id="prop-Ext.Ajax-url"></div>/**
+     * @property  url
+     * The default URL to be used for requests to the server. (defaults to undefined)
+     * If the server receives all requests through one URL, setting this once is easier than
+     * entering it on every request.
+     * @type String
+     */
+    <div id="prop-Ext.Ajax-extraParams"></div>/**
+     * @property  extraParams
+     * An object containing properties which are used as extra parameters to each request made
+     * by this object (defaults to undefined). Session information and other data that you need
+     * to pass with each request are commonly put here.
+     * @type Object
+     */
+    <div id="prop-Ext.Ajax-defaultHeaders"></div>/**
+     * @property  defaultHeaders
+     * An object containing request headers which are added to each request made by this object
+     * (defaults to undefined).
+     * @type Object
+     */
+    <div id="prop-Ext.Ajax-method"></div>/**
+     * @property  method
+     * The default HTTP method to be used for requests. Note that this is case-sensitive and
+     * should be all caps (defaults to undefined; if not set but params are present will use
+     * <tt>"POST"</tt>, otherwise will use <tt>"GET"</tt>.)
+     * @type String
+     */
+    <div id="prop-Ext.Ajax-timeout"></div>/**
+     * @property  timeout
+     * The timeout in milliseconds to be used for requests. (defaults to 30000)
+     * @type Number
+     */
+
+    <div id="prop-Ext.Ajax-autoAbort"></div>/**
+     * @property  autoAbort
+     * Whether a new request should abort any pending requests. (defaults to false)
+     * @type Boolean
+     */
+    autoAbort : false,
+
+    <div id="method-Ext.Ajax-serializeForm"></div>/**
+     * Serialize the passed form into a url encoded string
+     * @param {String/HTMLElement} form
+     * @return {String}
+     */
+    serializeForm : function(form){
+        return Ext.lib.Ajax.serializeForm(form);
+    }
+});
+</pre>    
+</body>
 </html>
\ No newline at end of file