Class StubSettings.Builder<SettingsT,B> (2.59.0)

Version latest

• 2.59.0 (latest)
• 2.58.0
• 2.57.0
• 2.55.0
• 2.54.1
• 2.53.0
• 2.52.0
• 2.51.0
• 2.50.0
• 2.49.0
• 2.48.1
• 2.47.0
• 2.46.1
• 2.45.0
• 2.43.0
• 2.42.0
• 2.41.0
• 2.39.0
• 2.38.0
• 2.37.0
• 2.36.0
• 2.35.0
• 2.34.1
• 2.33.0
• 2.32.1
• 2.31.1
• 2.30.1
• 2.24.0
• 2.23.3
• 2.22.0
• 2.21.0
• 2.20.1
• 2.19.6
• 2.18.7
• 2.17.0
• 2.16.0
• 2.15.0
• 2.14.0
• 2.13.0
• 2.12.2
• 2.11.0
• 2.10.0
• 2.9.0
• 2.8.1
• 2.7.1

public abstract static class StubSettings.Builder<SettingsT,B>

Inheritance

java.lang.Object > StubSettings.Builder<SettingsT,B>

Inherited Members

Object.clone()

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.toString()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Type Parameters
Name	Description
SettingsT
B

Static Methods

applyToAllUnaryMethods(Iterable<UnaryCallSettings.Builder<?,?>> methodSettingsBuilders, ApiFunction<UnaryCallSettings.Builder<?,?>,Void> settingsUpdater)

protected static void applyToAllUnaryMethods(Iterable<UnaryCallSettings.Builder<?,?>> methodSettingsBuilders, ApiFunction<UnaryCallSettings.Builder<?,?>,Void> settingsUpdater)

Applies the given settings updater function to the given method settings builders.

Parameters
Name	Description
methodSettingsBuilders	Iterable<Builder<?,?>>
settingsUpdater	ApiFunction<Builder<?,?>,Void>

Constructors

Builder()

protected Builder()

Builder(ClientContext clientContext)

protected Builder(ClientContext clientContext)

Parameter
Name	Description
clientContext	ClientContext

Builder(StubSettings settings)

protected Builder(StubSettings settings)

Create a builder from a StubSettings object.

Parameter
Name	Description
settings	StubSettings

Methods

<B>build()

public abstract StubSettings<B> <B>build()

Returns
Type	Description
StubSettings<B>

Exceptions
Type	Description
IOException

getApiKey()

public final String getApiKey()

Gets the API Key that was previously set on this Builder.

Returns
Type	Description
String

getBackgroundExecutorProvider()

public ExecutorProvider getBackgroundExecutorProvider()

Gets the ExecutorProvider that was previously set on this Builder.

Returns
Type	Description
ExecutorProvider

getClock()

public ApiClock getClock()

Gets the ApiClock that was previously set on this Builder.

Returns
Type	Description
ApiClock

getCredentialsProvider()

public CredentialsProvider getCredentialsProvider()

Gets the CredentialsProvider that was previously set on this Builder.

Returns
Type	Description
CredentialsProvider

getEndpoint()

public String getEndpoint()

Returns
Type	Description
String	the resolved endpoint when the Builder was created. If invoked after StubSettings.newBuilder() is called, it will return the clientSettingsEndpoint value. If other parameters are then set in the builder, the resolved endpoint is not automatically updated. The resolved endpoint will only be recomputed when the StubSettings is built again.

getExecutorProvider() (deprecated)

public ExecutorProvider getExecutorProvider()

Deprecated. Please use #getBackgroundExecutorProvider().

Returns
Type	Description
ExecutorProvider

getGdchApiAudience()

public String getGdchApiAudience()

Gets the GDCH API audience that was previously set in this Builder

Returns
Type	Description
String

getHeaderProvider()

public HeaderProvider getHeaderProvider()

Gets the custom HeaderProvider that was previously set on this Builder.

Returns
Type	Description
HeaderProvider

getInternalHeaderProvider()

protected HeaderProvider getInternalHeaderProvider()

Gets the internal HeaderProvider that was previously set on this Builder.

