From ed7ae3d1e88c4a951f5649ee2c27a80195110e26 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Fri, 19 Feb 2021 14:24:06 -0800 Subject: [PATCH] docs: generate sample code in the Java microgenerator (#25) This PR was generated using Autosynth. :rainbow: Synth log will be available here: https://source.cloud.google.com/results/invocations/451b25a8-87ff-414f-8c57-e8e27a8ff40f/targets - [ ] To automatically regenerate this PR, check this box. PiperOrigin-RevId: 357800868 Source-Link: https://github.com/googleapis/googleapis/commit/e8bc4471a88ac5f60defe3ed436f517174e59ba0 PiperOrigin-RevId: 356341083 Source-Link: https://github.com/googleapis/googleapis/commit/8d8c008e56f1af31d57f75561e0f1848ffb29eeb --- .../v1alpha1/HubServiceClient.java | 595 ++++++++++++++++++ .../v1alpha1/package-info.java | 7 + .../v1alpha1/stub/GrpcHubServiceStub.java | 18 + .../v1alpha1/HubServiceClientTest.java | 10 + .../v1alpha1/MockHubServiceImpl.java | 78 ++- synth.metadata | 4 +- 6 files changed, 700 insertions(+), 12 deletions(-) diff --git a/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/HubServiceClient.java b/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/HubServiceClient.java index 4f0434e7..7153768d 100644 --- a/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/HubServiceClient.java +++ b/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/HubServiceClient.java @@ -49,6 +49,13 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+ *   HubName name = HubName.of("[PROJECT]", "[HUB]");
+ *   Hub response = hubServiceClient.getHub(name);
+ * }
+ * }
+ * *

