DevTools: Implement undo, redo operations for the DOMStorage views.

Source/devtools/front_end/DOMStorage.js

 /*
  * Copyright (C) 2008 Nokia Inc.  All rights reserved.
  * Copyright (C) 2013 Samsung Electronics. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  *
  * 1.  Redistributions of source code must retain the above copyright
  *     notice, this list of conditions and the following disclaimer.
@@ skipping 18 matching lines @@
 
 /**
  * @constructor
  * @param {string} securityOrigin
  * @param {boolean} isLocalStorage
  */
 WebInspector.DOMStorage = function(securityOrigin, isLocalStorage)
 {
     this._securityOrigin = securityOrigin;
     this._isLocalStorage = isLocalStorage;
+    this._storageHistory = new WebInspector.DOMStorageHistory(this);
 }
 
 /**
  * @param {string} securityOrigin
  * @param {boolean} isLocalStorage
  * @return {DOMStorageAgent.StorageId}
  */
 WebInspector.DOMStorage.storageId = function(securityOrigin, isLocalStorage)
 {
     return { securityOrigin: securityOrigin, isLocalStorage: isLocalStorage };
@@ skipping 26 matching lines @@
     {
         DOMStorageAgent.getDOMStorageItems(this.id, callback);
     },
 
     /**
      * @param {string} key
      * @param {string} value
      */
     setItem: function(key, value)
     {
-        DOMStorageAgent.setDOMStorageItem(this.id, key, value);
+        this._storageHistory.perform(new WebInspector.DOMStorageSetItemAction(this, key, value));
     },
 
     /**
      * @param {string} key
      */
     removeItem: function(key)
     {
-        DOMStorageAgent.removeDOMStorageItem(this.id, key);
+        this._storageHistory.perform(new WebInspector.DOMStorageRemoveItemAction(this, key));
+    },
+
+    undo: function()
+    {
+        this._storageHistory.undo();
+    },
+
+    redo: function()
+    {
+        this._storageHistory.redo();
     }
 }
 
