/// <summary>
/// Creates a <see cref="CompletionClient"/> which uses the specified call invoker for remote operations.
/// </summary>
/// <param name="callInvoker">The <see cref="grpccore::CallInvoker"/> for remote operations. Must not be null.</param>
/// <param name="settings">Optional <see cref="CompletionSettings"/>.</param>
/// <returns>The created <see cref="CompletionClient"/>.</returns>
public static CompletionClient Create(grpccore::CallInvoker callInvoker, CompletionSettings settings = null)
{
gax::GaxPreconditions.CheckNotNull(callInvoker, nameof(callInvoker));
grpccore::Interceptors.Interceptor interceptor = settings?.Interceptor;
if (interceptor != null)
{
callInvoker = grpccore::Interceptors.CallInvokerExtensions.Intercept(callInvoker, interceptor);
}
Completion.CompletionClient grpcClient = new Completion.CompletionClient(callInvoker);
return(new CompletionClientImpl(grpcClient, settings));
}
/// <summary>
/// Constructs a client wrapper for the Completion service, with the specified gRPC client and settings.
/// </summary>
/// <param name="grpcClient">The underlying gRPC client.</param>
/// <param name="settings">The base <see cref="CompletionSettings"/> used within this client.</param>
public CompletionClientImpl(Completion.CompletionClient grpcClient, CompletionSettings settings)
{
GrpcClient = grpcClient;
CompletionSettings effectiveSettings = settings ?? CompletionSettings.GetDefault();
gaxgrpc::ClientHelper clientHelper = new gaxgrpc::ClientHelper(effectiveSettings);
_callCompleteQuery = clientHelper.BuildApiCall <CompleteQueryRequest, CompleteQueryResponse>(grpcClient.CompleteQueryAsync, grpcClient.CompleteQuery, effectiveSettings.CompleteQuerySettings).WithGoogleRequestParam("parent", request => request.Parent);
Modify_ApiCall(ref _callCompleteQuery);
Modify_CompleteQueryApiCall(ref _callCompleteQuery);
OnConstruction(grpcClient, effectiveSettings, clientHelper);
}
/// <summary>
/// Constructs a client wrapper for the Completion service, with the specified gRPC client and settings.
/// </summary>
/// <param name="grpcClient">The underlying gRPC client.</param>
/// <param name="settings">The base <see cref="CompletionSettings"/> used within this client </param>
public CompletionClientImpl(Completion.CompletionClient grpcClient, CompletionSettings settings)
{
GrpcClient = grpcClient;
CompletionSettings effectiveSettings = settings ?? CompletionSettings.GetDefault();
gaxgrpc::ClientHelper clientHelper = new gaxgrpc::ClientHelper(effectiveSettings);
_callCompleteQuery = clientHelper.BuildApiCall <CompleteQueryRequest, CompleteQueryResponse>(
GrpcClient.CompleteQueryAsync, GrpcClient.CompleteQuery, effectiveSettings.CompleteQuerySettings)
.WithCallSettingsOverlay(request => gaxgrpc::CallSettings.FromHeader("x-goog-request-params", $"parent={request.Parent}"));
Modify_ApiCall(ref _callCompleteQuery);
Modify_CompleteQueryApiCall(ref _callCompleteQuery);
OnConstruction(grpcClient, effectiveSettings, clientHelper);
}
partial void OnCopy(CompletionSettings existing);
private CompletionSettings(CompletionSettings existing) : base(existing)
{
gax::GaxPreconditions.CheckNotNull(existing, nameof(existing));
CompleteQuerySettings = existing.CompleteQuerySettings;
OnCopy(existing);
}
partial void OnConstruction(Completion.CompletionClient grpcClient, CompletionSettings effectiveSettings, gaxgrpc::ClientHelper clientHelper);
/// <summary>
/// Creates a <see cref="CompletionClient"/> which uses the specified channel for remote operations.
/// </summary>
/// <param name="channel">The <see cref="grpccore::Channel"/> for remote operations. Must not be null.</param>
/// <param name="settings">Optional <see cref="CompletionSettings"/>.</param>
/// <returns>The created <see cref="CompletionClient"/>.</returns>
public static CompletionClient Create(grpccore::Channel channel, CompletionSettings settings = null)
{
gax::GaxPreconditions.CheckNotNull(channel, nameof(channel));
return(Create(new grpccore::DefaultCallInvoker(channel), settings));
}
/// <summary>
/// Synchronously creates a <see cref="CompletionClient"/>, applying defaults for all unspecified settings,
/// and creating a channel connecting to the given endpoint with application default credentials where
/// necessary. See the example for how to use custom credentials.
/// </summary>
/// <example>
/// This sample shows how to create a client using default credentials:
/// <code>
/// using Google.Cloud.Talent.V4Beta1;
/// ...
/// // When running on Google Cloud Platform this will use the project Compute Credential.
/// // Or set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of a JSON
/// // credential file to use that credential.
/// CompletionClient client = CompletionClient.Create();
/// </code>
/// This sample shows how to create a client using credentials loaded from a JSON file:
/// <code>
/// using Google.Cloud.Talent.V4Beta1;
/// using Google.Apis.Auth.OAuth2;
/// using Grpc.Auth;
/// using Grpc.Core;
/// ...
/// GoogleCredential cred = GoogleCredential.FromFile("/path/to/credentials.json");
/// Channel channel = new Channel(
/// CompletionClient.DefaultEndpoint.Host, CompletionClient.DefaultEndpoint.Port, cred.ToChannelCredentials());
/// CompletionClient client = CompletionClient.Create(channel);
/// ...
/// // Shutdown the channel when it is no longer required.
/// channel.ShutdownAsync().Wait();
/// </code>
/// </example>
/// <param name="endpoint">Optional <see cref="gaxgrpc::ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="CompletionSettings"/>.</param>
/// <returns>The created <see cref="CompletionClient"/>.</returns>
public static CompletionClient Create(gaxgrpc::ServiceEndpoint endpoint = null, CompletionSettings settings = null)
{
grpccore::Channel channel = s_channelPool.GetChannel(endpoint ?? DefaultEndpoint);
return(Create(channel, settings));
}
/// <summary>
/// Asynchronously creates a <see cref="CompletionClient"/>, applying defaults for all unspecified settings,
/// and creating a channel connecting to the given endpoint with application default credentials where
/// necessary. See the example for how to use custom credentials.
/// </summary>
/// <example>
/// This sample shows how to create a client using default credentials:
/// <code>
/// using Google.Cloud.Talent.V4Beta1;
/// ...
/// // When running on Google Cloud Platform this will use the project Compute Credential.
/// // Or set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of a JSON
/// // credential file to use that credential.
/// CompletionClient client = await CompletionClient.CreateAsync();
/// </code>
/// This sample shows how to create a client using credentials loaded from a JSON file:
/// <code>
/// using Google.Cloud.Talent.V4Beta1;
/// using Google.Apis.Auth.OAuth2;
/// using Grpc.Auth;
/// using Grpc.Core;
/// ...
/// GoogleCredential cred = GoogleCredential.FromFile("/path/to/credentials.json");
/// Channel channel = new Channel(
/// CompletionClient.DefaultEndpoint.Host, CompletionClient.DefaultEndpoint.Port, cred.ToChannelCredentials());
/// CompletionClient client = CompletionClient.Create(channel);
/// ...
/// // Shutdown the channel when it is no longer required.
/// await channel.ShutdownAsync();
/// </code>
/// </example>
/// <param name="endpoint">Optional <see cref="gaxgrpc::ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="CompletionSettings"/>.</param>
/// <returns>The task representing the created <see cref="CompletionClient"/>.</returns>
public static async stt::Task <CompletionClient> CreateAsync(gaxgrpc::ServiceEndpoint endpoint = null, CompletionSettings settings = null)
{
grpccore::Channel channel = await s_channelPool.GetChannelAsync(endpoint ?? DefaultEndpoint).ConfigureAwait(false);
return(Create(channel, settings));
}
