Class UnaryCallSettings.Builder<RequestT,ResponseT> (2.54.1)

Version 2.54.1

• 2.55.0 (latest)
• 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 static class UnaryCallSettings.Builder<RequestT,ResponseT>

A base builder class for UnaryCallSettings. This class should not be used to create an instance of the base class UnaryCallSettings. See the class documentation of UnaryCallSettings for a description of the different values that can be set, and for a description of when this builder may be used. Builders for concrete derived classes can be used to create instances of those classes.

Inheritance

java.lang.Object > UnaryCallSettings.Builder<RequestT,ResponseT>

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
RequestT
ResponseT

Constructors

Builder()

protected Builder()

Builder(UnaryCallSettings<RequestT,ResponseT> unaryCallSettings)

protected Builder(UnaryCallSettings<RequestT,ResponseT> unaryCallSettings)

Parameter
Name	Description
unaryCallSettings	UnaryCallSettings<RequestT,ResponseT>

Methods

build()

public UnaryCallSettings<RequestT,ResponseT> build()

Builds an instance of the containing class. This operation is unsupported on the abstract base class UnaryCallSettings, but is valid on concrete derived classes.

Returns
Type	Description
UnaryCallSettings<RequestT,ResponseT>

getRetrySettings()

public RetrySettings getRetrySettings()

Returns an immutable RetrySettings currently set in this Builder.

Unlike #retrySettings(), objects returned by this method are frozen in time.

Returns
Type	Description
RetrySettings

getRetryableCodes()

public Set<StatusCode.Code> getRetryableCodes()

See the class documentation of UnaryCallSettings for a description of what retryable codes do.

Returns
Type	Description
Set<Code>

retrySettings()

public RetrySettings.Builder retrySettings()

Returns the underlying RetrySettings.Builder, which allows callers to augment the existing RetrySettings.

Returns
Type	Description
RetrySettings.Builder

setRetrySettings(RetrySettings retrySettings)

public UnaryCallSettings.Builder<RequestT,ResponseT> setRetrySettings(RetrySettings retrySettings)

Replaces the RetrySettings for the associated UnaryCallable.

When using the method, make sure that the RetrySettings are complete. For example, the following code will disable retries because the retry delay is not set:

 stubSettings.setRetrySettings(
   RetrySettings.newBuilder()
     .setTotalTimeout(Duration.ofSeconds(10)
 );
 

See Also: #retrySettings()

Parameter
Name	Description
retrySettings	RetrySettings

Returns
Type	Description
Builder<RequestT,ResponseT>

setRetryableCodes(StatusCode.Code[] codes)

public UnaryCallSettings.Builder<RequestT,ResponseT> setRetryableCodes(StatusCode.Code[] codes)

See the class documentation of UnaryCallSettings for a description of what retryable codes do.

Parameter
Name	Description
codes	Code[]

Returns
Type	Description
Builder<RequestT,ResponseT>

setRetryableCodes(Set<StatusCode.Code> retryableCodes)

public UnaryCallSettings.Builder<RequestT,ResponseT> setRetryableCodes(Set<StatusCode.Code> retryableCodes)

See the class documentation of UnaryCallSettings for a description of what retryable codes do.

Parameter
Name	Description
retryableCodes	Set<Code>

Returns
Type	Description
Builder<RequestT,ResponseT>

setSimpleTimeoutNoRetries(Duration timeout)

public UnaryCallSettings.Builder<RequestT,ResponseT> setSimpleTimeoutNoRetries(Duration timeout)

Obsolete

Use setSimpleTimeoutNoRetriesDuration(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 #setSimpleTimeoutNoRetriesDuration(java.time.Duration) instead.

Parameter
Name	Description
timeout	org.threeten.bp.Duration

Returns
Type	Description
Builder<RequestT,ResponseT>

setSimpleTimeoutNoRetriesDuration(Duration timeout)

public UnaryCallSettings.Builder<RequestT,ResponseT> setSimpleTimeoutNoRetriesDuration(Duration timeout)

Disables retries and sets the RPC timeout.

Parameter
Name	Description
timeout	Duration

Returns
Type	Description
Builder<RequestT,ResponseT>