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: * - *
- *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * String connectionId = "";
- * Connection response = connectionServiceClient.createConnection(parent, connection, connectionId);
- * }
- *
- *
- *
- * Note: close() needs to be called on the connectionServiceClient object to clean up resources + *
Note: close() needs to be called on the ConnectionServiceClient object to clean up resources * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * @@ -91,30 +72,28 @@ * *
To customize credentials: * - *
- *
+ * {@code
* ConnectionServiceSettings connectionServiceSettings =
* ConnectionServiceSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
* .build();
* ConnectionServiceClient connectionServiceClient =
* ConnectionServiceClient.create(connectionServiceSettings);
- *
- *
+ * }
*
- * To customize the endpoint:
+ * To customize the endpoint: * - *
- *
+ * {@code
* ConnectionServiceSettings connectionServiceSettings =
* ConnectionServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
* ConnectionServiceClient connectionServiceClient =
* ConnectionServiceClient.create(connectionServiceSettings);
- *
- *
+ * }
+ *
+ * Please refer to the GitHub repository's samples for more quickstart code snippets. */ -@Generated("by gapic-generator") @BetaApi +@Generated("by gapic-generator") public class ConnectionServiceClient implements BackgroundResource { private final ConnectionServiceSettings settings; private final ConnectionServiceStub stub; @@ -135,7 +114,7 @@ public static final ConnectionServiceClient create(ConnectionServiceSettings set /** * Constructs an instance of ConnectionServiceClient, using the given stub for making calls. This - * is for advanced usage - prefer to use ConnectionServiceSettings}. + * is for advanced usage - prefer using create(ConnectionServiceSettings). */ @BetaApi("A restructuring of stub classes is planned, so this may break in the future") public static final ConnectionServiceClient create(ConnectionServiceStub stub) { @@ -167,31 +146,20 @@ public ConnectionServiceStub getStub() { return stub; } - // AUTO-GENERATED DOCUMENTATION AND METHOD + // AUTO-GENERATED DOCUMENTATION AND METHOD. /** * Creates a new connection. * - *
Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * String connectionId = "";
- * Connection response = connectionServiceClient.createConnection(parent, connection, connectionId);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * String connectionId = "";
- * Connection response = connectionServiceClient.createConnection(parent.toString(), connection, connectionId);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * CreateConnectionRequest request = CreateConnectionRequest.newBuilder()
- * .setParent(parent.toString())
- * .setConnection(connection)
- * .build();
- * Connection response = connectionServiceClient.createConnection(request);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * CreateConnectionRequest request = CreateConnectionRequest.newBuilder()
- * .setParent(parent.toString())
- * .setConnection(connection)
- * .build();
- * ApiFuture<Connection> future = connectionServiceClient.createConnectionCallable().futureCall(request);
- * // Do something
- * Connection response = future.get();
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Connection response = connectionServiceClient.getConnection(name);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Connection response = connectionServiceClient.getConnection(name.toString());
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * GetConnectionRequest request = GetConnectionRequest.newBuilder()
- * .setName(name.toString())
- * .build();
- * Connection response = connectionServiceClient.getConnection(request);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * GetConnectionRequest request = GetConnectionRequest.newBuilder()
- * .setName(name.toString())
- * .build();
- * ApiFuture<Connection> future = connectionServiceClient.getConnectionCallable().futureCall(request);
- * // Do something
- * Connection response = future.get();
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * UInt32Value maxResults = UInt32Value.newBuilder().build();
- * ListConnectionsResponse response = connectionServiceClient.listConnections(parent, maxResults);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * UInt32Value maxResults = UInt32Value.newBuilder().build();
- * ListConnectionsResponse response = connectionServiceClient.listConnections(parent.toString(), maxResults);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * UInt32Value maxResults = UInt32Value.newBuilder().build();
- * ListConnectionsRequest request = ListConnectionsRequest.newBuilder()
- * .setParent(parent.toString())
- * .setMaxResults(maxResults)
- * .build();
- * ListConnectionsResponse response = connectionServiceClient.listConnections(request);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * UInt32Value maxResults = UInt32Value.newBuilder().build();
- * ListConnectionsRequest request = ListConnectionsRequest.newBuilder()
- * .setParent(parent.toString())
- * .setMaxResults(maxResults)
- * .build();
- * ApiFuture<ListConnectionsResponse> future = connectionServiceClient.listConnectionsCallable().futureCall(request);
- * // Do something
- * ListConnectionsResponse response = future.get();
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Connection connection = Connection.newBuilder().build();
- * FieldMask updateMask = FieldMask.newBuilder().build();
- * Connection response = connectionServiceClient.updateConnection(name, connection, updateMask);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Connection connection = Connection.newBuilder().build();
- * FieldMask updateMask = FieldMask.newBuilder().build();
- * Connection response = connectionServiceClient.updateConnection(name.toString(), connection, updateMask);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Connection connection = Connection.newBuilder().build();
- * FieldMask updateMask = FieldMask.newBuilder().build();
- * UpdateConnectionRequest request = UpdateConnectionRequest.newBuilder()
- * .setName(name.toString())
- * .setConnection(connection)
- * .setUpdateMask(updateMask)
- * .build();
- * Connection response = connectionServiceClient.updateConnection(request);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Connection connection = Connection.newBuilder().build();
- * FieldMask updateMask = FieldMask.newBuilder().build();
- * UpdateConnectionRequest request = UpdateConnectionRequest.newBuilder()
- * .setName(name.toString())
- * .setConnection(connection)
- * .setUpdateMask(updateMask)
- * .build();
- * ApiFuture<Connection> future = connectionServiceClient.updateConnectionCallable().futureCall(request);
- * // Do something
- * Connection response = future.get();
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * String name = "";
- * ConnectionCredential credential = ConnectionCredential.newBuilder().build();
- * connectionServiceClient.updateConnectionCredential(name, credential);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * String name = "";
- * ConnectionCredential credential = ConnectionCredential.newBuilder().build();
- * UpdateConnectionCredentialRequest request = UpdateConnectionCredentialRequest.newBuilder()
- * .setName(name)
- * .setCredential(credential)
- * .build();
- * connectionServiceClient.updateConnectionCredential(request);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * String name = "";
- * ConnectionCredential credential = ConnectionCredential.newBuilder().build();
- * UpdateConnectionCredentialRequest request = UpdateConnectionCredentialRequest.newBuilder()
- * .setName(name)
- * .setCredential(credential)
- * .build();
- * ApiFuture<Void> future = connectionServiceClient.updateConnectionCredentialCallable().futureCall(request);
- * // Do something
- * future.get();
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * connectionServiceClient.deleteConnection(name);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * connectionServiceClient.deleteConnection(name.toString());
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * DeleteConnectionRequest request = DeleteConnectionRequest.newBuilder()
- * .setName(name.toString())
- * .build();
- * connectionServiceClient.deleteConnection(request);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * DeleteConnectionRequest request = DeleteConnectionRequest.newBuilder()
- * .setName(name.toString())
- * .build();
- * ApiFuture<Void> future = connectionServiceClient.deleteConnectionCallable().futureCall(request);
- * // Do something
- * future.get();
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * GetPolicyOptions options = GetPolicyOptions.newBuilder().build();
- * Policy response = connectionServiceClient.getIamPolicy(resource, options);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * GetPolicyOptions options = GetPolicyOptions.newBuilder().build();
- * Policy response = connectionServiceClient.getIamPolicy(resource.toString(), options);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * GetIamPolicyRequest request = GetIamPolicyRequest.newBuilder()
- * .setResource(resource.toString())
- * .build();
- * Policy response = connectionServiceClient.getIamPolicy(request);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * GetIamPolicyRequest request = GetIamPolicyRequest.newBuilder()
- * .setResource(resource.toString())
- * .build();
- * ApiFuture<Policy> future = connectionServiceClient.getIamPolicyCallable().futureCall(request);
- * // Do something
- * Policy response = future.get();
- * }
- * Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED * - *
Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Policy policy = Policy.newBuilder().build();
- * Policy response = connectionServiceClient.setIamPolicy(resource, policy);
- * }
- * Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED * - *
Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Policy policy = Policy.newBuilder().build();
- * Policy response = connectionServiceClient.setIamPolicy(resource.toString(), policy);
- * }
- * Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED * - *
Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Policy policy = Policy.newBuilder().build();
- * SetIamPolicyRequest request = SetIamPolicyRequest.newBuilder()
- * .setResource(resource.toString())
- * .setPolicy(policy)
- * .build();
- * Policy response = connectionServiceClient.setIamPolicy(request);
- * }
- * Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED * *
Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Policy policy = Policy.newBuilder().build();
- * SetIamPolicyRequest request = SetIamPolicyRequest.newBuilder()
- * .setResource(resource.toString())
- * .setPolicy(policy)
- * .build();
- * ApiFuture<Policy> future = connectionServiceClient.setIamPolicyCallable().futureCall(request);
- * // Do something
- * Policy response = future.get();
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * List<String> permissions = new ArrayList<>();
- * TestIamPermissionsResponse response = connectionServiceClient.testIamPermissions(resource, permissions);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * List<String> permissions = new ArrayList<>();
- * TestIamPermissionsResponse response = connectionServiceClient.testIamPermissions(resource.toString(), permissions);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * List<String> permissions = new ArrayList<>();
- * TestIamPermissionsRequest request = TestIamPermissionsRequest.newBuilder()
- * .setResource(resource.toString())
- * .addAllPermissions(permissions)
- * .build();
- * TestIamPermissionsResponse response = connectionServiceClient.testIamPermissions(request);
- * }
- * Sample code: - * - *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ResourceName resource = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * List<String> permissions = new ArrayList<>();
- * TestIamPermissionsRequest request = TestIamPermissionsRequest.newBuilder()
- * .setResource(resource.toString())
- * .addAllPermissions(permissions)
- * .build();
- * ApiFuture<TestIamPermissionsResponse> future = connectionServiceClient.testIamPermissionsCallable().futureCall(request);
- * // Do something
- * TestIamPermissionsResponse response = future.get();
- * }
- * For example, to set the total timeout of createConnection to 30 seconds: * - *
- *
+ * {@code
* ConnectionServiceSettings.Builder connectionServiceSettingsBuilder =
* ConnectionServiceSettings.newBuilder();
* connectionServiceSettingsBuilder
* .createConnectionSettings()
* .setRetrySettings(
- * connectionServiceSettingsBuilder.createConnectionSettings().getRetrySettings().toBuilder()
+ * connectionServiceSettingsBuilder
+ * .createConnectionSettings()
+ * .getRetrySettings()
+ * .toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* ConnectionServiceSettings connectionServiceSettings = connectionServiceSettingsBuilder.build();
- *
- *
+ * }
*/
-@Generated("by gapic-generator")
-@BetaApi
+@Generated("by gapic-generator-java")
public class ConnectionServiceSettings extends ClientSettingsThe interfaces provided are listed below, along with usage samples. + * The interfaces provided are listed below, along with usage samples. * *
======================= ConnectionServiceClient ======================= * *
Service Description: Manages external data source connections and credentials. * *
Sample for ConnectionServiceClient: - * - *
- *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * String connectionId = "";
- * Connection response = connectionServiceClient.createConnection(parent, connection, connectionId);
- * }
- *
- *
*/
-@Generated("by gapic-generator")
+@Generated("by gapic-generator-java")
package com.google.cloud.bigquery.connection.v1beta1;
import javax.annotation.Generated;
diff --git a/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/stub/ConnectionServiceStub.java b/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/stub/ConnectionServiceStub.java
index 3e46e264..4fe08474 100644
--- a/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/stub/ConnectionServiceStub.java
+++ b/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/stub/ConnectionServiceStub.java
@@ -5,7 +5,7 @@
* 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
+ * 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,
@@ -13,19 +13,12 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
+
package com.google.cloud.bigquery.connection.v1beta1.stub;
-import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
import com.google.api.gax.rpc.UnaryCallable;
-import com.google.cloud.bigquery.connection.v1beta1.ConnectionProto.Connection;
-import com.google.cloud.bigquery.connection.v1beta1.ConnectionProto.CreateConnectionRequest;
-import com.google.cloud.bigquery.connection.v1beta1.ConnectionProto.DeleteConnectionRequest;
-import com.google.cloud.bigquery.connection.v1beta1.ConnectionProto.GetConnectionRequest;
-import com.google.cloud.bigquery.connection.v1beta1.ConnectionProto.ListConnectionsRequest;
-import com.google.cloud.bigquery.connection.v1beta1.ConnectionProto.ListConnectionsResponse;
-import com.google.cloud.bigquery.connection.v1beta1.ConnectionProto.UpdateConnectionCredentialRequest;
-import com.google.cloud.bigquery.connection.v1beta1.ConnectionProto.UpdateConnectionRequest;
+import com.google.cloud.bigquery.connection.v1beta1.ConnectionProto;
import com.google.iam.v1.GetIamPolicyRequest;
import com.google.iam.v1.Policy;
import com.google.iam.v1.SetIamPolicyRequest;
@@ -34,39 +27,43 @@
import com.google.protobuf.Empty;
import javax.annotation.Generated;
-// AUTO-GENERATED DOCUMENTATION AND CLASS
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
/**
- * Base stub class for BigQuery Connection API.
+ * Base stub class for the ConnectionService service API.
*
* This class is for advanced usage and reflects the underlying API directly.
*/
@Generated("by gapic-generator")
-@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
public abstract class ConnectionServiceStub implements BackgroundResource {
- public UnaryCallable For example, to set the total timeout of createConnection to 30 seconds:
*
- * This class is for advanced usage.
*/
@Generated("by gapic-generator")
-@BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
public class GrpcConnectionServiceCallableFactory implements GrpcStubCallableFactory {
+
@Override
public This class is for advanced usage and reflects the underlying API directly.
*/
-@Generated("by gapic-generator")
-@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
+@Generated("by gapic-generator-java")
public class GrpcConnectionServiceStub extends ConnectionServiceStub {
-
- private static final MethodDescriptor 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:
*
- * Note: close() needs to be called on the connectionServiceClient object to clean up resources
+ * Note: close() needs to be called on the ConnectionServiceClient object to clean up resources
* such as threads. In the example above, try-with-resources is used, which automatically calls
* close().
*
@@ -98,30 +88,28 @@
*
* To customize credentials:
*
- * To customize the endpoint:
*
- * Please refer to the GitHub repository's samples for more quickstart code snippets.
*/
-@Generated("by gapic-generator")
@BetaApi
+@Generated("by gapic-generator")
public class ConnectionServiceClient implements BackgroundResource {
private final ConnectionServiceSettings settings;
private final ConnectionServiceStub stub;
@@ -142,7 +130,7 @@ public static final ConnectionServiceClient create(ConnectionServiceSettings set
/**
* Constructs an instance of ConnectionServiceClient, using the given stub for making calls. This
- * is for advanced usage - prefer to use ConnectionServiceSettings}.
+ * is for advanced usage - prefer using create(ConnectionServiceSettings).
*/
@BetaApi("A restructuring of stub classes is planned, so this may break in the future")
public static final ConnectionServiceClient create(ConnectionServiceStub stub) {
@@ -174,21 +162,10 @@ public ConnectionServiceStub getStub() {
return stub;
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new connection.
*
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- * Sample code:
- *
- *
- *
+ * ConnectionServiceStubSettings connectionServiceSettings =
+ * connectionServiceSettingsBuilder.build();
+ * }
*/
-@Generated("by gapic-generator")
@BetaApi
+@Generated("by gapic-generator-java")
public class ConnectionServiceStubSettings extends StubSettings
+ *
- * {@code
* ConnectionServiceStubSettings.Builder connectionServiceSettingsBuilder =
* ConnectionServiceStubSettings.newBuilder();
* connectionServiceSettingsBuilder
* .createConnectionSettings()
* .setRetrySettings(
- * connectionServiceSettingsBuilder.createConnectionSettings().getRetrySettings().toBuilder()
+ * connectionServiceSettingsBuilder
+ * .createConnectionSettings()
+ * .getRetrySettings()
+ * .toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
- * ConnectionServiceStubSettings connectionServiceSettings = connectionServiceSettingsBuilder.build();
- *
- *
- *
- *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * String connectionId = "";
- * Connection response = connectionServiceClient.createConnection(parent, connection, connectionId);
- * }
- *
- *
- *
+ * }
*
- * To customize the endpoint:
+ *
+ *
- * {@code
* ConnectionServiceSettings connectionServiceSettings =
* ConnectionServiceSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
* .build();
* ConnectionServiceClient connectionServiceClient =
* ConnectionServiceClient.create(connectionServiceSettings);
- *
- *
+ * }
+ *
+ *
+ *
- * {@code
* ConnectionServiceSettings connectionServiceSettings =
* ConnectionServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
* ConnectionServiceClient connectionServiceClient =
* ConnectionServiceClient.create(connectionServiceSettings);
- *
- *
* @param parent Required. Parent resource name. Must be in the format
* `projects/{project_id}/locations/{location_id}`
* @param connection Required. Connection to create.
@@ -206,21 +183,10 @@ public final Connection createConnection(
return createConnection(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new connection.
*
- *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * String connectionId = "";
- * Connection response = connectionServiceClient.createConnection(parent, connection, connectionId);
- * }
- *
- *
* @param parent Required. Parent resource name. Must be in the format
* `projects/{project_id}/locations/{location_id}`
* @param connection Required. Connection to create.
@@ -238,24 +204,10 @@ public final Connection createConnection(
return createConnection(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new connection.
*
- *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * String connectionId = "";
- * Connection response = connectionServiceClient.createConnection(parent.toString(), connection, connectionId);
- * }
- *
- *
* @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
*/
@@ -263,43 +215,20 @@ public final Connection createConnection(CreateConnectionRequest request) {
return createConnectionCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new connection.
*
*
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * CreateConnectionRequest request = CreateConnectionRequest.newBuilder()
- * .setParent(parent.toString())
- * .setConnection(connection)
- * .build();
- * Connection response = connectionServiceClient.createConnection(request);
- * }
- *
*/
public final UnaryCallable
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * Connection connection = Connection.newBuilder().build();
- * CreateConnectionRequest request = CreateConnectionRequest.newBuilder()
- * .setParent(parent.toString())
- * .setConnection(connection)
- * .build();
- * ApiFuture<Connection> future = connectionServiceClient.createConnectionCallable().futureCall(request);
- * // Do something
- * Connection response = future.get();
- * }
- *
- *
* @param name Required. Name of the requested connection, for example:
* `projects/{project_id}/locations/{location_id}/connections/{connection_id}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -310,19 +239,10 @@ public final Connection getConnection(ConnectionName name) {
return getConnection(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns specified connection.
*
- *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Connection response = connectionServiceClient.getConnection(name);
- * }
- *
- *
* @param name Required. Name of the requested connection, for example:
* `projects/{project_id}/locations/{location_id}/connections/{connection_id}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -332,22 +252,10 @@ public final Connection getConnection(String name) {
return getConnection(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns specified connection.
*
- *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * Connection response = connectionServiceClient.getConnection(name.toString());
- * }
- *
- *
* @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
*/
@@ -355,43 +263,20 @@ public final Connection getConnection(GetConnectionRequest request) {
return getConnectionCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns specified connection.
*
*
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * GetConnectionRequest request = GetConnectionRequest.newBuilder()
- * .setName(name.toString())
- * .build();
- * Connection response = connectionServiceClient.getConnection(request);
- * }
- *
*/
public final UnaryCallable
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * ConnectionName name = ConnectionName.of("[PROJECT]", "[LOCATION]", "[CONNECTION]");
- * GetConnectionRequest request = GetConnectionRequest.newBuilder()
- * .setName(name.toString())
- * .build();
- * ApiFuture<Connection> future = connectionServiceClient.getConnectionCallable().futureCall(request);
- * // Do something
- * Connection response = future.get();
- * }
- *
- *
* @param parent Required. Parent resource name. Must be in the form:
* `projects/{project_id}/locations/{location_id}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -404,21 +289,10 @@ public final ListConnectionsPagedResponse listConnections(LocationName parent) {
return listConnections(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns a list of connections in the given project.
*
- *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * for (Connection element : connectionServiceClient.listConnections(parent).iterateAll()) {
- * // doThingsWith(element);
- * }
- * }
- *
- *
* @param parent Required. Parent resource name. Must be in the form:
* `projects/{project_id}/locations/{location_id}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -428,26 +302,10 @@ public final ListConnectionsPagedResponse listConnections(String parent) {
return listConnections(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns a list of connections in the given project.
*
- *
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * for (Connection element : connectionServiceClient.listConnections(parent.toString()).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
*/
@@ -455,83 +313,33 @@ public final ListConnectionsPagedResponse listConnections(ListConnectionsRequest
return listConnectionsPagedCallable().call(request);
}
- // AUTO-GENERATED DOCUMENTATION AND METHOD
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns a list of connections in the given project.
*
*
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * int pageSize = 0;
- * ListConnectionsRequest request = ListConnectionsRequest.newBuilder()
- * .setParent(parent.toString())
- * .setPageSize(pageSize)
- * .build();
- * for (Connection element : connectionServiceClient.listConnections(request).iterateAll()) {
- * // doThingsWith(element);
- * }
- * }
- *
*/
public final UnaryCallable
- * try (ConnectionServiceClient connectionServiceClient = ConnectionServiceClient.create()) {
- * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
- * int pageSize = 0;
- * ListConnectionsRequest request = ListConnectionsRequest.newBuilder()
- * .setParent(parent.toString())
- * .setPageSize(pageSize)
- * .build();
- * ApiFuture<ListConnectionsPagedResponse> future = connectionServiceClient.listConnectionsPagedCallable().futureCall(request);
- * // Do something
- * for (Connection element : future.get().iterateAll()) {
- * // doThingsWith(element);
- * }
- * }
- *