google-cloud-datastore
diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Batch.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Batch.java
index eb4abd854..882a4db25 100644
--- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Batch.java
+++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Batch.java
@@ -53,9 +53,13 @@ interface Response {
/**
* {@inheritDoc}
*
- * If an entity for {@code entity.getKey()} does not exists, {@code entity} is inserted.
+ *
If an entity for {@code entity.getKey()} does not exist, {@code entity} is inserted.
* Otherwise, {@link #submit()} will throw a {@link DatastoreException} with {@link
* DatastoreException#getReason()} equal to {@code "ALREADY_EXISTS"}.
+ *
+ * @param entity the entity to be added to the datastore
+ * @return The entity that was added
+ * @throws DatastoreException if there was any failure
*/
@Override
Entity add(FullEntity> entity);
@@ -67,6 +71,10 @@ interface Response {
* exists, {@link #submit()} will throw a {@link DatastoreException} with {@link
* DatastoreException#getReason()} equal to {@code "ALREADY_EXISTS"}. All entities in {@code
* entities} whose key did not exist are inserted.
+ *
+ * @param entities entities to be added to the datastore
+ * @return A list of entities that have been added
+ * @throws DatastoreException if there was any failure
*/
@Override
List add(FullEntity>... entities);
@@ -74,10 +82,15 @@ interface Response {
/**
* Submit the batch to the Datastore.
*
- * @throws DatastoreException if there was any failure or if batch is not longer active
+ * @return Response of the batch submit operation.
+ * @throws DatastoreException if there was any failure or if batch is no longer active
*/
Response submit();
- /** Returns the batch associated {@link Datastore}. */
+ /**
+ * Returns the batch associated {@link Datastore}.
+ *
+ * @return The batch associated datastore
+ */
Datastore getDatastore();
}
diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Datastore.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Datastore.java
index 5bd8384a3..45cecbf25 100644
--- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Datastore.java
+++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Datastore.java
@@ -51,6 +51,13 @@ public interface Datastore extends Service, DatastoreReaderWri
* @param the type of the return value
*/
interface TransactionCallable {
+ /**
+ * Callback's invoke method for the TransactionCallable.
+ *
+ * @param readerWriter DatastoreReaderWriter associated with the new transaction
+ * @return T The transaction result
+ * @throws Exception upon failure
+ */
T run(DatastoreReaderWriter readerWriter) throws Exception;
}
diff --git a/grpc-google-cloud-datastore-admin-v1/pom.xml b/grpc-google-cloud-datastore-admin-v1/pom.xml
index ebe1b66cd..cfd79c52d 100644
--- a/grpc-google-cloud-datastore-admin-v1/pom.xml
+++ b/grpc-google-cloud-datastore-admin-v1/pom.xml
@@ -4,13 +4,13 @@
4.0.0
com.google.api.grpc
grpc-google-cloud-datastore-admin-v1
- 2.24.1
+ 2.24.2
grpc-google-cloud-datastore-admin-v1
GRPC library for google-cloud-datastore
com.google.cloud
google-cloud-datastore-parent
- 2.24.1
+ 2.24.2
diff --git a/pom.xml b/pom.xml
index b4211aa32..e3c138615 100644
--- a/pom.xml
+++ b/pom.xml
@@ -4,7 +4,7 @@
com.google.cloud
google-cloud-datastore-parent
pom
- 2.24.1
+ 2.24.2
Google Cloud Datastore Parent
https://github.com/googleapis/java-datastore
@@ -159,27 +159,27 @@
com.google.api.grpc
proto-google-cloud-datastore-admin-v1
- 2.24.1
+ 2.24.2
com.google.api.grpc
grpc-google-cloud-datastore-admin-v1
- 2.24.1
+ 2.24.2
com.google.cloud
google-cloud-datastore
- 2.24.1
+ 2.24.2
com.google.api.grpc
proto-google-cloud-datastore-v1
- 0.115.1
+ 0.115.2
com.google.cloud.datastore
datastore-v1-proto-client
- 2.24.1
+ 2.24.2
com.google.api.grpc
diff --git a/proto-google-cloud-datastore-admin-v1/pom.xml b/proto-google-cloud-datastore-admin-v1/pom.xml
index 1c19e4ab3..02befd0a5 100644
--- a/proto-google-cloud-datastore-admin-v1/pom.xml
+++ b/proto-google-cloud-datastore-admin-v1/pom.xml
@@ -4,13 +4,13 @@
4.0.0
com.google.api.grpc
proto-google-cloud-datastore-admin-v1
- 2.24.1
+ 2.24.2
proto-google-cloud-datastore-admin-v1
Proto library for google-cloud-datastore
com.google.cloud
google-cloud-datastore-parent
- 2.24.1
+ 2.24.2
diff --git a/proto-google-cloud-datastore-v1/pom.xml b/proto-google-cloud-datastore-v1/pom.xml
index f8d1b8c04..47bbefce7 100644
--- a/proto-google-cloud-datastore-v1/pom.xml
+++ b/proto-google-cloud-datastore-v1/pom.xml
@@ -4,13 +4,13 @@
4.0.0
com.google.api.grpc
proto-google-cloud-datastore-v1
- 0.115.1
+ 0.115.2
proto-google-cloud-datastore-v1
PROTO library for proto-google-cloud-datastore-v1
com.google.cloud
google-cloud-datastore-parent
- 2.24.1
+ 2.24.2
diff --git a/samples/install-without-bom/pom.xml b/samples/install-without-bom/pom.xml
index c39bbf20b..30cba8255 100644
--- a/samples/install-without-bom/pom.xml
+++ b/samples/install-without-bom/pom.xml
@@ -29,7 +29,7 @@
com.google.cloud
google-cloud-datastore
- 2.22.0
+ 2.24.1
diff --git a/samples/snapshot/pom.xml b/samples/snapshot/pom.xml
index 46881f45b..3e017bbe2 100644
--- a/samples/snapshot/pom.xml
+++ b/samples/snapshot/pom.xml
@@ -28,7 +28,7 @@
com.google.cloud
google-cloud-datastore
- 2.24.1
+ 2.24.2
diff --git a/samples/snippets/pom.xml b/samples/snippets/pom.xml
index 677692680..d31d40cb9 100644
--- a/samples/snippets/pom.xml
+++ b/samples/snippets/pom.xml
@@ -30,7 +30,7 @@
com.google.cloud
libraries-bom
- 26.47.0
+ 26.50.0
pom
import
diff --git a/versions.txt b/versions.txt
index 6939d61e9..5a01f70c6 100644
--- a/versions.txt
+++ b/versions.txt
@@ -1,9 +1,9 @@
# Format:
# module:released-version:current-version
-google-cloud-datastore:2.24.1:2.24.1
-google-cloud-datastore-bom:2.24.1:2.24.1
-proto-google-cloud-datastore-v1:0.115.1:0.115.1
-datastore-v1-proto-client:2.24.1:2.24.1
-proto-google-cloud-datastore-admin-v1:2.24.1:2.24.1
-grpc-google-cloud-datastore-admin-v1:2.24.1:2.24.1
+google-cloud-datastore:2.24.2:2.24.2
+google-cloud-datastore-bom:2.24.2:2.24.2
+proto-google-cloud-datastore-v1:0.115.2:0.115.2
+datastore-v1-proto-client:2.24.2:2.24.2
+proto-google-cloud-datastore-admin-v1:2.24.2:2.24.2
+grpc-google-cloud-datastore-admin-v1:2.24.2:2.24.2