private TraceServiceSettings(TraceServiceSettings existing) : base(existing)
{
GaxPreconditions.CheckNotNull(existing, nameof(existing));
PatchTracesSettings = existing.PatchTracesSettings;
GetTraceSettings = existing.GetTraceSettings;
ListTracesSettings = existing.ListTracesSettings;
}
/// <summary>
/// Constructs a client wrapper for the TraceService service, with the specified gRPC client and settings.
/// </summary>
/// <param name="grpcClient">The underlying gRPC client.</param>
/// <param name="settings">The base <see cref="TraceServiceSettings"/> used within this client </param>
public TraceServiceClientImpl(TraceService.TraceServiceClient grpcClient, TraceServiceSettings settings)
{
this.GrpcClient = grpcClient;
TraceServiceSettings effectiveSettings = settings ?? TraceServiceSettings.GetDefault();
_clientHelper = new ClientHelper(effectiveSettings);
_callPatchTraces = _clientHelper.BuildApiCall <PatchTracesRequest, Empty>(
GrpcClient.PatchTracesAsync, GrpcClient.PatchTraces, effectiveSettings.PatchTracesSettings);
_callGetTrace = _clientHelper.BuildApiCall <GetTraceRequest, Trace>(
GrpcClient.GetTraceAsync, GrpcClient.GetTrace, effectiveSettings.GetTraceSettings);
_callListTraces = _clientHelper.BuildApiCall <ListTracesRequest, ListTracesResponse>(
GrpcClient.ListTracesAsync, GrpcClient.ListTraces, effectiveSettings.ListTracesSettings);
}
/// <summary>
/// Synchronously creates a <see cref="TraceServiceClient"/>, applying defaults for all unspecified settings,
/// and creating a channel connecting to the given endpoint with application default credentials where
/// necessary.
/// </summary>
/// <param name="endpoint">Optional <see cref="ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="TraceServiceSettings"/>.</param>
/// <returns>The created <see cref="TraceServiceClient"/>.</returns>
public static TraceServiceClient Create(ServiceEndpoint endpoint = null, TraceServiceSettings settings = null)
{
Channel channel = s_channelPool.GetChannel(endpoint ?? DefaultEndpoint);
return(Create(channel, settings));
}
/// <summary>
/// Creates a <see cref="TraceServiceClient"/> which uses the specified channel for remote operations.
/// </summary>
/// <param name="channel">The <see cref="Channel"/> for remote operations. Must not be null.</param>
/// <param name="settings">Optional <see cref="TraceServiceSettings"/>.</param>
/// <returns>The created <see cref="TraceServiceClient"/>.</returns>
public static TraceServiceClient Create(Channel channel, TraceServiceSettings settings = null)
{
GaxPreconditions.CheckNotNull(channel, nameof(channel));
TraceService.TraceServiceClient grpcClient = new TraceService.TraceServiceClient(channel);
return(new TraceServiceClientImpl(grpcClient, settings));
}
// Note: we could have parameterless overloads of Create and CreateAsync,
// documented to just use the default endpoint, settings and credentials.
// Pros:
// - Might be more reassuring on first use
// - Allows method group conversions
// Con: overloads!
/// <summary>
/// Asynchronously creates a <see cref="TraceServiceClient"/>, applying defaults for all unspecified settings,
/// and creating a channel connecting to the given endpoint with application default credentials where
/// necessary.
/// </summary>
/// <param name="endpoint">Optional <see cref="ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="TraceServiceSettings"/>.</param>
/// <returns>The task representing the created <see cref="TraceServiceClient"/>.</returns>
public static async Task <TraceServiceClient> CreateAsync(ServiceEndpoint endpoint = null, TraceServiceSettings settings = null)
{
Channel channel = await s_channelPool.GetChannelAsync(endpoint ?? DefaultEndpoint).ConfigureAwait(false);
return(Create(channel, settings));
}