Returns
Type	Description
HeaderProvider

getMtlsEndpoint()

public String getMtlsEndpoint()

Returns
Type	Description
String

getQuotaProjectId()

public String getQuotaProjectId()

Gets the QuotaProjectId that was previously set on this Builder.

Returns
Type	Description
String

getStreamWatchdogCheckInterval()

public Duration getStreamWatchdogCheckInterval()

Obsolete

Use getStreamWatchdogCheckIntervalDuration() instead

This feature is stable for usage in this major version, but may be deprecated in a future release.

This method is obsolete. Use #getStreamWatchdogCheckIntervalDuration() instead

Returns
Type	Description
org.threeten.bp.Duration

getStreamWatchdogCheckIntervalDuration()

public Duration getStreamWatchdogCheckIntervalDuration()

Returns
Type	Description
Duration

getStreamWatchdogProvider()

public WatchdogProvider getStreamWatchdogProvider()

Gets the WatchdogProviderthat was previously set on this Builder.

Returns
Type	Description
WatchdogProvider

getTracerFactory()

public ApiTracerFactory getTracerFactory()

Beta

The surface for tracing is not stable yet and may change in the future.

This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.

Returns
Type	Description
ApiTracerFactory

getTransportChannelProvider()

public TransportChannelProvider getTransportChannelProvider()

Gets the TransportProvider that was previously set on this Builder.

Returns
Type	Description
TransportChannelProvider

self()

protected B self()

Returns
Type	Description
B

setApiKey(String apiKey)

public B setApiKey(String apiKey)

Sets the API key. The API key will get translated to an com.google.auth.ApiKeyCredentials and stored in ClientContext.

API Key authorization is not supported for every product. Please check the documentation for each product to confirm if it is supported.

Note: If you set an API key and CredentialsProvider in the same ClientSettings the API key will override any credentials provided.

Parameter
Name	Description
apiKey	String

Returns
Type	Description
B

setBackgroundExecutorProvider(ExecutorProvider backgroundExecutorProvider)

public B setBackgroundExecutorProvider(ExecutorProvider backgroundExecutorProvider)

Sets the executor to use for running scheduled API call logic (such as retries and long-running operations).

Parameter
Name	Description
backgroundExecutorProvider	ExecutorProvider

Returns
Type	Description
B

setClock(ApiClock clock)

public B setClock(ApiClock clock)

Sets the clock to use for retry logic.

This will default to a system clock if it is not set.

Parameter
Name	Description
clock	ApiClock

Returns
Type	Description
B

setCredentialsProvider(CredentialsProvider credentialsProvider)

public B setCredentialsProvider(CredentialsProvider credentialsProvider)

Sets the CredentialsProvider to use for getting the credentials to make calls with.

Parameter
Name	Description
credentialsProvider	CredentialsProvider

Returns
Type	Description
B

setEndpoint(String endpoint)

public B setEndpoint(String endpoint)

Parameter
Name	Description
endpoint	String

Returns
Type	Description
B

setExecutorProvider(ExecutorProvider executorProvider) (deprecated)

public B setExecutorProvider(ExecutorProvider executorProvider)

Deprecated. Please use #setBackgroundExecutorProvider(ExecutorProvider) for setting executor to use for running scheduled API call logic. To set executor for TransportChannelProvider, please use TransportChannelProvider#withExecutor(Executor) instead.

Sets the ExecutorProvider to use for getting the executor to use for running asynchronous API call logic (such as retries and long-running operations), and also to pass to the transport settings if an executor is needed for the transport and it doesn't have its own executor provider.

Parameter
Name	Description
executorProvider	ExecutorProvider

Returns
Type	Description
B

setGdchApiAudience(String gdchApiAudience)

public B setGdchApiAudience(String gdchApiAudience)

Sets the API audience used by com.google.auth.oauth2.GdchCredentials It cannot be used if other type of com.google.auth.Credentials is used. If the provided credentials already have an api audience set, then it will be overriden by this audience

Parameter
Name	Description
gdchApiAudience	String the audience to be used - must be a valid URI string

Returns
Type	Description
B

