Skip to content

Commit

Permalink
chore: enable gapicv2 for firestore/v1 API
Browse files Browse the repository at this point in the history 
Note that this contains breaking Java changes:
  com.google.cloud.firestore.v1.FirestoreClient: Method 'public void deleteDocument(com.google.firestore.v1.AnyPathName)' has been removed

Committer: @miraleung
PiperOrigin-RevId: 305561906

Source-Author: Google APIs <noreply@google.com>
Source-Date: Wed Apr 8 15:01:42 2020 -0700
Source-Repo: googleapis/googleapis
Source-Sha: d741cd976975c745d0199987aff0e908b8352992
Source-Link: googleapis/googleapis@d741cd9
  • Loading branch information
@yoshi-automation
yoshi-automation committed Apr 16, 2020
1 parent 44ccfbd commit d14d7a1
Show file tree
Hide file tree
Showing 4 changed files with 111 additions and 180 deletions.
144 changes: 53 additions & 91 deletions google-cloud-firestore/src/main/java/com/google/cloud/firestore/v1/FirestoreClient.java
View file
Expand Up @@ -30,7 +30,6 @@
import com.google.cloud.firestore.v1.stub.FirestoreStub;
import com.google.cloud.firestore.v1.stub.FirestoreStubSettings;
import com.google.common.util.concurrent.MoreExecutors;
import com.google.firestore.v1.AnyPathName;
import com.google.firestore.v1.BatchGetDocumentsRequest;
import com.google.firestore.v1.BatchGetDocumentsResponse;
import com.google.firestore.v1.BeginTransactionRequest;
Expand Down Expand Up @@ -194,9 +193,9 @@ public FirestoreStub getStub() {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* AnyPathName name = AnyPathName.of("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String name = "";
* GetDocumentRequest request = GetDocumentRequest.newBuilder()
* .setName(name.toString())
* .setName(name)
* .build();
* Document response = firestoreClient.getDocument(request);
* }
Expand All @@ -217,9 +216,9 @@ public final Document getDocument(GetDocumentRequest request) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* AnyPathName name = AnyPathName.of("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String name = "";
* GetDocumentRequest request = GetDocumentRequest.newBuilder()
* .setName(name.toString())
* .setName(name)
* .build();
* ApiFuture&lt;Document&gt; future = firestoreClient.getDocumentCallable().futureCall(request);
* // Do something
Expand All @@ -239,10 +238,10 @@ public final UnaryCallable<GetDocumentRequest, Document> getDocumentCallable() {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String parent = "";
* String collectionId = "";
* ListDocumentsRequest request = ListDocumentsRequest.newBuilder()
* .setParent(formattedParent)
* .setParent(parent)
* .setCollectionId(collectionId)
* .build();
* for (Document element : firestoreClient.listDocuments(request).iterateAll()) {
Expand All @@ -266,10 +265,10 @@ public final ListDocumentsPagedResponse listDocuments(ListDocumentsRequest reque
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String parent = "";
* String collectionId = "";
* ListDocumentsRequest request = ListDocumentsRequest.newBuilder()
* .setParent(formattedParent)
* .setParent(parent)
* .setCollectionId(collectionId)
* .build();
* ApiFuture&lt;ListDocumentsPagedResponse&gt; future = firestoreClient.listDocumentsPagedCallable().futureCall(request);
Expand All @@ -293,10 +292,10 @@ public final ListDocumentsPagedResponse listDocuments(ListDocumentsRequest reque
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String parent = "";
* String collectionId = "";
* ListDocumentsRequest request = ListDocumentsRequest.newBuilder()
* .setParent(formattedParent)
* .setParent(parent)
* .setCollectionId(collectionId)
* .build();
* while (true) {
Expand Down Expand Up @@ -326,14 +325,12 @@ public final UnaryCallable<ListDocumentsRequest, ListDocumentsResponse> listDocu
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String parent = "";
* String collectionId = "";
* String documentId = "";
* Document document = Document.newBuilder().build();
* CreateDocumentRequest request = CreateDocumentRequest.newBuilder()
* .setParent(formattedParent)
* .setParent(parent)
* .setCollectionId(collectionId)
* .setDocumentId(documentId)
* .setDocument(document)
* .build();
* Document response = firestoreClient.createDocument(request);
Expand All @@ -355,14 +352,12 @@ public final Document createDocument(CreateDocumentRequest request) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String parent = "";
* String collectionId = "";
* String documentId = "";
* Document document = Document.newBuilder().build();
* CreateDocumentRequest request = CreateDocumentRequest.newBuilder()
* .setParent(formattedParent)
* .setParent(parent)
* .setCollectionId(collectionId)
* .setDocumentId(documentId)
* .setDocument(document)
* .build();
* ApiFuture&lt;Document&gt; future = firestoreClient.createDocumentCallable().futureCall(request);
Expand Down Expand Up @@ -413,10 +408,8 @@ public final Document updateDocument(Document document, DocumentMask updateMask)
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* Document document = Document.newBuilder().build();
* DocumentMask updateMask = DocumentMask.newBuilder().build();
* UpdateDocumentRequest request = UpdateDocumentRequest.newBuilder()
* .setDocument(document)
* .setUpdateMask(updateMask)
* .build();
* Document response = firestoreClient.updateDocument(request);
* }
Expand All @@ -438,10 +431,8 @@ public final Document updateDocument(UpdateDocumentRequest request) {
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* Document document = Document.newBuilder().build();
* DocumentMask updateMask = DocumentMask.newBuilder().build();
* UpdateDocumentRequest request = UpdateDocumentRequest.newBuilder()
* .setDocument(document)
* .setUpdateMask(updateMask)
* .build();
* ApiFuture&lt;Document&gt; future = firestoreClient.updateDocumentCallable().futureCall(request);
* // Do something
Expand All @@ -461,7 +452,7 @@ public final UnaryCallable<UpdateDocumentRequest, Document> updateDocumentCallab
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* AnyPathName name = AnyPathName.of("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String name = "";
* firestoreClient.deleteDocument(name);
* }
* </code></pre>
Expand All @@ -470,29 +461,6 @@ public final UnaryCallable<UpdateDocumentRequest, Document> updateDocumentCallab
* `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final void deleteDocument(AnyPathName name) {
DeleteDocumentRequest request =
DeleteDocumentRequest.newBuilder().setName(name == null ? null : name.toString()).build();
deleteDocument(request);
}

// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Deletes a document.
*
* <p>Sample code:
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* AnyPathName name = AnyPathName.of("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* firestoreClient.deleteDocument(name.toString());
* }
* </code></pre>
*
* @param name Required. The resource name of the Document to delete. In the format:
* `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final void deleteDocument(String name) {
DeleteDocumentRequest request = DeleteDocumentRequest.newBuilder().setName(name).build();
deleteDocument(request);
Expand All @@ -506,9 +474,9 @@ public final void deleteDocument(String name) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* AnyPathName name = AnyPathName.of("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String name = "";
* DeleteDocumentRequest request = DeleteDocumentRequest.newBuilder()
* .setName(name.toString())
* .setName(name)
* .build();
* firestoreClient.deleteDocument(request);
* }
Expand All @@ -529,9 +497,9 @@ public final void deleteDocument(DeleteDocumentRequest request) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* AnyPathName name = AnyPathName.of("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String name = "";
* DeleteDocumentRequest request = DeleteDocumentRequest.newBuilder()
* .setName(name.toString())
* .setName(name)
* .build();
* ApiFuture&lt;Void&gt; future = firestoreClient.deleteDocumentCallable().futureCall(request);
* // Do something
Expand All @@ -554,11 +522,9 @@ public final UnaryCallable<DeleteDocumentRequest, Empty> deleteDocumentCallable(
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* List&lt;String&gt; documents = new ArrayList&lt;&gt;();
* String database = "";
* BatchGetDocumentsRequest request = BatchGetDocumentsRequest.newBuilder()
* .setDatabase(formattedDatabase)
* .addAllDocuments(documents)
* .setDatabase(database)
* .build();
*
* ServerStream&lt;BatchGetDocumentsResponse&gt; stream = firestoreClient.batchGetDocumentsCallable().call(request);
Expand All @@ -581,8 +547,8 @@ public final UnaryCallable<DeleteDocumentRequest, Empty> deleteDocumentCallable(
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* BeginTransactionResponse response = firestoreClient.beginTransaction(formattedDatabase);
* String database = "";
* BeginTransactionResponse response = firestoreClient.beginTransaction(database);
* }
* </code></pre>
*
Expand All @@ -604,9 +570,9 @@ public final BeginTransactionResponse beginTransaction(String database) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* String database = "";
* BeginTransactionRequest request = BeginTransactionRequest.newBuilder()
* .setDatabase(formattedDatabase)
* .setDatabase(database)
* .build();
* BeginTransactionResponse response = firestoreClient.beginTransaction(request);
* }
Expand All @@ -627,9 +593,9 @@ public final BeginTransactionResponse beginTransaction(BeginTransactionRequest r
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* String database = "";
* BeginTransactionRequest request = BeginTransactionRequest.newBuilder()
* .setDatabase(formattedDatabase)
* .setDatabase(database)
* .build();
* ApiFuture&lt;BeginTransactionResponse&gt; future = firestoreClient.beginTransactionCallable().futureCall(request);
* // Do something
Expand All @@ -650,9 +616,9 @@ public final BeginTransactionResponse beginTransaction(BeginTransactionRequest r
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* String database = "";
* List&lt;Write&gt; writes = new ArrayList&lt;&gt;();
* CommitResponse response = firestoreClient.commit(formattedDatabase, writes);
* CommitResponse response = firestoreClient.commit(database, writes);
* }
* </code></pre>
*
Expand All @@ -676,11 +642,9 @@ public final CommitResponse commit(String database, List<Write> writes) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* List&lt;Write&gt; writes = new ArrayList&lt;&gt;();
* String database = "";
* CommitRequest request = CommitRequest.newBuilder()
* .setDatabase(formattedDatabase)
* .addAllWrites(writes)
* .setDatabase(database)
* .build();
* CommitResponse response = firestoreClient.commit(request);
* }
Expand All @@ -701,11 +665,9 @@ public final CommitResponse commit(CommitRequest request) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* List&lt;Write&gt; writes = new ArrayList&lt;&gt;();
* String database = "";
* CommitRequest request = CommitRequest.newBuilder()
* .setDatabase(formattedDatabase)
* .addAllWrites(writes)
* .setDatabase(database)
* .build();
* ApiFuture&lt;CommitResponse&gt; future = firestoreClient.commitCallable().futureCall(request);
* // Do something
Expand All @@ -725,9 +687,9 @@ public final UnaryCallable<CommitRequest, CommitResponse> commitCallable() {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* String database = "";
* ByteString transaction = ByteString.copyFromUtf8("");
* firestoreClient.rollback(formattedDatabase, transaction);
* firestoreClient.rollback(database, transaction);
* }
* </code></pre>
*
Expand All @@ -750,10 +712,10 @@ public final void rollback(String database, ByteString transaction) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* String database = "";
* ByteString transaction = ByteString.copyFromUtf8("");
* RollbackRequest request = RollbackRequest.newBuilder()
* .setDatabase(formattedDatabase)
* .setDatabase(database)
* .setTransaction(transaction)
* .build();
* firestoreClient.rollback(request);
Expand All @@ -775,10 +737,10 @@ public final void rollback(RollbackRequest request) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* String database = "";
* ByteString transaction = ByteString.copyFromUtf8("");
* RollbackRequest request = RollbackRequest.newBuilder()
* .setDatabase(formattedDatabase)
* .setDatabase(database)
* .setTransaction(transaction)
* .build();
* ApiFuture&lt;Void&gt; future = firestoreClient.rollbackCallable().futureCall(request);
Expand All @@ -799,9 +761,9 @@ public final UnaryCallable<RollbackRequest, Empty> rollbackCallable() {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String parent = "";
* RunQueryRequest request = RunQueryRequest.newBuilder()
* .setParent(formattedParent)
* .setParent(parent)
* .build();
*
* ServerStream&lt;RunQueryResponse&gt; stream = firestoreClient.runQueryCallable().call(request);
Expand All @@ -826,9 +788,9 @@ public final ServerStreamingCallable<RunQueryRequest, RunQueryResponse> runQuery
* BidiStream&lt;WriteRequest, WriteResponse&gt; bidiStream =
* firestoreClient.writeCallable().call();
*
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* String database = "";
* WriteRequest request = WriteRequest.newBuilder()
* .setDatabase(formattedDatabase)
* .setDatabase(database)
* .build();
* bidiStream.send(request);
* for (WriteResponse response : bidiStream) {
Expand All @@ -852,9 +814,9 @@ public final BidiStreamingCallable<WriteRequest, WriteResponse> writeCallable()
* BidiStream&lt;ListenRequest, ListenResponse&gt; bidiStream =
* firestoreClient.listenCallable().call();
*
* String formattedDatabase = DatabaseRootName.format("[PROJECT]", "[DATABASE]");
* String database = "";
* ListenRequest request = ListenRequest.newBuilder()
* .setDatabase(formattedDatabase)
* .setDatabase(database)
* .build();
* bidiStream.send(request);
* for (ListenResponse response : bidiStream) {
Expand All @@ -875,8 +837,8 @@ public final BidiStreamingCallable<ListenRequest, ListenResponse> listenCallable
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* for (String element : firestoreClient.listCollectionIds(formattedParent).iterateAll()) {
* String parent = "";
* for (String element : firestoreClient.listCollectionIds(parent).iterateAll()) {
* // doThingsWith(element);
* }
* }
Expand All @@ -901,9 +863,9 @@ public final ListCollectionIdsPagedResponse listCollectionIds(String parent) {
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String parent = "";
* ListCollectionIdsRequest request = ListCollectionIdsRequest.newBuilder()
* .setParent(formattedParent)
* .setParent(parent)
* .build();
* for (String element : firestoreClient.listCollectionIds(request).iterateAll()) {
* // doThingsWith(element);
Expand All @@ -926,9 +888,9 @@ public final ListCollectionIdsPagedResponse listCollectionIds(ListCollectionIdsR
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String parent = "";
* ListCollectionIdsRequest request = ListCollectionIdsRequest.newBuilder()
* .setParent(formattedParent)
* .setParent(parent)
* .build();
* ApiFuture&lt;ListCollectionIdsPagedResponse&gt; future = firestoreClient.listCollectionIdsPagedCallable().futureCall(request);
* // Do something
Expand All @@ -951,9 +913,9 @@ public final ListCollectionIdsPagedResponse listCollectionIds(ListCollectionIdsR
*
* <pre><code>
* try (FirestoreClient firestoreClient = FirestoreClient.create()) {
* String formattedParent = AnyPathName.format("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]");
* String parent = "";
* ListCollectionIdsRequest request = ListCollectionIdsRequest.newBuilder()
* .setParent(formattedParent)
* .setParent(parent)
* .build();
* while (true) {
* ListCollectionIdsResponse response = firestoreClient.listCollectionIdsCallable().call(request);
Expand Down

0 comments on commit d14d7a1

Please sign in to comment.