Interface TransportChannelProvider (2.58.0)

Version 2.58.0

• 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 interface TransportChannelProvider

Provides an interface to either build a TransportChannel or provide a fixed TransportChannel that will be used to make calls to a service.

Implementations of TransportChannelProvider may choose to create a new TransportChannel for each call to #getTransportChannel, or may return a fixed TransportChannel instance.

Callers should use the following pattern to get a channel:

 TransportChannelProvider transportChannelProvider = ...;
 if (transportChannelProvider.needsHeaders()) {
   transportChannelProvider = transportChannelProvider.withHeaders(headers);
 }
 // optional: set executor for TransportChannel
 transportChannelProvider.withExecutor(executor);
 TransportChannel transportChannel = transportChannelProvider.getTransportChannel();
 

Methods

acceptsPoolSize() (deprecated)

public abstract boolean acceptsPoolSize()

Deprecated. Pool settings should be configured on the builder of the specific implementation.

Reports whether this provider allows pool size customization.

Returns
Type	Description
boolean

getEndpoint()

public default String getEndpoint()

User set custom endpoint for the Transport Channel Provider

This is the unresolved endpoint used by GAPICs

Returns
Type	Description
String

getTransportChannel()

public abstract TransportChannel getTransportChannel()

Provides a Transport, which could either be a new instance for every call, or the same instance, depending on the implementation.

If #needsExecutor() is true, then #withExecutor(Executor) needs to be called first to provide an executor.

If #needsHeaders() is true, then #withHeaders(Map) needs to be called first to provide headers.

if #needsEndpoint() is true, then #withEndpoint(String) needs to be called first to provide an endpoint.

Returns
Type	Description
TransportChannel

Exceptions
Type	Description
IOException

getTransportName()

public abstract String getTransportName()

The name of the transport.

This string can be used for identifying transports for switching logic.

Returns
Type	Description
String

needsCredentials()

public abstract boolean needsCredentials()

Beta

The surface to customize credentials 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.

True if credentials are needed before channel creation.

Returns
Type	Description
boolean

needsEndpoint()

public abstract boolean needsEndpoint()

True if the TransportProvider has no endpoint set.

Returns
Type	Description
boolean

needsExecutor() (deprecated)

public abstract boolean needsExecutor()

Deprecated. Channel providers will have default executors if they need one.

True if the TransportProvider needs an executor.

Returns
Type	Description
boolean

needsHeaders()

public abstract boolean needsHeaders()

True if the TransportProvider has no headers provided.

Returns
Type	Description
boolean

shouldAutoClose()

public abstract boolean shouldAutoClose()

Indicates whether the TransportChannel should be closed by the containing client class.

Returns
Type	Description
boolean

withCredentials(Credentials credentials)

public abstract TransportChannelProvider withCredentials(Credentials credentials)

Beta

The surface to customize credentials 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.

Sets the credentials that will be applied before channel creation.

Parameter
Name	Description
credentials	com.google.auth.Credentials

Returns
Type	Description
TransportChannelProvider

withEndpoint(String endpoint)

public abstract TransportChannelProvider withEndpoint(String endpoint)

Sets the endpoint to use when constructing a new TransportChannel.

This method should only be called if #needsEndpoint() returns true.

Parameter
Name	Description
endpoint	String

Returns
Type	Description
TransportChannelProvider

withExecutor(Executor executor)

public abstract TransportChannelProvider withExecutor(Executor executor)

Sets the executor to use when constructing a new TransportChannel.

Parameter
Name	Description
executor	Executor

Returns
Type	Description
TransportChannelProvider

withExecutor(ScheduledExecutorService executor) (deprecated)

public abstract TransportChannelProvider withExecutor(ScheduledExecutorService executor)

Deprecated. Please use #withExecutor(Executor).

Parameter
Name	Description
executor	ScheduledExecutorService

Returns
Type	Description
TransportChannelProvider

withHeaders(Map<String,String> headers)

public abstract TransportChannelProvider withHeaders(Map<String,String> headers)

Sets the headers to use when constructing a new TransportChannel.

This method should only be called if #needsHeaders() returns true.

Parameter
Name	Description
headers	Map<String,String>

Returns
Type	Description
TransportChannelProvider

withPoolSize(int size) (deprecated)

public abstract TransportChannelProvider withPoolSize(int size)

Deprecated. Pool settings should be configured on the builder of the specific implementation.

Number of underlying transport channels to open. Calls will be load balanced across them.

Parameter
Name	Description
size	int

Returns
Type	Description
TransportChannelProvider

withUseS2A(boolean useS2A)

public default TransportChannelProvider withUseS2A(boolean useS2A)

Sets whether to use S2A when constructing a new TransportChannel.

Parameter
Name	Description
useS2A	boolean

Returns
Type	Description
TransportChannelProvider