Note: close() needs to be called on the HubServiceClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -162,6 +169,17 @@ public final OperationsClient getOperationsClient() { /** * Lists Hubs in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+   *   for (Hub element : hubServiceClient.listHubs(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The parent resource's name. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -175,6 +193,17 @@ public final ListHubsPagedResponse listHubs(LocationName parent) { /** * Lists Hubs in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
+   *   for (Hub element : hubServiceClient.listHubs(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The parent resource's name. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -187,6 +216,24 @@ public final ListHubsPagedResponse listHubs(String parent) { /** * Lists Hubs in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   ListHubsRequest request =
+   *       ListHubsRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   for (Hub element : hubServiceClient.listHubs(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -199,6 +246,24 @@ public final ListHubsPagedResponse listHubs(ListHubsRequest request) { * Lists Hubs in a given project and location. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   ListHubsRequest request =
+   *       ListHubsRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   ApiFuture future = hubServiceClient.listHubsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Hub element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listHubsPagedCallable() { return stub.listHubsPagedCallable(); @@ -209,6 +274,23 @@ public final UnaryCallable listHubsPaged * Lists Hubs in a given project and location. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   while (true) {
+   *     ListHubsResponse response = hubServiceClient.listHubsCallable().call(request);
+   *     for (Hub element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listHubsCallable() { return stub.listHubsCallable(); @@ -218,6 +300,15 @@ public final UnaryCallable listHubsCallable() /** * Gets details of a single Hub. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   HubName name = HubName.of("[PROJECT]", "[HUB]");
+   *   Hub response = hubServiceClient.getHub(name);
+   * }
+   * }
+ * * @param name Required. Name of the Hub resource to get. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -231,6 +322,15 @@ public final Hub getHub(HubName name) { /** * Gets details of a single Hub. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   String name = HubName.of("[PROJECT]", "[HUB]").toString();
+   *   Hub response = hubServiceClient.getHub(name);
+   * }
+   * }
+ * * @param name Required. Name of the Hub resource to get. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -243,6 +343,16 @@ public final Hub getHub(String name) { /** * Gets details of a single Hub. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   GetHubRequest request =
+   *       GetHubRequest.newBuilder().setName(HubName.of("[PROJECT]", "[HUB]").toString()).build();
+   *   Hub response = hubServiceClient.getHub(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -255,6 +365,16 @@ public final Hub getHub(GetHubRequest request) { * Gets details of a single Hub. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   GetHubRequest request =
+   *       GetHubRequest.newBuilder().setName(HubName.of("[PROJECT]", "[HUB]").toString()).build();
+   *   ApiFuture future = hubServiceClient.getHubCallable().futureCall(request);
+   *   // Do something.
+   *   Hub response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getHubCallable() { return stub.getHubCallable(); @@ -264,6 +384,17 @@ public final UnaryCallable getHubCallable() { /** * Creates a new Hub in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+   *   Hub hub = Hub.newBuilder().build();
+   *   String hubId = "hubId99628272";
+   *   Hub response = hubServiceClient.createHubAsync(parent, hub, hubId).get();
+   * }
+   * }
+ * * @param parent Required. The parent resource's name of the Hub. * @param hub Required. Initial values for a new Hub. * @param hubId Optional. Unique id for the Hub to create. @@ -284,6 +415,17 @@ public final OperationFuture createHubAsync( /** * Creates a new Hub in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
+   *   Hub hub = Hub.newBuilder().build();
+   *   String hubId = "hubId99628272";
+   *   Hub response = hubServiceClient.createHubAsync(parent, hub, hubId).get();
+   * }
+   * }
+ * * @param parent Required. The parent resource's name of the Hub. * @param hub Required. Initial values for a new Hub. * @param hubId Optional. Unique id for the Hub to create. @@ -300,6 +442,21 @@ public final OperationFuture createHubAsync( /** * Creates a new Hub in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   CreateHubRequest request =
+   *       CreateHubRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setHubId("hubId99628272")
+   *           .setHub(Hub.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   Hub response = hubServiceClient.createHubAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -312,6 +469,22 @@ public final OperationFuture createHubAsync(CreateHubReq * Creates a new Hub in a given project and location. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   CreateHubRequest request =
+   *       CreateHubRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setHubId("hubId99628272")
+   *           .setHub(Hub.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       hubServiceClient.createHubOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Hub response = future.get();
+   * }
+   * }
*/ public final OperationCallable createHubOperationCallable() { @@ -323,6 +496,21 @@ public final OperationFuture createHubAsync(CreateHubReq * Creates a new Hub in a given project and location. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   CreateHubRequest request =
+   *       CreateHubRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setHubId("hubId99628272")
+   *           .setHub(Hub.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future = hubServiceClient.createHubCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createHubCallable() { return stub.createHubCallable(); @@ -332,6 +520,16 @@ public final UnaryCallable createHubCallable() { /** * Updates the parameters of a single Hub. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   Hub hub = Hub.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   Hub response = hubServiceClient.updateHubAsync(hub, updateMask).get();
+   * }
+   * }
+ * * @param hub Required. The state that the Hub should be in after the update. * @param updateMask Optional. Field mask is used to specify the fields to be overwritten in the * Hub resource by the update. The fields specified in the update_mask are relative to the @@ -350,6 +548,20 @@ public final OperationFuture updateHubAsync( /** * Updates the parameters of a single Hub. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   UpdateHubRequest request =
+   *       UpdateHubRequest.newBuilder()
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setHub(Hub.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   Hub response = hubServiceClient.updateHubAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -362,6 +574,21 @@ public final OperationFuture updateHubAsync(UpdateHubReq * Updates the parameters of a single Hub. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   UpdateHubRequest request =
+   *       UpdateHubRequest.newBuilder()
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setHub(Hub.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       hubServiceClient.updateHubOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Hub response = future.get();
+   * }
+   * }
*/ public final OperationCallable updateHubOperationCallable() { @@ -373,6 +600,20 @@ public final OperationFuture updateHubAsync(UpdateHubReq * Updates the parameters of a single Hub. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   UpdateHubRequest request =
+   *       UpdateHubRequest.newBuilder()
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setHub(Hub.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future = hubServiceClient.updateHubCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateHubCallable() { return stub.updateHubCallable(); @@ -382,6 +623,15 @@ public final UnaryCallable updateHubCallable() { /** * Deletes a single Hub. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   HubName name = HubName.of("[PROJECT]", "[HUB]");
+   *   hubServiceClient.deleteHubAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The name of the Hub to delete. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -395,6 +645,15 @@ public final OperationFuture deleteHubAsync(HubName na /** * Deletes a single Hub. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   String name = HubName.of("[PROJECT]", "[HUB]").toString();
+   *   hubServiceClient.deleteHubAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The name of the Hub to delete. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -407,6 +666,19 @@ public final OperationFuture deleteHubAsync(String nam /** * Deletes a single Hub. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   DeleteHubRequest request =
+   *       DeleteHubRequest.newBuilder()
+   *           .setName(HubName.of("[PROJECT]", "[HUB]").toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   hubServiceClient.deleteHubAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -419,6 +691,20 @@ public final OperationFuture deleteHubAsync(DeleteHubR * Deletes a single Hub. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   DeleteHubRequest request =
+   *       DeleteHubRequest.newBuilder()
+   *           .setName(HubName.of("[PROJECT]", "[HUB]").toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       hubServiceClient.deleteHubOperationCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final OperationCallable deleteHubOperationCallable() { @@ -430,6 +716,19 @@ public final OperationFuture deleteHubAsync(DeleteHubR * Deletes a single Hub. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   DeleteHubRequest request =
+   *       DeleteHubRequest.newBuilder()
+   *           .setName(HubName.of("[PROJECT]", "[HUB]").toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future = hubServiceClient.deleteHubCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteHubCallable() { return stub.deleteHubCallable(); @@ -439,6 +738,17 @@ public final UnaryCallable deleteHubCallable() { /** * Lists Spokes in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+   *   for (Spoke element : hubServiceClient.listSpokes(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The parent's resource name. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -452,6 +762,17 @@ public final ListSpokesPagedResponse listSpokes(LocationName parent) { /** * Lists Spokes in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
+   *   for (Spoke element : hubServiceClient.listSpokes(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The parent's resource name. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -464,6 +785,24 @@ public final ListSpokesPagedResponse listSpokes(String parent) { /** * Lists Spokes in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   ListSpokesRequest request =
+   *       ListSpokesRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   for (Spoke element : hubServiceClient.listSpokes(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -476,6 +815,24 @@ public final ListSpokesPagedResponse listSpokes(ListSpokesRequest request) { * Lists Spokes in a given project and location. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   ListSpokesRequest request =
+   *       ListSpokesRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .build();
+   *   ApiFuture future = hubServiceClient.listSpokesPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Spoke element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listSpokesPagedCallable() { return stub.listSpokesPagedCallable(); @@ -486,6 +843,23 @@ public final UnaryCallable listSpoke * Lists Spokes in a given project and location. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   while (true) {
+   *     ListSpokesResponse response = hubServiceClient.listSpokesCallable().call(request);
+   *     for (Spoke element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listSpokesCallable() { return stub.listSpokesCallable(); @@ -495,6 +869,15 @@ public final UnaryCallable listSpokesCall /** * Gets details of a single Spoke. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   SpokeName name = SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]");
+   *   Spoke response = hubServiceClient.getSpoke(name);
+   * }
+   * }
+ * * @param name Required. The name of Spoke resource. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -508,6 +891,15 @@ public final Spoke getSpoke(SpokeName name) { /** * Gets details of a single Spoke. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   String name = SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString();
+   *   Spoke response = hubServiceClient.getSpoke(name);
+   * }
+   * }
+ * * @param name Required. The name of Spoke resource. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -520,6 +912,18 @@ public final Spoke getSpoke(String name) { /** * Gets details of a single Spoke. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   GetSpokeRequest request =
+   *       GetSpokeRequest.newBuilder()
+   *           .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString())
+   *           .build();
+   *   Spoke response = hubServiceClient.getSpoke(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -532,6 +936,18 @@ public final Spoke getSpoke(GetSpokeRequest request) { * Gets details of a single Spoke. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   GetSpokeRequest request =
+   *       GetSpokeRequest.newBuilder()
+   *           .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString())
+   *           .build();
+   *   ApiFuture future = hubServiceClient.getSpokeCallable().futureCall(request);
+   *   // Do something.
+   *   Spoke response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getSpokeCallable() { return stub.getSpokeCallable(); @@ -541,6 +957,17 @@ public final UnaryCallable getSpokeCallable() { /** * Creates a new Spoke in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
+   *   Spoke spoke = Spoke.newBuilder().build();
+   *   String spokeId = "spokeId-1998996281";
+   *   Spoke response = hubServiceClient.createSpokeAsync(parent, spoke, spokeId).get();
+   * }
+   * }
+ * * @param parent Required. The parent's resource name of the Spoke. * @param spoke Required. Initial values for a new Hub. * @param spokeId Optional. Unique id for the Spoke to create. @@ -561,6 +988,17 @@ public final OperationFuture createSpokeAsync( /** * Creates a new Spoke in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
+   *   Spoke spoke = Spoke.newBuilder().build();
+   *   String spokeId = "spokeId-1998996281";
+   *   Spoke response = hubServiceClient.createSpokeAsync(parent, spoke, spokeId).get();
+   * }
+   * }
+ * * @param parent Required. The parent's resource name of the Spoke. * @param spoke Required. Initial values for a new Hub. * @param spokeId Optional. Unique id for the Spoke to create. @@ -581,6 +1019,21 @@ public final OperationFuture createSpokeAsync( /** * Creates a new Spoke in a given project and location. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   CreateSpokeRequest request =
+   *       CreateSpokeRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setSpokeId("spokeId-1998996281")
+   *           .setSpoke(Spoke.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   Spoke response = hubServiceClient.createSpokeAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -594,6 +1047,22 @@ public final OperationFuture createSpokeAsync( * Creates a new Spoke in a given project and location. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   CreateSpokeRequest request =
+   *       CreateSpokeRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setSpokeId("spokeId-1998996281")
+   *           .setSpoke(Spoke.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       hubServiceClient.createSpokeOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Spoke response = future.get();
+   * }
+   * }
*/ public final OperationCallable createSpokeOperationCallable() { @@ -605,6 +1074,21 @@ public final OperationFuture createSpokeAsync( * Creates a new Spoke in a given project and location. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   CreateSpokeRequest request =
+   *       CreateSpokeRequest.newBuilder()
+   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
+   *           .setSpokeId("spokeId-1998996281")
+   *           .setSpoke(Spoke.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future = hubServiceClient.createSpokeCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createSpokeCallable() { return stub.createSpokeCallable(); @@ -614,6 +1098,16 @@ public final UnaryCallable createSpokeCallable() /** * Updates the parameters of a single Spoke. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   Spoke spoke = Spoke.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   Spoke response = hubServiceClient.updateSpokeAsync(spoke, updateMask).get();
+   * }
+   * }
+ * * @param spoke Required. The state that the Spoke should be in after the update. * @param updateMask Optional. Field mask is used to specify the fields to be overwritten in the * Spoke resource by the update. The fields specified in the update_mask are relative to the @@ -632,6 +1126,20 @@ public final OperationFuture updateSpokeAsync( /** * Updates the parameters of a single Spoke. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   UpdateSpokeRequest request =
+   *       UpdateSpokeRequest.newBuilder()
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setSpoke(Spoke.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   Spoke response = hubServiceClient.updateSpokeAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -645,6 +1153,21 @@ public final OperationFuture updateSpokeAsync( * Updates the parameters of a single Spoke. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   UpdateSpokeRequest request =
+   *       UpdateSpokeRequest.newBuilder()
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setSpoke(Spoke.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       hubServiceClient.updateSpokeOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Spoke response = future.get();
+   * }
+   * }
*/ public final OperationCallable updateSpokeOperationCallable() { @@ -656,6 +1179,20 @@ public final OperationFuture updateSpokeAsync( * Updates the parameters of a single Spoke. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   UpdateSpokeRequest request =
+   *       UpdateSpokeRequest.newBuilder()
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .setSpoke(Spoke.newBuilder().build())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future = hubServiceClient.updateSpokeCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateSpokeCallable() { return stub.updateSpokeCallable(); @@ -665,6 +1202,15 @@ public final UnaryCallable updateSpokeCallable() /** * Deletes a single Spoke. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   SpokeName name = SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]");
+   *   hubServiceClient.deleteSpokeAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The name of the Spoke to delete. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -678,6 +1224,15 @@ public final OperationFuture deleteSpokeAsync(SpokeNam /** * Deletes a single Spoke. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   String name = SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString();
+   *   hubServiceClient.deleteSpokeAsync(name).get();
+   * }
+   * }
+ * * @param name Required. The name of the Spoke to delete. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -690,6 +1245,19 @@ public final OperationFuture deleteSpokeAsync(String n /** * Deletes a single Spoke. * + *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   DeleteSpokeRequest request =
+   *       DeleteSpokeRequest.newBuilder()
+   *           .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   hubServiceClient.deleteSpokeAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -703,6 +1271,20 @@ public final OperationFuture deleteSpokeAsync( * Deletes a single Spoke. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   DeleteSpokeRequest request =
+   *       DeleteSpokeRequest.newBuilder()
+   *           .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   OperationFuture future =
+   *       hubServiceClient.deleteSpokeOperationCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final OperationCallable deleteSpokeOperationCallable() { @@ -714,6 +1296,19 @@ public final OperationFuture deleteSpokeAsync( * Deletes a single Spoke. * *

Sample code: + * + *

{@code
+   * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+   *   DeleteSpokeRequest request =
+   *       DeleteSpokeRequest.newBuilder()
+   *           .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString())
+   *           .setRequestId("requestId693933066")
+   *           .build();
+   *   ApiFuture future = hubServiceClient.deleteSpokeCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteSpokeCallable() { return stub.deleteSpokeCallable(); diff --git a/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/package-info.java b/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/package-info.java index 3e65abe4..950b88b8 100644 --- a/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/package-info.java +++ b/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/package-info.java @@ -24,6 +24,13 @@ * centralized connectivity management model. * *

Sample for HubServiceClient: + * + *

{@code
+ * try (HubServiceClient hubServiceClient = HubServiceClient.create()) {
+ *   HubName name = HubName.of("[PROJECT]", "[HUB]");
+ *   Hub response = hubServiceClient.getHub(name);
+ * }
+ * }
*/ @Generated("by gapic-generator-java") package com.google.cloud.networkconnectivity.v1alpha1; diff --git a/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/stub/GrpcHubServiceStub.java b/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/stub/GrpcHubServiceStub.java index ab4f2082..add90a91 100644 --- a/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/stub/GrpcHubServiceStub.java +++ b/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1alpha1/stub/GrpcHubServiceStub.java @@ -424,77 +424,95 @@ public GrpcOperationsStub getOperationsStub() { return operationsStub; } + @Override public UnaryCallable listHubsCallable() { return listHubsCallable; } + @Override public UnaryCallable listHubsPagedCallable() { return listHubsPagedCallable; } + @Override public UnaryCallable getHubCallable() { return getHubCallable; } + @Override public UnaryCallable createHubCallable() { return createHubCallable; } + @Override public OperationCallable createHubOperationCallable() { return createHubOperationCallable; } + @Override public UnaryCallable updateHubCallable() { return updateHubCallable; } + @Override public OperationCallable updateHubOperationCallable() { return updateHubOperationCallable; } + @Override public UnaryCallable deleteHubCallable() { return deleteHubCallable; } + @Override public OperationCallable deleteHubOperationCallable() { return deleteHubOperationCallable; } + @Override public UnaryCallable listSpokesCallable() { return listSpokesCallable; } + @Override public UnaryCallable listSpokesPagedCallable() { return listSpokesPagedCallable; } + @Override public UnaryCallable getSpokeCallable() { return getSpokeCallable; } + @Override public UnaryCallable createSpokeCallable() { return createSpokeCallable; } + @Override public OperationCallable createSpokeOperationCallable() { return createSpokeOperationCallable; } + @Override public UnaryCallable updateSpokeCallable() { return updateSpokeCallable; } + @Override public OperationCallable updateSpokeOperationCallable() { return updateSpokeOperationCallable; } + @Override public UnaryCallable deleteSpokeCallable() { return deleteSpokeCallable; } + @Override public OperationCallable deleteSpokeOperationCallable() { return deleteSpokeOperationCallable; diff --git a/google-cloud-networkconnectivity/src/test/java/com/google/cloud/networkconnectivity/v1alpha1/HubServiceClientTest.java b/google-cloud-networkconnectivity/src/test/java/com/google/cloud/networkconnectivity/v1alpha1/HubServiceClientTest.java index 9eb2f6c7..33ac2e19 100644 --- a/google-cloud-networkconnectivity/src/test/java/com/google/cloud/networkconnectivity/v1alpha1/HubServiceClientTest.java +++ b/google-cloud-networkconnectivity/src/test/java/com/google/cloud/networkconnectivity/v1alpha1/HubServiceClientTest.java @@ -187,6 +187,7 @@ public void getHubTest() throws Exception { .setDescription("description-1724546052") .addAllSpokes(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); mockHubService.addResponse(expectedResponse); @@ -231,6 +232,7 @@ public void getHubTest2() throws Exception { .setDescription("description-1724546052") .addAllSpokes(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); mockHubService.addResponse(expectedResponse); @@ -275,6 +277,7 @@ public void createHubTest() throws Exception { .setDescription("description-1724546052") .addAllSpokes(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); Operation resultOperation = Operation.newBuilder() @@ -333,6 +336,7 @@ public void createHubTest2() throws Exception { .setDescription("description-1724546052") .addAllSpokes(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); Operation resultOperation = Operation.newBuilder() @@ -391,6 +395,7 @@ public void updateHubTest() throws Exception { .setDescription("description-1724546052") .addAllSpokes(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); Operation resultOperation = Operation.newBuilder() @@ -621,6 +626,7 @@ public void getSpokeTest() throws Exception { .addAllLinkedInterconnectAttachments(new ArrayList()) .addAllLinkedRouterApplianceInstances(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); mockHubService.addResponse(expectedResponse); @@ -668,6 +674,7 @@ public void getSpokeTest2() throws Exception { .addAllLinkedInterconnectAttachments(new ArrayList()) .addAllLinkedRouterApplianceInstances(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); mockHubService.addResponse(expectedResponse); @@ -715,6 +722,7 @@ public void createSpokeTest() throws Exception { .addAllLinkedInterconnectAttachments(new ArrayList()) .addAllLinkedRouterApplianceInstances(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); Operation resultOperation = Operation.newBuilder() @@ -776,6 +784,7 @@ public void createSpokeTest2() throws Exception { .addAllLinkedInterconnectAttachments(new ArrayList()) .addAllLinkedRouterApplianceInstances(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); Operation resultOperation = Operation.newBuilder() @@ -837,6 +846,7 @@ public void updateSpokeTest() throws Exception { .addAllLinkedInterconnectAttachments(new ArrayList()) .addAllLinkedRouterApplianceInstances(new ArrayList()) .setUniqueId("uniqueId-294460212") + .setState(State.forNumber(0)) .build(); Operation resultOperation = Operation.newBuilder() diff --git a/google-cloud-networkconnectivity/src/test/java/com/google/cloud/networkconnectivity/v1alpha1/MockHubServiceImpl.java b/google-cloud-networkconnectivity/src/test/java/com/google/cloud/networkconnectivity/v1alpha1/MockHubServiceImpl.java index b7ea91d5..b51d3cb5 100644 --- a/google-cloud-networkconnectivity/src/test/java/com/google/cloud/networkconnectivity/v1alpha1/MockHubServiceImpl.java +++ b/google-cloud-networkconnectivity/src/test/java/com/google/cloud/networkconnectivity/v1alpha1/MockHubServiceImpl.java @@ -69,7 +69,13 @@ public void listHubs(ListHubsRequest request, StreamObserver r } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method ListHubs, expected %s or %s", + response.getClass().getName(), + ListHubsResponse.class.getName(), + Exception.class.getName()))); } } @@ -83,7 +89,11 @@ public void getHub(GetHubRequest request, StreamObserver responseObserver) } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method GetHub, expected %s or %s", + response.getClass().getName(), Hub.class.getName(), Exception.class.getName()))); } } @@ -97,7 +107,13 @@ public void createHub(CreateHubRequest request, StreamObserver respon } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method CreateHub, expected %s or %s", + response.getClass().getName(), + Operation.class.getName(), + Exception.class.getName()))); } } @@ -111,7 +127,13 @@ public void updateHub(UpdateHubRequest request, StreamObserver respon } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method UpdateHub, expected %s or %s", + response.getClass().getName(), + Operation.class.getName(), + Exception.class.getName()))); } } @@ -125,7 +147,13 @@ public void deleteHub(DeleteHubRequest request, StreamObserver respon } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method DeleteHub, expected %s or %s", + response.getClass().getName(), + Operation.class.getName(), + Exception.class.getName()))); } } @@ -140,7 +168,13 @@ public void listSpokes( } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method ListSpokes, expected %s or %s", + response.getClass().getName(), + ListSpokesResponse.class.getName(), + Exception.class.getName()))); } } @@ -154,7 +188,13 @@ public void getSpoke(GetSpokeRequest request, StreamObserver responseObse } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method GetSpoke, expected %s or %s", + response.getClass().getName(), + Spoke.class.getName(), + Exception.class.getName()))); } } @@ -168,7 +208,13 @@ public void createSpoke(CreateSpokeRequest request, StreamObserver re } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method CreateSpoke, expected %s or %s", + response.getClass().getName(), + Operation.class.getName(), + Exception.class.getName()))); } } @@ -182,7 +228,13 @@ public void updateSpoke(UpdateSpokeRequest request, StreamObserver re } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method UpdateSpoke, expected %s or %s", + response.getClass().getName(), + Operation.class.getName(), + Exception.class.getName()))); } } @@ -196,7 +248,13 @@ public void deleteSpoke(DeleteSpokeRequest request, StreamObserver re } else if (response instanceof Exception) { responseObserver.onError(((Exception) response)); } else { - responseObserver.onError(new IllegalArgumentException("Unrecognized response type")); + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method DeleteSpoke, expected %s or %s", + response.getClass().getName(), + Operation.class.getName(), + Exception.class.getName()))); } } } diff --git a/synth.metadata b/synth.metadata index fe3dca93..52a8b391 100644 --- a/synth.metadata +++ b/synth.metadata @@ -11,8 +11,8 @@ "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "5e27c5cafe0952f50ff81552526b3e3d333ef2c3", - "internalRef": "355488930" + "sha": "e8bc4471a88ac5f60defe3ed436f517174e59ba0", + "internalRef": "357800868" } }, {