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(). + * + *
The surface of this class includes several types of Java methods for each of the API's + * methods: + * + *
See the individual methods for example code. + * + *
Many parameters require resource names to be formatted in a particular way. To assist with + * these names, this class includes a format method for each type of name, and additionally a parse + * method to extract the individual identifiers contained within names that are returned. + * + *
This class can be customized by passing in a custom instance of HubServiceSettings to + * create(). For example: + * + *
To customize credentials: + * + *
{@code + * HubServiceSettings hubServiceSettings = + * HubServiceSettings.newBuilder() + * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) + * .build(); + * HubServiceClient hubServiceClient = HubServiceClient.create(hubServiceSettings); + * }+ * + *
To customize the endpoint: + * + *
{@code + * HubServiceSettings hubServiceSettings = + * HubServiceSettings.newBuilder().setEndpoint(myEndpoint).build(); + * HubServiceClient hubServiceClient = HubServiceClient.create(hubServiceSettings); + * }+ * + *
Please refer to the GitHub repository's samples for more quickstart code snippets. + */ +@Generated("by gapic-generator-java") +public class HubServiceClient implements BackgroundResource { + private final HubServiceSettings settings; + private final HubServiceStub stub; + private final OperationsClient operationsClient; + + /** Constructs an instance of HubServiceClient with default settings. */ + public static final HubServiceClient create() throws IOException { + return create(HubServiceSettings.newBuilder().build()); + } + + /** + * Constructs an instance of HubServiceClient, using the given settings. The channels are created + * based on the settings passed in, or defaults for any settings that are not set. + */ + public static final HubServiceClient create(HubServiceSettings settings) throws IOException { + return new HubServiceClient(settings); + } + + /** + * Constructs an instance of HubServiceClient, using the given stub for making calls. This is for + * advanced usage - prefer using create(HubServiceSettings). + */ + @BetaApi("A restructuring of stub classes is planned, so this may break in the future") + public static final HubServiceClient create(HubServiceStub stub) { + return new HubServiceClient(stub); + } + + /** + * Constructs an instance of HubServiceClient, using the given settings. This is protected so that + * it is easy to make a subclass, but otherwise, the static factory methods should be preferred. + */ + protected HubServiceClient(HubServiceSettings settings) throws IOException { + this.settings = settings; + this.stub = ((HubServiceStubSettings) settings.getStubSettings()).createStub(); + this.operationsClient = OperationsClient.create(this.stub.getOperationsStub()); + } + + @BetaApi("A restructuring of stub classes is planned, so this may break in the future") + protected HubServiceClient(HubServiceStub stub) { + this.settings = null; + this.stub = stub; + this.operationsClient = OperationsClient.create(this.stub.getOperationsStub()); + } + + public final HubServiceSettings getSettings() { + return settings; + } + + @BetaApi("A restructuring of stub classes is planned, so this may break in the future") + public HubServiceStub getStub() { + return stub; + } + + /** + * Returns the OperationsClient that can be used to query the status of a long-running operation + * returned by another API method call. + */ + public final OperationsClient getOperationsClient() { + return operationsClient; + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists hubs in a given project. + * + *
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 + */ + public final ListHubsPagedResponse listHubs(LocationName parent) { + ListHubsRequest request = + ListHubsRequest.newBuilder().setParent(parent == null ? null : parent.toString()).build(); + return listHubs(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists hubs in a given project. + * + *
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 + */ + public final ListHubsPagedResponse listHubs(String parent) { + ListHubsRequest request = ListHubsRequest.newBuilder().setParent(parent).build(); + return listHubs(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists hubs in a given project. + * + *
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 + */ + public final ListHubsPagedResponse listHubs(ListHubsRequest request) { + return listHubsPagedCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists hubs in a given project. + * + *
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+ */ + public final UnaryCallablefuture = hubServiceClient.listHubsPagedCallable().futureCall(request); + * // Do something. + * for (Hub element : future.get().iterateAll()) { + * // doThingsWith(element); + * } + * } + * }
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(); + * 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
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * HubName name = HubName.of("[PROJECT]", "[HUB]"); + * Hub response = hubServiceClient.getHub(name); + * } + * }+ * + * @param name Required. The name of the hub resource to get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Hub getHub(HubName name) { + GetHubRequest request = + GetHubRequest.newBuilder().setName(name == null ? null : name.toString()).build(); + return getHub(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Gets details about the specified hub. + * + *
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * String name = HubName.of("[PROJECT]", "[HUB]").toString(); + * Hub response = hubServiceClient.getHub(name); + * } + * }+ * + * @param name Required. The name of the hub resource to get. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Hub getHub(String name) { + GetHubRequest request = GetHubRequest.newBuilder().setName(name).build(); + return getHub(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Gets details about the specified 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 + */ + public final Hub getHub(GetHubRequest request) { + return getHubCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Gets details about the specified hub. + * + *
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * GetHubRequest request = + * GetHubRequest.newBuilder().setName(HubName.of("[PROJECT]", "[HUB]").toString()).build(); + * ApiFuture+ */ + public final UnaryCallablefuture = hubServiceClient.getHubCallable().futureCall(request); + * // Do something. + * Hub response = future.get(); + * } + * }
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. + * @param hub Required. The initial values for a new hub. + * @param hubId Optional. A unique identifier for the hub. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
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. + * @param hub Required. The initial values for a new hub. + * @param hubId Optional. A unique identifier for the hub. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
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 + */ + public final OperationFuture
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+ */ + public final OperationCallablefuture = + * hubServiceClient.createHubOperationCallable().futureCall(request); + * // Do something. + * Hub response = future.get(); + * } + * }
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+ */ + public final UnaryCallablefuture = hubServiceClient.createHubCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
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. In the case of an update to an existing hub, field mask is used to + * specify the fields to be overwritten. The fields specified in the update_mask are relative + * to the resource, not the full request. A field is overwritten if it is in the mask. If the + * user does not provide a mask, then all fields are overwritten. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * UpdateHubRequest request = + * UpdateHubRequest.newBuilder() + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setHub(Hub.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * hubServiceClient.updateHubOperationCallable().futureCall(request); + * // Do something. + * Hub response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * UpdateHubRequest request = + * UpdateHubRequest.newBuilder() + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setHub(Hub.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = hubServiceClient.updateHubCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
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 + */ + public final OperationFuture
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 + */ + public final OperationFuture
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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * DeleteHubRequest request = + * DeleteHubRequest.newBuilder() + * .setName(HubName.of("[PROJECT]", "[HUB]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * hubServiceClient.deleteHubOperationCallable().futureCall(request); + * // Do something. + * future.get(); + * } + * }
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * DeleteHubRequest request = + * DeleteHubRequest.newBuilder() + * .setName(HubName.of("[PROJECT]", "[HUB]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = hubServiceClient.deleteHubCallable().futureCall(request); + * // Do something. + * future.get(); + * } + * }
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 resource. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListSpokesPagedResponse listSpokes(LocationName parent) { + ListSpokesRequest request = + ListSpokesRequest.newBuilder().setParent(parent == null ? null : parent.toString()).build(); + return listSpokes(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists the spokes in the specified 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 resource. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final ListSpokesPagedResponse listSpokes(String parent) { + ListSpokesRequest request = ListSpokesRequest.newBuilder().setParent(parent).build(); + return listSpokes(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists the spokes in the specified 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 + */ + public final ListSpokesPagedResponse listSpokes(ListSpokesRequest request) { + return listSpokesPagedCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Lists the spokes in the specified 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+ */ + public final UnaryCallablefuture = hubServiceClient.listSpokesPagedCallable().futureCall(request); + * // Do something. + * for (Spoke element : future.get().iterateAll()) { + * // doThingsWith(element); + * } + * } + * }
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(); + * 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
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 the spoke resource. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Spoke getSpoke(SpokeName name) { + GetSpokeRequest request = + GetSpokeRequest.newBuilder().setName(name == null ? null : name.toString()).build(); + return getSpoke(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Gets details about the specified 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 the spoke resource. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final Spoke getSpoke(String name) { + GetSpokeRequest request = GetSpokeRequest.newBuilder().setName(name).build(); + return getSpoke(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Gets details about the specified 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 + */ + public final Spoke getSpoke(GetSpokeRequest request) { + return getSpokeCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Gets details about the specified spoke. + * + *
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * GetSpokeRequest request = + * GetSpokeRequest.newBuilder() + * .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString()) + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = hubServiceClient.getSpokeCallable().futureCall(request); + * // Do something. + * Spoke response = future.get(); + * } + * }
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 resource. + * @param spoke Required. The initial values for a new spoke. + * @param spokeId Optional. Unique id for the spoke to create. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
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 resource. + * @param spoke Required. The initial values for a new spoke. + * @param spokeId Optional. Unique id for the spoke to create. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
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 + */ + public final OperationFuture
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+ */ + public final OperationCallablefuture = + * hubServiceClient.createSpokeOperationCallable().futureCall(request); + * // Do something. + * Spoke response = future.get(); + * } + * }
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+ */ + public final UnaryCallablefuture = hubServiceClient.createSpokeCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
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. In the case of an update to an existing spoke, field mask is used + * to specify the fields to be overwritten. The fields specified in the update_mask are + * relative to the resource, not the full request. A field is overwritten if it is in the + * mask. If the user does not provide a mask, then all fields are overwritten. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * UpdateSpokeRequest request = + * UpdateSpokeRequest.newBuilder() + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setSpoke(Spoke.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * hubServiceClient.updateSpokeOperationCallable().futureCall(request); + * // Do something. + * Spoke response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * UpdateSpokeRequest request = + * UpdateSpokeRequest.newBuilder() + * .setUpdateMask(FieldMask.newBuilder().build()) + * .setSpoke(Spoke.newBuilder().build()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = hubServiceClient.updateSpokeCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * SpokeName name = SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]"); + * Spoke response = hubServiceClient.deactivateSpokeAsync(name).get(); + * } + * }+ * + * @param name Required. The name of the spoke to deactivate. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * String name = SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString(); + * Spoke response = hubServiceClient.deactivateSpokeAsync(name).get(); + * } + * }+ * + * @param name Required. The name of the spoke to deactivate. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * DeactivateSpokeRequest request = + * DeactivateSpokeRequest.newBuilder() + * .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * Spoke response = hubServiceClient.deactivateSpokeAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * DeactivateSpokeRequest request = + * DeactivateSpokeRequest.newBuilder() + * .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * hubServiceClient.deactivateSpokeOperationCallable().futureCall(request); + * // Do something. + * Spoke response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * DeactivateSpokeRequest request = + * DeactivateSpokeRequest.newBuilder() + * .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = hubServiceClient.deactivateSpokeCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * SpokeName name = SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]"); + * Spoke response = hubServiceClient.activateSpokeAsync(name).get(); + * } + * }+ * + * @param name Required. The name of the spoke to activate. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * String name = SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString(); + * Spoke response = hubServiceClient.activateSpokeAsync(name).get(); + * } + * }+ * + * @param name Required. The name of the spoke to activate. + * @throws com.google.api.gax.rpc.ApiException if the remote call fails + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * ActivateSpokeRequest request = + * ActivateSpokeRequest.newBuilder() + * .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * Spoke response = hubServiceClient.activateSpokeAsync(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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * ActivateSpokeRequest request = + * ActivateSpokeRequest.newBuilder() + * .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * hubServiceClient.activateSpokeOperationCallable().futureCall(request); + * // Do something. + * Spoke response = future.get(); + * } + * }
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * ActivateSpokeRequest request = + * ActivateSpokeRequest.newBuilder() + * .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = hubServiceClient.activateSpokeCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); + * } + * }
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 + */ + public final OperationFuture
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 + */ + public final OperationFuture
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 + */ + public final OperationFuture
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * DeleteSpokeRequest request = + * DeleteSpokeRequest.newBuilder() + * .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * OperationFuture+ */ + public final OperationCallablefuture = + * hubServiceClient.deleteSpokeOperationCallable().futureCall(request); + * // Do something. + * future.get(); + * } + * }
Sample code: + * + *
{@code + * try (HubServiceClient hubServiceClient = HubServiceClient.create()) { + * DeleteSpokeRequest request = + * DeleteSpokeRequest.newBuilder() + * .setName(SpokeName.of("[PROJECT]", "[LOCATION]", "[SPOKE]").toString()) + * .setRequestId("requestId693933066") + * .build(); + * ApiFuture+ */ + public final UnaryCallablefuture = hubServiceClient.deleteSpokeCallable().futureCall(request); + * // Do something. + * future.get(); + * } + * }
The default instance has everything set to sensible defaults: + * + *
The builder of this class is recursive, so contained classes are themselves builders. When + * build() is called, the tree of builders is called to create the complete settings object. + * + *
For example, to set the total timeout of getHub to 30 seconds: + * + *
{@code + * HubServiceSettings.Builder hubServiceSettingsBuilder = HubServiceSettings.newBuilder(); + * hubServiceSettingsBuilder + * .getHubSettings() + * .setRetrySettings( + * hubServiceSettingsBuilder + * .getHubSettings() + * .getRetrySettings() + * .toBuilder() + * .setTotalTimeout(Duration.ofSeconds(30)) + * .build()); + * HubServiceSettings hubServiceSettings = hubServiceSettingsBuilder.build(); + * }+ */ +@Generated("by gapic-generator-java") +public class HubServiceSettings extends ClientSettings
Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction ======================= HubServiceClient =======================
+ *
+ * Service Description: Network Connectivity Center is a hub-and-spoke abstraction for network
+ * connectivity management in Google Cloud. It reduces operational complexity through a simple,
+ * centralized connectivity management model.
+ *
+ * Sample for HubServiceClient:
+ *
+ * This class is for advanced usage.
+ */
+@Generated("by gapic-generator-java")
+public class GrpcHubServiceCallableFactory implements GrpcStubCallableFactory {
+
+ @Override
+ public This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public class GrpcHubServiceStub extends HubServiceStub {
+ private static final MethodDescriptor This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public abstract class HubServiceStub implements BackgroundResource {
+
+ public OperationsStub getOperationsStub() {
+ throw new UnsupportedOperationException("Not implemented: getOperationsStub()");
+ }
+
+ public UnaryCallable{@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.v1;
+
+import javax.annotation.Generated;
diff --git a/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1/stub/GrpcHubServiceCallableFactory.java b/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1/stub/GrpcHubServiceCallableFactory.java
new file mode 100644
index 00000000..8ee01f16
--- /dev/null
+++ b/google-cloud-networkconnectivity/src/main/java/com/google/cloud/networkconnectivity/v1/stub/GrpcHubServiceCallableFactory.java
@@ -0,0 +1,113 @@
+/*
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.networkconnectivity.v1.stub;
+
+import com.google.api.gax.grpc.GrpcCallSettings;
+import com.google.api.gax.grpc.GrpcCallableFactory;
+import com.google.api.gax.grpc.GrpcStubCallableFactory;
+import com.google.api.gax.rpc.BatchingCallSettings;
+import com.google.api.gax.rpc.BidiStreamingCallable;
+import com.google.api.gax.rpc.ClientContext;
+import com.google.api.gax.rpc.ClientStreamingCallable;
+import com.google.api.gax.rpc.OperationCallSettings;
+import com.google.api.gax.rpc.OperationCallable;
+import com.google.api.gax.rpc.PagedCallSettings;
+import com.google.api.gax.rpc.ServerStreamingCallSettings;
+import com.google.api.gax.rpc.ServerStreamingCallable;
+import com.google.api.gax.rpc.StreamingCallSettings;
+import com.google.api.gax.rpc.UnaryCallSettings;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.longrunning.Operation;
+import com.google.longrunning.stub.OperationsStub;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * gRPC callable factory implementation for the HubService service API.
+ *
+ *