+/**
+ * @constructor
+ * @param {WebInspector.DOMStorage} domStorage
+ */
+WebInspector.DOMStorageAction = function(domStorage)
+{
+    this._domStorage = domStorage;
+}
+
+WebInspector.DOMStorageAction.prototype = {
+    /**
+     * @param {function()} callback
+     */
+    perform: function(callback)
+    {
+    },
+
+    undo: function()
+    {
+    },
+
+    redo: function()
+    {
+    }
+}
+
+/**
+ * @constructor
+ * @extends {WebInspector.DOMStorageAction}
+ * @param {!WebInspector.DOMStorage} domStorage
+ * @param {!string} key

[apavlov, 2013/08/02 08:16:59]

! is not required for non-object types (and is the default for them (see the
Closure compiler JsDoc reference I sent in the previous review comments), so we
omit it for strings, numbers, etc.)

+ */
+WebInspector.DOMStorageRemoveItemAction = function(domStorage, key)
+{
+    WebInspector.DOMStorageAction.call(this, domStorage);
+    this._key = key;
+}
+
+WebInspector.DOMStorageRemoveItemAction.prototype = {
+    /**
+     * @override
+     * @param {function()} callback

[apavlov, 2013/08/02 08:16:59]

With @override, you can omit other annotations altogether: "If no other
annotations are included, the method or property automatically inherits
annotations from its superclass."

+     */
+    perform: function(callback)
+    {
+        DOMStorageAgent.getDOMStorageItem(this._domStorage.id, this._key, valueReceived.bind(this));
+
+        /**
+         * @param {?Protocol.Error} error
+         * @param {string=} value
+         */
+        function valueReceived(error, value)
+        {
+            this._value = value;
+            this.redo();
+            callback();
+        }
+    },
+
+    /**
+     * @override
+     */
+    undo: function()
+    {
+        DOMStorageAgent.setDOMStorageItem(this._domStorage.id, this._key, this._value);
+    },
+
+    /**
+     * @override
+     */
+    redo: function()
+    {
+        DOMStorageAgent.removeDOMStorageItem(this._domStorage.id, this._key);
+    },
+
+    __proto__: WebInspector.DOMStorageAction.prototype
+}
+
+/**
+ * @constructor
+ * @extends {WebInspector.DOMStorageAction}
+ * @param {!WebInspector.DOMStorage} domStorage
+ * @param {!string} key

[apavlov, 2013/08/02 08:16:59]

ditto for !

+ * @param {!string} value
+ */
+WebInspector.DOMStorageSetItemAction = function(domStorage, key, value)
+{
+    WebInspector.DOMStorageAction.call(this, domStorage);
+    this._key = key;
+    this._value = value;
+}
+
+WebInspector.DOMStorageSetItemAction.prototype = {
+    /**
+     * @override
+     * @param {function(): void} callback

[apavlov, 2013/08/02 08:16:59]

ditto for JsDoc

+     */
+    perform: function(callback)
+    {
+        DOMStorageAgent.getDOMStorageItem(this._domStorage.id, this._key, valueReceived.bind(this));
+
+        /**
+         * @param {?Protocol.Error} error
+         * @param {string=} value
+         */
+        function valueReceived(error, value)
+        {
+            if (typeof value === 'undefined' || value === null) {

[apavlov, 2013/08/02 08:16:59]

double-quotes, please. Also, you can never get "null" here, since the protocol
does not allow transmitting null in place of strings - remove this check. What
you must do is check for the |error| (see protocol method callbacks elsewhere,
e.g. in CSSStyleModel.js), something along the lines of:

if (error) {
    callback(...something...);
    return;
}

Perhaps, the callback should accept a boolean indicating whether the operation
has finished successfully (if that makes sense for your code to distinguish
these situations).

+                this._exists = false;

[apavlov, 2013/08/02 08:16:59]

this can be "delete this._exists"

+            } else {
+                this._exists = true;
+                this._oldValue = value;
+            }
+            this.redo();
+            callback();
+        }
+    },
+
+    /**
+     * @override
+     */
+    undo: function()
+    {
+        if (!this._exists)
+            DOMStorageAgent.removeDOMStorageItem(this._domStorage.id, this._key);
+        else
+            DOMStorageAgent.setDOMStorageItem(this._domStorage.id, this._key, this._oldValue);
+    },
+
+    /**
+     * @override
+     */
+    redo: function()
+    {
+        DOMStorageAgent.setDOMStorageItem(this._domStorage.id, this._key, this._value);
+    },
+
+    __proto__: WebInspector.DOMStorageAction.prototype
+}
+
+/**
+ * @constructor
+ * @param {WebInspector.DOMStorage} domStorage
+ */
+WebInspector.DOMStorageHistory = function(domStorage)
+{
+    this._domStorage = domStorage;
+    this._actions = [];
+    this._currentActionIndex = -1;
+}
+
+WebInspector.DOMStorageHistory.prototype = {
+    /**
+     * @param {WebInspector.DOMStorageAction} action
+     */
+    perform: function(action)
+    {
+        if (!action)
+            return;
+
+        action.perform(actionCompleted.bind(this));
+        function actionCompleted()
+        {
+            this._actions.push(action);
+            ++this._currentActionIndex;
+        }
+    },
+
+    undo: function()
+    {
+        if (this._currentActionIndex < 0)
+            return;
+
+        var action = this._actions[this._currentActionIndex];
+        console.assert(action);
+        action.undo();
+        --this._currentActionIndex;
+    },
+
+    redo: function()
+    {
+        if (this._currentActionIndex >= this._actions.length - 1)
+            return;
+
+        var action = this._actions[++this._currentActionIndex];
+        console.assert(action);
+        action.redo();
+    }
+}
+
 /**
  * @constructor
  * @extends {WebInspector.Object}
  */
 WebInspector.DOMStorageModel = function()
 {
     this._storages = {};
     InspectorBackend.registerDOMStorageDispatcher(new WebInspector.DOMStorageDispatcher(this));
     DOMStorageAgent.enable();
     WebInspector.resourceTreeModel.addEventListener(WebInspector.ResourceTreeModel.EventTypes.SecurityOriginAdded, this._securityOriginAdded, this);
@@ skipping 190 matching lines @@
     domStorageItemUpdated: function(storageId, key, oldValue, newValue)
     {
         this._model._domStorageItemUpdated(storageId, key, oldValue, newValue);
     },
 }
 
 /**
  * @type {WebInspector.DOMStorageModel}
  */
 WebInspector.domStorageModel = null;