X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/ee06f37b0f6f6d94cd05a6ffae556660f7c4a2bc..c930e9176a5a85509c5b0230e2bff5c22a591432:/source/core/UpdateManager.js diff --git a/source/core/UpdateManager.js b/source/core/UpdateManager.js deleted file mode 100644 index bf667237..00000000 --- a/source/core/UpdateManager.js +++ /dev/null @@ -1,529 +0,0 @@ -/* - * Ext JS Library 2.2.1 - * Copyright(c) 2006-2009, Ext JS, LLC. - * licensing@extjs.com - * - * http://extjs.com/license - */ - -/** - * @class Ext.Updater - * @extends Ext.util.Observable - * Provides AJAX-style update capabilities for Element objects. Updater can be used to {@link #update} an Element once, - * or you can use {@link #startAutoRefresh} to set up an auto-updating Element on a specific interval.

- * Usage:
- *

- * // Get it from a Ext.Element object
- * var el = Ext.get("foo");
- * var mgr = el.getUpdater();
- * mgr.update({
-        url: "http://myserver.com/index.php",
-        params: {
-            param1: "foo",
-            param2: "bar"
-        }
- * });
- * ...
- * mgr.formUpdate("myFormId", "http://myserver.com/index.php");
- * 
- * // or directly (returns the same Updater instance) - * var mgr = new Ext.Updater("myElementId"); - * mgr.startAutoRefresh(60, "http://myserver.com/index.php"); - * mgr.on("update", myFcnNeedsToKnow); - *
- * // short handed call directly from the element object - * Ext.get("foo").load({ - url: "bar.php", - scripts: true, - params: "param1=foo&param2=bar", - text: "Loading Foo..." - * }); - *
- * @constructor - * Create new Updater directly. - * @param {Mixed} el The element to update - * @param {Boolean} forceNew (optional) By default the constructor checks to see if the passed element already - * has an Updater and if it does it returns the same instance. This will skip that check (useful for extending this class). - */ -Ext.Updater = Ext.extend(Ext.util.Observable, { - constructor: function(el, forceNew){ - el = Ext.get(el); - if(!forceNew && el.updateManager){ - return el.updateManager; - } - /** - * The Element object - * @type Ext.Element - */ - this.el = el; - /** - * Cached url to use for refreshes. Overwritten every time update() is called unless "discardUrl" param is set to true. - * @type String - */ - this.defaultUrl = null; - - this.addEvents( - /** - * @event beforeupdate - * Fired before an update is made, return false from your handler and the update is cancelled. - * @param {Ext.Element} el - * @param {String/Object/Function} url - * @param {String/Object} params - */ - "beforeupdate", - /** - * @event update - * Fired after successful update is made. - * @param {Ext.Element} el - * @param {Object} oResponseObject The response Object - */ - "update", - /** - * @event failure - * Fired on update failure. - * @param {Ext.Element} el - * @param {Object} oResponseObject The response Object - */ - "failure" - ); - var d = Ext.Updater.defaults; - /** - * Blank page URL to use with SSL file uploads (defaults to {@link Ext.Updater.defaults#sslBlankUrl}). - * @type String - */ - this.sslBlankUrl = d.sslBlankUrl; - /** - * Whether to append unique parameter on get request to disable caching (defaults to {@link Ext.Updater.defaults#disableCaching}). - * @type Boolean - */ - this.disableCaching = d.disableCaching; - /** - * Text for loading indicator (defaults to {@link Ext.Updater.defaults#indicatorText}). - * @type String - */ - this.indicatorText = d.indicatorText; - /** - * Whether to show indicatorText when loading (defaults to {@link Ext.Updater.defaults#showLoadIndicator}). - * @type String - */ - this.showLoadIndicator = d.showLoadIndicator; - /** - * Timeout for requests or form posts in seconds (defaults to {@link Ext.Updater.defaults#timeout}). - * @type Number - */ - this.timeout = d.timeout; - /** - * True to process scripts in the output (defaults to {@link Ext.Updater.defaults#loadScripts}). - * @type Boolean - */ - this.loadScripts = d.loadScripts; - /** - * Transaction object of the current executing transaction, or null if there is no active transaction. - */ - this.transaction = null; - /** - * Delegate for refresh() prebound to "this", use myUpdater.refreshDelegate.createCallback(arg1, arg2) to bind arguments - * @type Function - */ - this.refreshDelegate = this.refresh.createDelegate(this); - /** - * Delegate for update() prebound to "this", use myUpdater.updateDelegate.createCallback(arg1, arg2) to bind arguments - * @type Function - */ - this.updateDelegate = this.update.createDelegate(this); - /** - * Delegate for formUpdate() prebound to "this", use myUpdater.formUpdateDelegate.createCallback(arg1, arg2) to bind arguments - * @type Function - */ - this.formUpdateDelegate = this.formUpdate.createDelegate(this); - - if(!this.renderer){ - /** - * The renderer for this Updater (defaults to {@link Ext.Updater.BasicRenderer}). - */ - this.renderer = this.getDefaultRenderer(); - } - Ext.Updater.superclass.constructor.call(this); - }, - /** - * This is an overrideable method which returns a reference to a default - * renderer class if none is specified when creating the Ext.Updater. - * Defaults to {@link Ext.Updater.BasicRenderer} - */ - getDefaultRenderer: function() { - return new Ext.Updater.BasicRenderer(); - }, - /** - * Get the Element this Updater is bound to - * @return {Ext.Element} The element - */ - getEl : function(){ - return this.el; - }, - - /** - * Performs an asynchronous request, updating this element with the response. - * If params are specified it uses POST, otherwise it uses GET.

- * Note: Due to the asynchronous nature of remote server requests, the Element - * will not have been fully updated when the function returns. To post-process the returned - * data, use the callback option, or an update event handler. - * @param {Object} options A config object containing any of the following options: - *

- * For example: -


-um.update({
-    url: "your-url.php",
-    params: {param1: "foo", param2: "bar"}, // or a URL encoded string
-    callback: yourFunction,
-    scope: yourObject, //(optional scope)
-    discardUrl: true,
-    nocache: true,
-    text: "Loading...",
-    timeout: 60,
-    scripts: false // Save time by avoiding RegExp execution.
-});
-
- */ - update : function(url, params, callback, discardUrl){ - if(this.fireEvent("beforeupdate", this.el, url, params) !== false){ - var cfg, callerScope; - if(typeof url == "object"){ // must be config object - cfg = url; - url = cfg.url; - params = params || cfg.params; - callback = callback || cfg.callback; - discardUrl = discardUrl || cfg.discardUrl; - callerScope = cfg.scope; - if(typeof cfg.nocache != "undefined"){this.disableCaching = cfg.nocache;}; - if(typeof cfg.text != "undefined"){this.indicatorText = '
'+cfg.text+"
";}; - if(typeof cfg.scripts != "undefined"){this.loadScripts = cfg.scripts;}; - if(typeof cfg.timeout != "undefined"){this.timeout = cfg.timeout;}; - } - this.showLoading(); - - if(!discardUrl){ - this.defaultUrl = url; - } - if(typeof url == "function"){ - url = url.call(this); - } - - var o = Ext.apply({}, { - url : url, - params: (typeof params == "function" && callerScope) ? params.createDelegate(callerScope) : params, - success: this.processSuccess, - failure: this.processFailure, - scope: this, - callback: undefined, - timeout: (this.timeout*1000), - disableCaching: this.disableCaching, - argument: { - "options": cfg, - "url": url, - "form": null, - "callback": callback, - "scope": callerScope || window, - "params": params - } - }, cfg); - - this.transaction = Ext.Ajax.request(o); - } - }, - - /** - *

Performs an async form post, updating this element with the response. If the form has the attribute - * enctype="multipart/form-data", it assumes it's a file upload. - * Uses this.sslBlankUrl for SSL file uploads to prevent IE security warning.

- *

File uploads are not performed using normal "Ajax" techniques, that is they are not - * performed using XMLHttpRequests. Instead the form is submitted in the standard manner with the - * DOM <form> element temporarily modified to have its - * target set to refer - * to a dynamically generated, hidden <iframe> which is inserted into the document - * but removed after the return data has been gathered.

- *

Be aware that file upload packets, sent with the content type multipart/form-data - * and some server technologies (notably JEE) may require some custom processing in order to - * retrieve parameter names and parameter values from the packet content.

- * @param {String/HTMLElement} form The form Id or form element - * @param {String} url (optional) The url to pass the form to. If omitted the action attribute on the form will be used. - * @param {Boolean} reset (optional) Whether to try to reset the form after the update - * @param {Function} callback (optional) Callback when transaction is complete. The following - * parameters are passed: - */ - formUpdate : function(form, url, reset, callback){ - if(this.fireEvent("beforeupdate", this.el, form, url) !== false){ - if(typeof url == "function"){ - url = url.call(this); - } - form = Ext.getDom(form) - this.transaction = Ext.Ajax.request({ - form: form, - url:url, - success: this.processSuccess, - failure: this.processFailure, - scope: this, - timeout: (this.timeout*1000), - argument: { - "url": url, - "form": form, - "callback": callback, - "reset": reset - } - }); - this.showLoading.defer(1, this); - } - }, - - /** - * Refresh the element with the last used url or defaultUrl. If there is no url, it returns immediately - * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess) - */ - refresh : function(callback){ - if(this.defaultUrl == null){ - return; - } - this.update(this.defaultUrl, null, callback, true); - }, - - /** - * Set this element to auto refresh. Can be canceled by calling {@link #stopAutoRefresh}. - * @param {Number} interval How often to update (in seconds). - * @param {String/Object/Function} url (optional) The url for this request, a config object in the same format - * supported by {@link #load}, or a function to call to get the url (defaults to the last used url). Note that while - * the url used in a load call can be reused by this method, other load config options will not be reused and must be - * sepcified as part of a config object passed as this paramter if needed. - * @param {String/Object} params (optional) The parameters to pass as either a url encoded string - * "¶m1=1¶m2=2" or as an object {param1: 1, param2: 2} - * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess) - * @param {Boolean} refreshNow (optional) Whether to execute the refresh now, or wait the interval - */ - startAutoRefresh : function(interval, url, params, callback, refreshNow){ - if(refreshNow){ - this.update(url || this.defaultUrl, params, callback, true); - } - if(this.autoRefreshProcId){ - clearInterval(this.autoRefreshProcId); - } - this.autoRefreshProcId = setInterval(this.update.createDelegate(this, [url || this.defaultUrl, params, callback, true]), interval*1000); - }, - - /** - * Stop auto refresh on this element. - */ - stopAutoRefresh : function(){ - if(this.autoRefreshProcId){ - clearInterval(this.autoRefreshProcId); - delete this.autoRefreshProcId; - } - }, - - /** - * Returns true if the Updater is currently set to auto refresh its content (see {@link #startAutoRefresh}), otherwise false. - */ - isAutoRefreshing : function(){ - return this.autoRefreshProcId ? true : false; - }, - - /** - * Display the element's "loading" state. By default, the element is updated with {@link #indicatorText}. This - * method may be overridden to perform a custom action while this Updater is actively updating its contents. - */ - showLoading : function(){ - if(this.showLoadIndicator){ - this.el.update(this.indicatorText); - } - }, - - // private - processSuccess : function(response){ - this.transaction = null; - if(response.argument.form && response.argument.reset){ - try{ // put in try/catch since some older FF releases had problems with this - response.argument.form.reset(); - }catch(e){} - } - if(this.loadScripts){ - this.renderer.render(this.el, response, this, - this.updateComplete.createDelegate(this, [response])); - }else{ - this.renderer.render(this.el, response, this); - this.updateComplete(response); - } - }, - - // private - updateComplete : function(response){ - this.fireEvent("update", this.el, response); - if(typeof response.argument.callback == "function"){ - response.argument.callback.call(response.argument.scope, this.el, true, response, response.argument.options); - } - }, - - // private - processFailure : function(response){ - this.transaction = null; - this.fireEvent("failure", this.el, response); - if(typeof response.argument.callback == "function"){ - response.argument.callback.call(response.argument.scope, this.el, false, response, response.argument.options); - } - }, - - /** - * Sets the content renderer for this Updater. See {@link Ext.Updater.BasicRenderer#render} for more details. - * @param {Object} renderer The object implementing the render() method - */ - setRenderer : function(renderer){ - this.renderer = renderer; - }, - - /** - * Returns the content renderer for this Updater. See {@link Ext.Updater.BasicRenderer#render} for more details. - * @return {Object} - */ - getRenderer : function(){ - return this.renderer; - }, - - /** - * Sets the default URL used for updates. - * @param {String/Function} defaultUrl The url or a function to call to get the url - */ - setDefaultUrl : function(defaultUrl){ - this.defaultUrl = defaultUrl; - }, - - /** - * Aborts the currently executing transaction, if any. - */ - abort : function(){ - if(this.transaction){ - Ext.Ajax.abort(this.transaction); - } - }, - - /** - * Returns true if an update is in progress, otherwise false. - * @return {Boolean} - */ - isUpdating : function(){ - if(this.transaction){ - return Ext.Ajax.isLoading(this.transaction); - } - return false; - } -}); - -/** - * @class Ext.Updater.defaults - * The defaults collection enables customizing the default properties of Updater - */ - Ext.Updater.defaults = { - /** - * Timeout for requests or form posts in seconds (defaults to 30 seconds). - * @type Number - */ - timeout : 30, - /** - * True to process scripts by default (defaults to false). - * @type Boolean - */ - loadScripts : false, - /** - * Blank page URL to use with SSL file uploads (defaults to {@link Ext#SSL_SECURE_URL} if set, or "javascript:false"). - * @type String - */ - sslBlankUrl : (Ext.SSL_SECURE_URL || "javascript:false"), - /** - * True to append a unique parameter to GET requests to disable caching (defaults to false). - * @type Boolean - */ - disableCaching : false, - /** - * Whether or not to show {@link #indicatorText} during loading (defaults to true). - * @type Boolean - */ - showLoadIndicator : true, - /** - * Text for loading indicator (defaults to '<div class="loading-indicator">Loading...</div>'). - * @type String - */ - indicatorText : '
Loading...
' - }; - -/** - * Static convenience method. This method is deprecated in favor of el.load({url:'foo.php', ...}). - * Usage: - *
Ext.Updater.updateElement("my-div", "stuff.php");
- * @param {Mixed} el The element to update - * @param {String} url The url - * @param {String/Object} params (optional) Url encoded param string or an object of name/value pairs - * @param {Object} options (optional) A config object with any of the Updater properties you want to set - for - * example: {disableCaching:true, indicatorText: "Loading data..."} - * @static - * @deprecated - * @member Ext.Updater - */ -Ext.Updater.updateElement = function(el, url, params, options){ - var um = Ext.get(el).getUpdater(); - Ext.apply(um, options); - um.update(url, params, options ? options.callback : null); -}; -/** - * @class Ext.Updater.BasicRenderer - * Default Content renderer. Updates the elements innerHTML with the responseText. - */ -Ext.Updater.BasicRenderer = function(){}; - -Ext.Updater.BasicRenderer.prototype = { - /** - * This is called when the transaction is completed and it's time to update the element - The BasicRenderer - * updates the elements innerHTML with the responseText - To perform a custom render (i.e. XML or JSON processing), - * create an object with a "render(el, response)" method and pass it to setRenderer on the Updater. - * @param {Ext.Element} el The element being rendered - * @param {Object} response The XMLHttpRequest object - * @param {Updater} updateManager The calling update manager - * @param {Function} callback A callback that will need to be called if loadScripts is true on the Updater - */ - render : function(el, response, updateManager, callback){ - el.update(response.responseText, updateManager.loadScripts, callback); - } -}; - -Ext.UpdateManager = Ext.Updater;