www.gusucode.com > 一个基于extjs的强大聊天插件源码程序 > 一个基于extjs的强大聊天插件/extjame/ext-jame/js/ext2/source/data/Connection.js
/* * Ext JS Library 2.0.2 * Copyright(c) 2006-2008, Ext JS, LLC. * licensing@extjs.com * * http://extjs.com/license */ /** * @class Ext.data.Connection * @extends Ext.util.Observable * 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.<br><br> * <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 callback in the request options object, or an event listener.</p><br> * <p> * Note: If you are doing a file upload, you will not get a normal response object sent back to * your callback or event handler. Since the upload is handled via in IFRAME, there is no XMLHttpRequest. * The response object is created using the innerHTML of the IFRAME's document as the responseText * property and, if present, the IFRAME's XML document as the responseXML property.</p><br> * This means that a valid XML or HTML document must be returned. If JSON data is required, it is suggested * that it be placed either inside a <textarea> in an HTML document and retrieved from the responseText * using a regex, or inside a CDATA section in an XML document and retrieved from the responseXML using * standard DOM methods. * @constructor * @param {Object} config a configuration object. */ Ext.data.Connection = function(config){ Ext.apply(this, config); this.addEvents( /** * @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", /** * @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", /** * @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, { /** * @cfg {String} url (Optional) The default URL to be used for requests to the server. (defaults to undefined) */ /** * @cfg {Object} extraParams (Optional) An object containing properties which are used as * extra parameters to each request made by this object. (defaults to undefined) */ /** * @cfg {Object} defaultHeaders (Optional) An object containing request headers which are added * to each request made by this object. (defaults to undefined) */ /** * @cfg {String} method (Optional) The default HTTP method to be used for requests. (defaults to undefined; if not set but parms are present will use POST, otherwise GET) */ /** * @cfg {Number} timeout (Optional) The timeout in milliseconds to be used for requests. (defaults to 30000) */ timeout : 30000, /** * @cfg {Boolean} autoAbort (Optional) Whether this request should abort any pending requests. (defaults to false) * @type Boolean */ autoAbort:false, /** * @cfg {Boolean} disableCaching (Optional) True to add a unique cache-buster param to GET requests. (defaults to true) * @type Boolean */ disableCaching: true, /** * <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 recieved. Process any returned data * in a callback function. * @param {Object} options An object which may contain the following properties:<ul> * <li><b>url</b> : String (Optional)<p style="margin-left:1em">The URL to * which to send the request. Defaults to configured URL</p></li> * <li><b>params</b> : Object/String/Function (Optional)<p style="margin-left:1em"> * An object containing properties which are used as parameters to the * request, a url encoded string or a function to call to get either.</p></li> * <li><b>method</b> : String (Optional)<p style="margin-left:1em">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.</p></li> * <li><b>callback</b> : Function (Optional)<p style="margin-left:1em">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<p style="margin-left:1em">The parameter to the request call.</p></li> * <li><b>success</b> : Boolean<p style="margin-left:1em">True if the request succeeded.</p></li> * <li><b>response</b> : Object<p style="margin-left:1em">The XMLHttpRequest object containing the response data. See http://www.w3.org/TR/XMLHttpRequest/ for details about accessing elements of the response.</p></li> * </ul></p></li> * <li><b>success</b> : Function (Optional)<p style="margin-left:1em">The function * to be called upon success of the request. The callback is passed the following * parameters:<ul> * <li><b>response</b> : Object<p style="margin-left:1em">The XMLHttpRequest object containing the response data.</p></li> * <li><b>options</b> : Object<p style="margin-left:1em">The parameter to the request call.</p></li> * </ul></p></li> * <li><b>failure</b> : Function (Optional)<p style="margin-left:1em">The function * to be called upon failure of the request. The callback is passed the * following parameters:<ul> * <li><b>response</b> : Object<p style="margin-left:1em">The XMLHttpRequest object containing the response data.</p></li> * <li><b>options</b> : Object<p style="margin-left:1em">The parameter to the request call.</p></li> * </ul></p></li> * <li><b>scope</b> : Object (Optional)<p style="margin-left:1em">The scope in * which to execute the callbacks: The "this" object for the callback function. * Defaults to the browser window.</p></li> * <li><b>form</b> : Object/String (Optional)<p style="margin-left:1em">A form * object or id to pull parameters from.</p></li> * <li><b>isUpload</b> : Boolean (Optional)<p style="margin-left:1em">True if * the form object is a file upload (will usually be automatically detected).</p></li> * <li><b>headers</b> : Object (Optional)<p style="margin-left:1em">Request * headers to set for the request.</p></li> * <li><b>xmlData</b> : Object (Optional)<p style="margin-left:1em">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.</p></li> * <li><b>jsonData</b> : Object/String (Optional)<p style="margin-left:1em">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.</p></li> * <li><b>disableCaching</b> : Boolean (Optional)<p style="margin-left:1em">True * to add a unique cache-buster param to GET requests.</p></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){ if(this.fireEvent("beforerequest", this, o) !== false){ var p = o.params; if(typeof p == "function"){ p = p.call(o.scope||window, o); } if(typeof p == "object"){ p = Ext.urlEncode(p); } if(this.extraParams){ var extras = Ext.urlEncode(this.extraParams); p = p ? (p + '&' + extras) : extras; } var url = o.url || this.url; if(typeof url == 'function'){ url = url.call(o.scope||window, o); } if(o.form){ var form = Ext.getDom(o.form); url = url || form.action; var enctype = form.getAttribute("enctype"); if(o.isUpload || (enctype && enctype.toLowerCase() == 'multipart/form-data')){ return this.doFormUpload(o, p, url); } var f = Ext.lib.Ajax.serializeForm(form); p = p ? (p + '&' + f) : f; } var hs = o.headers; if(this.defaultHeaders){ hs = Ext.apply(hs || {}, this.defaultHeaders); if(!o.headers){ o.headers = hs; } } var cb = { success: this.handleResponse, failure: this.handleFailure, scope: this, argument: {options: o}, timeout : o.timeout || this.timeout }; var method = o.method||this.method||(p ? "POST" : "GET"); if(method == 'GET' && (this.disableCaching && o.disableCaching !== false) || o.disableCaching === true){ url += (url.indexOf('?') != -1 ? '&' : '?') + '_dc=' + (new Date().getTime()); } if(typeof o.autoAbort == 'boolean'){ // options gets top priority if(o.autoAbort){ this.abort(); } }else if(this.autoAbort !== false){ this.abort(); } if((method == 'GET' && p) || o.xmlData || o.jsonData){ url += (url.indexOf('?') != -1 ? '&' : '?') + p; p = ''; } this.transId = Ext.lib.Ajax.request(method, url, cb, p, o); return this.transId; }else{ Ext.callback(o.callback, o.scope, [o, null, null]); return null; } }, /** * 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){ if(transId){ return Ext.lib.Ajax.isCallInProgress(transId); }else{ return this.transId ? true : false; } }, /** * 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); Ext.callback(options.success, options.scope, [response, options]); Ext.callback(options.callback, 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); Ext.callback(options.failure, options.scope, [response, options]); Ext.callback(options.callback, options.scope, [options, false, response]); }, // private doFormUpload : function(o, ps, url){ var id = Ext.id(); var frame = document.createElement('iframe'); frame.id = id; frame.name = id; frame.className = 'x-hidden'; if(Ext.isIE){ frame.src = Ext.SSL_SECURE_URL; } document.body.appendChild(frame); if(Ext.isIE){ document.frames[id].name = id; } var form = Ext.getDom(o.form); form.target = id; form.method = 'POST'; form.enctype = form.encoding = 'multipart/form-data'; if(url){ form.action = url; } var hiddens, hd; if(ps){ // add dynamic params hiddens = []; ps = Ext.urlDecode(ps, false); for(var k in ps){ if(ps.hasOwnProperty(k)){ hd = document.createElement('input'); hd.type = 'hidden'; hd.name = k; hd.value = ps[k]; form.appendChild(hd); hiddens.push(hd); } } } function cb(){ var r = { // bogus response object responseText : '', responseXML : null }; r.argument = o ? o.argument : null; try { // var doc; if(Ext.isIE){ doc = frame.contentWindow.document; }else { doc = (frame.contentDocument || window.frames[id].document); } if(doc && doc.body){ r.responseText = doc.body.innerHTML; } if(doc && doc.XMLDocument){ r.responseXML = doc.XMLDocument; }else { r.responseXML = doc; } } catch(e) { // ignore } Ext.EventManager.removeListener(frame, 'load', cb, this); this.fireEvent("requestcomplete", this, r, o); Ext.callback(o.success, o.scope, [r, o]); Ext.callback(o.callback, o.scope, [o, true, r]); setTimeout(function(){Ext.removeNode(frame);}, 100); } Ext.EventManager.on(frame, 'load', cb, this); form.submit(); if(hiddens){ // remove dynamic params for(var i = 0, len = hiddens.length; i < len; i++){ Ext.removeNode(hiddens[i]); } } } }); /** * @class Ext.Ajax * @extends Ext.data.Connection * Global Ajax request class. Provides a simple way to make Ajax requests with maximum flexibility. Example usage: * <pre><code> // Basic request Ext.Ajax.request({ url: 'foo.php', success: someFn, failure: otherFn, headers: { 'my-header': 'foo' }, params: { foo: 'bar' } }); // Simple ajax form submission Ext.Ajax.request({ form: 'some-form', params: 'foo=bar' }); // Default headers to pass in every request Ext.Ajax.defaultHeaders = { 'Powered-By': 'Ext' }; // Global Ajax events can be handled on every request! Ext.Ajax.on('beforerequest', this.showSpinner, this); </code></pre> * @singleton */ Ext.Ajax = new Ext.data.Connection({ /** * @cfg {String} url @hide */ /** * @cfg {Object} extraParams @hide */ /** * @cfg {Object} defaultHeaders @hide */ /** * @cfg {String} method (Optional) @hide */ /** * @cfg {Number} timeout (Optional) @hide */ /** * @cfg {Boolean} autoAbort (Optional) @hide */ /** * @cfg {Boolean} disableCaching (Optional) @hide */ /** * @property disableCaching * True to add a unique cache-buster param to GET requests. (defaults to true) * @type Boolean */ /** * @property url * The default URL to be used for requests to the server. (defaults to undefined) * @type String */ /** * @property extraParams * An object containing properties which are used as * extra parameters to each request made by this object. (defaults to undefined) * @type Object */ /** * @property defaultHeaders * An object containing request headers which are added to each request made by this object. (defaults to undefined) * @type Object */ /** * @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 parms are present will use "POST," otherwise "GET.") * @type String */ /** * @property timeout * The timeout in milliseconds to be used for requests. (defaults to 30000) * @type Number */ /** * @property autoAbort * Whether a new request should abort any pending requests. (defaults to false) * @type Boolean */ autoAbort : false, /** * Serialize the passed form into a url encoded string * @param {String/HTMLElement} form * @return {String} */ serializeForm : function(form){ return Ext.lib.Ajax.serializeForm(form); } });