feat(Object): implement save with options.query

Author: leeyeh

src/object.js

@@ -832,7 +832,9 @@ module.exports = function(AV) {
      *   }, function(error) {
      *     // The save failed.  Error is an instance of AV.Error.
      *   });</pre>
-     *
+     * @param {Object} options Optional Backbone-like options object to be passed in to set.
+     * @param {Boolean} options.fetchWhenSave fetch and update object after save succeeded
+     * @param {AV.Query} options.query Save object only when it matches the query
      * @return {AV.Promise} A promise that is fulfilled when the save
      *     completes.
      * @see AV.Error
@@ -918,6 +920,18 @@ module.exports = function(AV) {
           json._fetchWhenSave = true;
         }
 
+        if (options.fetchWhenSave) {
+          json._fetchWhenSave = true;
+        }
+        if (options.query) {
+          try {
+            json._where = options.query.toJSON().where;
+          } catch (e) {
+            var error = new Error('options.query is not an AV.Query');
+            return AV.Promise.error(error)._thenRunCallbacks(options, model);
+          }
+        }
+
         var route = "classes";
         var className = model.className;
         if (model.className === "_User" && !model.id) {

src/utils.js

@@ -378,9 +378,15 @@ const init = (AV) => {
     if (objectId) {
       apiURL += "/" + objectId;
     }
-    if ((route ==='users' || route === 'classes') && dataObject && dataObject._fetchWhenSave){
-      delete dataObject._fetchWhenSave;
-      apiURL += '?new=true';
+    if ((route ==='users' || route === 'classes') && dataObject){
+      if (dataObject._fetchWhenSave) {
+        delete dataObject._fetchWhenSave;
+        apiURL += '?new=true';
+      }
+      if (dataObject._where) {
+        apiURL += ('?where=' + encodeURIComponent(JSON.stringify(dataObject._where)));
+        delete dataObject._where;
+      }
     }
 
     dataObject = _.clone(dataObject || {});

test/object.js

@@ -119,6 +119,19 @@ describe('Objects', function(){
         }
       });
     });
+    it("should not update prop when query not match",function(done){
+      gameScore.set("score", 10000);
+      gameScore.save(null, {
+        query: new AV.Query(GameScore).equalTo('score', -1),
+        success: function(result) {
+          done(new Error('should not success'));
+        },
+        error: function(gameScore, error) {
+          expect(error.code).to.be.eql(305);
+          done();
+        }
+      });
+    });
   });
 
   describe("Deleting Objects",function(){