datastore: support deferred results. fixes #77.

Author: stephenplusplus

lib/datastore/entity.js

@@ -95,7 +95,10 @@ var SIGN_TO_ORDER = {
  *
  * @example
  * ```js
- * var key = new Key('Company', 123);
+ * var key = new Key({
+ *   namespace: 'ns',
+ *   path: ['Company', 123]
+ * });
  * ```
  */
 function Key(options) {

lib/datastore/transaction.js

@@ -222,11 +222,27 @@ Transaction.prototype.get = function(keys, callback) {
   }
   this.makeReq('lookup', req, res, function(err, resp) {
     if (err) {
-      return callback(err);
+      callback(err);
+      return;
     }
-    var response = entity.formatArray(resp.found);
-    callback(null, isMultipleRequest ? response : response[0]);
-  });
+    var found = entity.formatArray(resp.found);
+    if (isMultipleRequest && resp.deferred && resp.deferred.length) {
+      // There may be more results. Call `.get` again, and append the results.
+      this.get(
+          resp.deferred.map(entity.keyFromKeyProto), function (err, entities) {
+        if (err) {
+          callback(err);
+          return;
+        }
+        if (resp) {
+          found = (found || []).concat(entities);
+        }
+        callback(null, found);
+      });
+      return;
+    }
+    callback(null, isMultipleRequest ? found : found[0]);
+  }.bind(this));
 };
 
 /**

test/datastore/dataset.js

@@ -21,6 +21,7 @@
 var assert = require('assert');
 var ByteBuffer = require('bytebuffer');
 var datastore = require('../../lib').datastore;
+var entity = require('../../lib/datastore/entity.js');
 var mockRespGet = require('../testdata/response_get.json');
 var Transaction = require('../../lib/datastore/transaction.js');
 
@@ -78,6 +79,29 @@ describe('Dataset', function() {
     });
   });
 
+  it('should continue looking for deferred results', function(done) {
+    var ds = new datastore.Dataset({ projectId: 'test' });
+    var key = ds.key('Kind', 5732568548769792);
+    var key2 = ds.key('Kind', 5732568548769792);
+    var lookupCount = 0;
+    ds.transaction.makeReq = function(method, proto, typ, callback) {
+      lookupCount++;
+      assert.equal(method, 'lookup');
+      if (mockRespGet.deferred.length) {
+        // Revert deferred to original state.
+        mockRespGet.deferred = [];
+      } else {
+        mockRespGet.deferred = [ entity.keyToKeyProto(key2) ];
+      }
+      callback(null, mockRespGet);
+    };
+    ds.get([key, key2], function(err, entities) {
+      assert.equal(entities.length, 2);
+      assert.equal(lookupCount, 2);
+      done();
+    });
+  });
+
   it('should delete by key', function(done) {
     var ds = new datastore.Dataset({ projectId: 'test' });
     ds.transaction.makeReq = function(method, proto, typ, callback) {