--- /dev/null
+<!DOCTYPE html><html><head><title>Sencha Documentation Project</title><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../prettify.css" type="text/css"><link rel="stylesheet" href="../prettify_sa.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script></head><body onload="prettyPrint()"><pre class="prettyprint"><pre><span id='Ext-data.Batch-method-constructor'><span id='Ext-data.Batch'>/**
+</span></span> * @author Ed Spencer
+ * @class Ext.data.Batch
+ *
+ * <p>Provides a mechanism to run one or more {@link Ext.data.Operation operations} in a given order. Fires the 'operationcomplete' event
+ * after the completion of each Operation, and the 'complete' event when all Operations have been successfully executed. Fires an 'exception'
+ * event if any of the Operations encounter an exception.</p>
+ *
+ * <p>Usually these are only used internally by {@link Ext.data.proxy.Proxy} classes</p>
+ *
+ * @constructor
+ * @param {Object} config Optional config object
+ */
+Ext.define('Ext.data.Batch', {
+ mixins: {
+ observable: 'Ext.util.Observable'
+ },
+
+<span id='Ext-data.Batch-property-autoStart'> /**
+</span> * True to immediately start processing the batch as soon as it is constructed (defaults to false)
+ * @property autoStart
+ * @type Boolean
+ */
+ autoStart: false,
+
+<span id='Ext-data.Batch-property-current'> /**
+</span> * The index of the current operation being executed
+ * @property current
+ * @type Number
+ */
+ current: -1,
+
+<span id='Ext-data.Batch-property-total'> /**
+</span> * The total number of operations in this batch. Read only
+ * @property total
+ * @type Number
+ */
+ total: 0,
+
+<span id='Ext-data.Batch-property-isRunning'> /**
+</span> * True if the batch is currently running
+ * @property isRunning
+ * @type Boolean
+ */
+ isRunning: false,
+
+<span id='Ext-data.Batch-property-isComplete'> /**
+</span> * True if this batch has been executed completely
+ * @property isComplete
+ * @type Boolean
+ */
+ isComplete: false,
+
+<span id='Ext-data.Batch-property-hasException'> /**
+</span> * True if this batch has encountered an exception. This is cleared at the start of each operation
+ * @property hasException
+ * @type Boolean
+ */
+ hasException: false,
+
+<span id='Ext-data.Batch-property-pauseOnException'> /**
+</span> * True to automatically pause the execution of the batch if any operation encounters an exception (defaults to true)
+ * @property pauseOnException
+ * @type Boolean
+ */
+ pauseOnException: true,
+
+ constructor: function(config) {
+ var me = this;
+
+ me.addEvents(
+<span id='Ext-data.Batch-event-complete'> /**
+</span> * @event complete
+ * Fired when all operations of this batch have been completed
+ * @param {Ext.data.Batch} batch The batch object
+ * @param {Object} operation The last operation that was executed
+ */
+ 'complete',
+
+<span id='Ext-data.Batch-event-exception'> /**
+</span> * @event exception
+ * Fired when a operation encountered an exception
+ * @param {Ext.data.Batch} batch The batch object
+ * @param {Object} operation The operation that encountered the exception
+ */
+ 'exception',
+
+<span id='Ext-data.Batch-event-operationcomplete'> /**
+</span> * @event operationcomplete
+ * Fired when each operation of the batch completes
+ * @param {Ext.data.Batch} batch The batch object
+ * @param {Object} operation The operation that just completed
+ */
+ 'operationcomplete'
+ );
+
+ me.mixins.observable.constructor.call(me, config);
+
+<span id='Ext-data.Batch-property-operations'> /**
+</span> * Ordered array of operations that will be executed by this batch
+ * @property operations
+ * @type Array
+ */
+ me.operations = [];
+ },
+
+<span id='Ext-data.Batch-method-add'> /**
+</span> * Adds a new operation to this batch
+ * @param {Object} operation The {@link Ext.data.Operation Operation} object
+ */
+ add: function(operation) {
+ this.total++;
+
+ operation.setBatch(this);
+
+ this.operations.push(operation);
+ },
+
+<span id='Ext-data.Batch-method-start'> /**
+</span> * Kicks off the execution of the batch, continuing from the next operation if the previous
+ * operation encountered an exception, or if execution was paused
+ */
+ start: function() {
+ this.hasException = false;
+ this.isRunning = true;
+
+ this.runNextOperation();
+ },
+
+<span id='Ext-data.Batch-method-runNextOperation'> /**
+</span> * @private
+ * Runs the next operation, relative to this.current.
+ */
+ runNextOperation: function() {
+ this.runOperation(this.current + 1);
+ },
+
+<span id='Ext-data.Batch-method-pause'> /**
+</span> * Pauses execution of the batch, but does not cancel the current operation
+ */
+ pause: function() {
+ this.isRunning = false;
+ },
+
+<span id='Ext-data.Batch-method-runOperation'> /**
+</span> * Executes a operation by its numeric index
+ * @param {Number} index The operation index to run
+ */
+ runOperation: function(index) {
+ var me = this,
+ operations = me.operations,
+ operation = operations[index],
+ onProxyReturn;
+
+ if (operation === undefined) {
+ me.isRunning = false;
+ me.isComplete = true;
+ me.fireEvent('complete', me, operations[operations.length - 1]);
+ } else {
+ me.current = index;
+
+ onProxyReturn = function(operation) {
+ var hasException = operation.hasException();
+
+ if (hasException) {
+ me.hasException = true;
+ me.fireEvent('exception', me, operation);
+ } else {
+ me.fireEvent('operationcomplete', me, operation);
+ }
+
+ if (hasException && me.pauseOnException) {
+ me.pause();
+ } else {
+ operation.setCompleted();
+ me.runNextOperation();
+ }
+ };
+
+ operation.setStarted();
+
+ me.proxy[operation.action](operation, onProxyReturn, me);
+ }
+ }
+});</pre></pre></body></html>
\ No newline at end of file
git.ithinksw.org / extjs.git / blobdiff