ChatThreadClientBuilder Class
- java.
lang. Object - com.
azure. communication. chat. ChatThreadClientBuilder
- com.
Implements
public final class ChatThreadClientBuilder
implements ConfigurationTrait<ChatThreadClientBuilder>, EndpointTrait<ChatThreadClientBuilder>, HttpTrait<ChatThreadClientBuilder>
Builder for creating clients of Azure Communication Service Chat Threads
Constructor Summary
| Constructor | Description |
|---|---|
| ChatThreadClientBuilder() |
Creates a new instance of ChatThreadClientBuilder. |
Method Summary
| Modifier and Type | Method and Description |
|---|---|
|
Chat |
addPolicy(HttpPipelinePolicy customPolicy)
Adds a HttpPipelinePolicy to apply on each request sent. |
|
Chat |
buildAsyncClient()
Create asynchronous chat thread client applying Communication |
|
Chat |
buildClient()
Create synchronous chat thread client applying Communication |
|
Chat |
chatThreadId(String chatThreadId)
Sets the Chat |
|
Chat |
clientOptions(ClientOptions clientOptions)
Allows for setting common properties such as application ID, headers, proxy configuration, etc. |
|
Chat |
configuration(Configuration configuration)
Sets the configuration object used to retrieve environment configuration values during building of the client. |
|
Chat |
credential(CommunicationTokenCredential communicationTokenCredential)
Set a token credential for authorization |
|
Chat |
endpoint(String endpoint)
Set endpoint of the service |
|
Chat |
httpClient(HttpClient httpClient)
Sets the HttpClient to use for sending and receiving requests to and from the service. |
|
Chat |
httpLogOptions(HttpLogOptions logOptions)
Sets the HttpLogOptions to use when sending and receiving requests to and from the service. |
|
Chat |
pipeline(HttpPipeline httpPipeline)
Sets the HttpPipeline to use for the service client. |
|
Chat |
retryOptions(RetryOptions retryOptions)
Sets the RetryOptions for all the requests made through the client. |
|
Chat |
retryPolicy(RetryPolicy retryPolicy)
Sets the HttpPipelinePolicy that will attempt to retry requests when needed. |
|
Chat |
serviceVersion(ChatServiceVersion version)
Sets the ChatServiceVersion that is used when making API requests. |
Methods inherited from java.lang.Object
Constructor Details
ChatThreadClientBuilder
public ChatThreadClientBuilder()
Creates a new instance of ChatThreadClientBuilder.
Method Details
addPolicy
public ChatThreadClientBuilder addPolicy(HttpPipelinePolicy customPolicy)
Adds a HttpPipelinePolicy to apply on each request sent.
Note: It is important to understand the precedence order of the HttpTrait APIs. In particular, if a HttpPipeline is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no HttpPipeline is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an HttpPipeline is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.
Parameters:
Returns:
buildAsyncClient
public ChatThreadAsyncClient buildAsyncClient()
Create asynchronous chat thread client applying CommunicationTokenCredential, UserAgentPolicy, RetryPolicy, and CookiePolicy. Additional HttpPolicies specified by additionalPolicies will be applied after them
Returns:
buildClient
public ChatThreadClient buildClient()
Create synchronous chat thread client applying CommunicationTokenCredential, UserAgentPolicy, RetryPolicy, and CookiePolicy. Additional HttpPolicies specified by additionalPolicies will be applied after them
Returns:
chatThreadId
public ChatThreadClientBuilder chatThreadId(String chatThreadId)
Sets the ChatThreadId used to construct a client for this chat thread.
Parameters:
Returns:
clientOptions
public ChatThreadClientBuilder clientOptions(ClientOptions clientOptions)
Allows for setting common properties such as application ID, headers, proxy configuration, etc. Note that it is recommended that this method be called with an instance of the HttpClientOptions class (a subclass of the ClientOptions base class). The HttpClientOptions subclass provides more configuration options suitable for HTTP clients, which is applicable for any class that implements this HttpTrait interface.
Note: It is important to understand the precedence order of the HttpTrait APIs. In particular, if a HttpPipeline is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no HttpPipeline is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an HttpPipeline is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.
Parameters:
Returns:
configuration
public ChatThreadClientBuilder configuration(Configuration configuration)
Sets the configuration object used to retrieve environment configuration values during building of the client.
Parameters:
Returns:
credential
public ChatThreadClientBuilder credential(CommunicationTokenCredential communicationTokenCredential)
Set a token credential for authorization
Parameters:
Returns:
endpoint
public ChatThreadClientBuilder endpoint(String endpoint)
Set endpoint of the service
Parameters:
Returns:
httpClient
public ChatThreadClientBuilder httpClient(HttpClient httpClient)
Sets the HttpClient to use for sending and receiving requests to and from the service.
Note: It is important to understand the precedence order of the HttpTrait APIs. In particular, if a HttpPipeline is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no HttpPipeline is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an HttpPipeline is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.
Parameters:
Returns:
httpLogOptions
public ChatThreadClientBuilder httpLogOptions(HttpLogOptions logOptions)
Sets the HttpLogOptions to use when sending and receiving requests to and from the service. If a logLevel is not provided, default value of HttpLogDetailLevel#NONE is set.
Note: It is important to understand the precedence order of the HttpTrait APIs. In particular, if a HttpPipeline is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no HttpPipeline is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an HttpPipeline is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.
Parameters:
Returns:
pipeline
public ChatThreadClientBuilder pipeline(HttpPipeline httpPipeline)
Sets the HttpPipeline to use for the service client.
Note: It is important to understand the precedence order of the HttpTrait APIs. In particular, if a HttpPipeline is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no HttpPipeline is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an HttpPipeline is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.
If pipeline is set, all other settings are ignored, aside from endpoint(String endpoint).
Parameters:
Returns:
retryOptions
public ChatThreadClientBuilder retryOptions(RetryOptions retryOptions)
Sets the RetryOptions for all the requests made through the client.
Note: It is important to understand the precedence order of the HttpTrait APIs. In particular, if a HttpPipeline is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no HttpPipeline is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an HttpPipeline is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.
Setting this is mutually exclusive with using retryPolicy(RetryPolicy retryPolicy).
Parameters:
Returns:
retryPolicy
public ChatThreadClientBuilder retryPolicy(RetryPolicy retryPolicy)
Sets the HttpPipelinePolicy that will attempt to retry requests when needed.
A default retry policy will be supplied if one isn't provided.
Setting this is mutually exclusive with using retryOptions(RetryOptions retryOptions).
Parameters:
Returns:
serviceVersion
public ChatThreadClientBuilder serviceVersion(ChatServiceVersion version)
Sets the ChatServiceVersion that is used when making API requests.
If a service version is not provided, the service version that will be used will be the latest known service version based on the version of the client library being used. If no service version is specified, updating to a newer version of the client library will have the result of potentially moving to a newer service version.
Targeting a specific service version may also mean that the service will return an error for newer APIs.
Parameters:
Returns: