---

ajaaym · chingor13 · commit 040d111888d5 · 2018-11-27T10:54:19.000-08:00
yaml --- r: 11311 b: refs/heads/master c: 2501613 h: refs/heads/master i: 11309: efa5338 11307: b2ebb57 11303: 7e10fe5 11295: c45d096
diff --git a/[refs] b/[refs]
@@ -1,5 +1,5 @@
 ---
-refs/heads/master: 38ec041b6ddc84f7ea475df1618a1fe1a697acfe
+refs/heads/master: 25016131f77f3038df3ca754fc784412bd1c162f
 refs/heads/gh-pages: d1184592f037d21f5ba27914eeda5ea8a3f4a953
 refs/tags/0.0.9: 22f1839238f66c39e67ed4dfdcd273b1ae2e8444
 refs/tags/v0.0.10: 207ebd2a3472fddee69fe1298eb90429e3306efd
diff --git a/trunk/google-cloud-clients/google-cloud-datastore/src/main/java/com/google/cloud/datastore/QueryResults.java b/trunk/google-cloud-clients/google-cloud-datastore/src/main/java/com/google/cloud/datastore/QueryResults.java
@@ -55,4 +55,19 @@ public interface QueryResults<V> extends Iterator<V> {
    * }</pre>
    */
   Cursor getCursorAfter();
+
+  /**
+   * Returns the number of results skipped, typically because of an offset.
+   *
+   * <p>A simple use case to count entities:
+   *
+   * <pre>{@code
+   * Query<Key> query = Query.newKeyQueryBuilder().setOffset(Integer.MAX_VALUE).build();
+   * QueryResults<Key> result = datasore.datastore.run(query);
+   * if (!result.hasNext()) {
+   *  int numberOfEntities = result.getSkippedResults();
+   * }
+   * }</pre>
+   */
+  int getSkippedResults();
 }
diff --git a/trunk/google-cloud-clients/google-cloud-datastore/src/main/java/com/google/cloud/datastore/QueryResultsImpl.java b/trunk/google-cloud-clients/google-cloud-datastore/src/main/java/com/google/cloud/datastore/QueryResultsImpl.java
@@ -114,4 +114,9 @@ public Class<?> getResultClass() {
   public Cursor getCursorAfter() {
     return new Cursor(cursor);
   }
+
+  @Override
+  public int getSkippedResults() {
+    return runQueryResponsePb.getBatch().getSkippedResults();
+  }
 }
diff --git a/trunk/google-cloud-clients/google-cloud-datastore/src/test/java/com/google/cloud/datastore/DatastoreTest.java b/trunk/google-cloud-clients/google-cloud-datastore/src/test/java/com/google/cloud/datastore/DatastoreTest.java
@@ -633,6 +633,13 @@ public void testQueryPaginationWithLimit() throws DatastoreException {
     EasyMock.verify(rpcFactoryMock, rpcMock);
   }
 
+  @Test
+  public void testRunKeyQueryWithOffset() {
+    Query<Key> query = Query.newKeyQueryBuilder().setOffset(Integer.MAX_VALUE).build();
+    int numberOfEntities = datastore.run(query).getSkippedResults();
+    assertEquals(2, numberOfEntities);
+  }
+
   private List<RunQueryResponse> buildResponsesForQueryPaginationWithLimit() {
     Entity entity4 = Entity.newBuilder(KEY4).set("value", StringValue.of("value")).build();
     Entity entity5 = Entity.newBuilder(KEY5).set("value", "value").build();
diff --git a/trunk/google-cloud-clients/google-cloud-datastore/src/test/java/com/google/cloud/datastore/it/ITDatastoreTest.java b/trunk/google-cloud-clients/google-cloud-datastore/src/test/java/com/google/cloud/datastore/it/ITDatastoreTest.java
@@ -851,4 +851,11 @@ public Integer run(DatastoreReaderWriter transaction) {
       assertEquals(3, ((DatastoreException) expected.getCause()).getCode());
     }
   }
+
+  @Test
+  public void testSkippedResults() {
+    Query<Key> query = Query.newKeyQueryBuilder().setOffset(Integer.MAX_VALUE).build();
+    int numberOfEntities = DATASTORE.run(query).getSkippedResults();
+    assertEquals(2, numberOfEntities);
+  }
 }

Original file line number	Diff line number	Diff line change
`@@ -114,4 +114,9 @@ public Class<?> getResultClass() {`
`114`	`114`	`public Cursor getCursorAfter() {`
`115`	`115`	`return new Cursor(cursor);`
`116`	`116`	`}`
	`117`	`+`
	`118`	`+ @Override`
	`119`	`+ public int getSkippedResults() {`
	`120`	`+ return runQueryResponsePb.getBatch().getSkippedResults();`
	`121`	`+ }`
`117`	`122`	`}`
Original file line number	Diff line number	Diff line change
`@@ -851,4 +851,11 @@ public Integer run(DatastoreReaderWriter transaction) {`
`851`	`851`	`assertEquals(3, ((DatastoreException) expected.getCause()).getCode());`
`852`	`852`	`}`
`853`	`853`	`}`
	`854`	`+`
	`855`	`+ @Test`
	`856`	`+ public void testSkippedResults() {`
	`857`	`+ Query<Key> query = Query.newKeyQueryBuilder().setOffset(Integer.MAX_VALUE).build();`
	`858`	`+ int numberOfEntities = DATASTORE.run(query).getSkippedResults();`
	`859`	`+ assertEquals(2, numberOfEntities);`
	`860`	`+ }`
`854`	`861`	`}`