setHeaderProvider(HeaderProvider headerProvider)

public B setHeaderProvider(HeaderProvider headerProvider)

Sets the HeaderProvider for getting custom static headers for http requests. The header provider will be called during client construction only once. The headers returned by the provider will be cached and supplied as is for each request issued by the constructed client. Some reserved headers can be overridden (e.g. Content-Type) or merged with the default value (e.g. User-Agent) by the underlying transport layer.

Parameter
Name	Description
headerProvider	HeaderProvider

Returns
Type	Description
B

setInternalHeaderProvider(HeaderProvider internalHeaderProvider)

protected B setInternalHeaderProvider(HeaderProvider internalHeaderProvider)

Sets the HeaderProvider for getting internal (library-defined) static headers for http requests. The header provider will be called during client construction only once. The headers returned by the provider will be cached and supplied as is for each request issued by the constructed client. Some reserved headers can be overridden (e.g. Content-Type) or merged with the default value (e.g. User-Agent) by the underlying transport layer.

Parameter
Name	Description
internalHeaderProvider	HeaderProvider

Returns
Type	Description
B

setMtlsEndpoint(String mtlsEndpoint)

public B setMtlsEndpoint(String mtlsEndpoint)

Parameter
Name	Description
mtlsEndpoint	String

Returns
Type	Description
B

setQuotaProjectId(String quotaProjectId)

public B setQuotaProjectId(String quotaProjectId)

Parameter
Name	Description
quotaProjectId	String

Returns
Type	Description
B

setStreamWatchdogCheckInterval(Duration checkInterval)

public B setStreamWatchdogCheckInterval(Duration checkInterval)

Obsolete

Use setStreamWatchdogCheckIntervalDuration(java.time.Duration) instead

This feature is stable for usage in this major version, but may be deprecated in a future release.

This method is obsolete. Use #setStreamWatchdogCheckIntervalDuration(java.time.Duration) instead.

Parameter
Name	Description
checkInterval	org.threeten.bp.Duration

Returns
Type	Description
B

setStreamWatchdogCheckIntervalDuration(Duration checkInterval)

public B setStreamWatchdogCheckIntervalDuration(Duration checkInterval)

Sets how often the Watchdog will check ongoing streaming RPCs. Defaults to 10 secs. Use java.time.Duration#ZERO to disable.

Parameter
Name	Description
checkInterval	Duration

Returns
Type	Description
B

setStreamWatchdogProvider(WatchdogProvider streamWatchdogProvider)

public B setStreamWatchdogProvider(WatchdogProvider streamWatchdogProvider)

Sets the WatchdogProvider to use for streaming RPC.

This will default to a InstantiatingWatchdogProvider if it is not set.

Parameter
Name	Description
streamWatchdogProvider	WatchdogProvider

Returns
Type	Description
B

setSwitchToMtlsEndpointAllowed(boolean switchToMtlsEndpointAllowed)

protected B setSwitchToMtlsEndpointAllowed(boolean switchToMtlsEndpointAllowed)

Parameter
Name	Description
switchToMtlsEndpointAllowed	boolean

Returns
Type	Description
B

setTracerFactory(ApiTracerFactory tracerFactory)

public B setTracerFactory(ApiTracerFactory tracerFactory)

Beta

The surface for tracing is not stable yet and may change in the future.

This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.

Configures the ApiTracerFactory that will be used to generate traces.

Parameter
Name	Description
tracerFactory	ApiTracerFactory an instance of ApiTracerFactory to set.

Returns
Type	Description
B

setTransportChannelProvider(TransportChannelProvider transportChannelProvider)

public B setTransportChannelProvider(TransportChannelProvider transportChannelProvider)

Sets the TransportProvider to use for getting the transport-specific context to make calls with.

Parameter
Name	Description
transportChannelProvider	TransportChannelProvider

Returns
Type	Description
B

setUniverseDomain(String universeDomain)

public B setUniverseDomain(String universeDomain)

Parameter
Name	Description
universeDomain	String

Returns
Type	Description
B

toString()

public String toString()

Returns
Type	Description
String

Overrides

Object.toString()