Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add better javadoc and snippets for Datastore and Transaction #1355

Merged
merged 1 commit into from
Nov 2, 2016

Conversation

mziccard
Copy link
Contributor

This PR does the following:

  • Add better javadoc for put and add in Datastore, Batch and Transaction
  • Add snippets for Transaction's put, add, update, delete, addWithDeferredIdAllocation and putWithDeferredIdAllocation
  • Add snippets for Datastore's add
  • Add integration tests for all new snippets

Fixes #1339

@unitydynamics feel free to comment :)

/cc @lesv

@mziccard mziccard added the api: datastore Issues related to the Datastore API. label Oct 31, 2016
@googlebot googlebot added the cla: yes This human has signed the Contributor License Agreement. label Oct 31, 2016
@coveralls
Copy link

Coverage Status

Coverage remained the same at 83.9% when pulling 14ebbf9 on mziccard:datastore-better-docs into e7063d4 on GoogleCloudPlatform:master.

* For entities with complete keys that were marked for deletion in this writer the operation
* will be changed to {@link #put}.
*
* @throws DatastoreException if a given entity with the same complete key was already added to
* this writer, if writer is not active or if id allocation for an entity with an incomplete
* key failed.
* key failed

This comment was marked as spam.

This comment was marked as spam.

This comment was marked as spam.

@@ -176,6 +176,205 @@
<T> QueryResults<T> run(Query<T> query);

/**
* Datastore add operation. This method will also allocate id for any entity with an incomplete
* key. As opposed to {@link #add(FullEntity)} and {@link #add(FullEntity...)}, this method will
* defer any necessary id allocation to commit time.

This comment was marked as spam.

This comment was marked as spam.

This comment was marked as spam.

@mziccard mziccard merged commit b74284e into googleapis:master Nov 2, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
api: datastore Issues related to the Datastore API. cla: yes This human has signed the Contributor License Agreement.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants