Class MixedRealityStsClientBuilder
- All Implemented Interfaces:
AzureKeyCredentialTrait<MixedRealityStsClientBuilder>
,ConfigurationTrait<MixedRealityStsClientBuilder>
,EndpointTrait<MixedRealityStsClientBuilder>
,HttpTrait<MixedRealityStsClientBuilder>
,TokenCredentialTrait<MixedRealityStsClientBuilder>
MixedRealityStsClients
and MixedRealityStsAsyncClient
, call buildClient
and buildAsyncClient
respectively to construct an instance of
the desired client.-
Constructor Summary
ConstructorDescriptionConstructs a new builder used to configure and buildMixedRealityStsClients
andMixedRealityStsAsyncClients
. -
Method Summary
Modifier and TypeMethodDescriptionaccountDomain
(String accountDomain) Sets the Mixed Reality service account domain.Sets the Mixed Reality service account identifier.addPolicy
(HttpPipelinePolicy customPolicy) Adds apipeline policy
to apply on each request sent.Create aMixedRealityStsAsyncClient
based on options set in the builder.Create aMixedRealityStsClient
based on options set in the builder.clientOptions
(ClientOptions clientOptions) Allows for setting common properties such as application ID, headers, proxy configuration, etc.configuration
(Configuration configuration) Sets the configuration store that is used during construction of the service client.credential
(AzureKeyCredential keyCredential) Sets theAzureKeyCredential
used to authenticate HTTP requests.credential
(TokenCredential tokenCredential) Sets theTokenCredential
used to authorize requests sent to the service.Sets the Mixed Reality STS service endpoint.httpClient
(HttpClient client) Sets theHttpClient
to use for sending and receiving requests to and from the service.httpLogOptions
(HttpLogOptions logOptions) Sets thelogging configuration
to use when sending and receiving requests to and from the service.pipeline
(HttpPipeline pipeline) Sets theHttpPipeline
to use for the service client.retryOptions
(RetryOptions retryOptions) Sets theRetryOptions
for all the requests made through the client.retryPolicy
(RetryPolicy retryPolicy) Sets theRetryPolicy
that is used to retry requests.Sets theMixedRealityStsServiceVersion
that is used when making API requests.
-
Constructor Details
-
MixedRealityStsClientBuilder
public MixedRealityStsClientBuilder()Constructs a new builder used to configure and buildMixedRealityStsClients
andMixedRealityStsAsyncClients
.
-
-
Method Details
-
accountDomain
Sets the Mixed Reality service account domain.- Parameters:
accountDomain
- The Mixed Reality service account domain.- Returns:
- The updated
MixedRealityStsClientBuilder
object. - Throws:
IllegalArgumentException
- IfaccountDomain
is null or empty.
-
accountId
Sets the Mixed Reality service account identifier.- Parameters:
accountId
- The Mixed Reality service account identifier. The value is expected to be in UUID format.- Returns:
- The updated
MixedRealityStsClientBuilder
object. - Throws:
IllegalArgumentException
- IfaccountId
is null or empty.
-
addPolicy
Adds apipeline policy
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 noHttpPipeline
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 anHttpPipeline
is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.- Specified by:
addPolicy
in interfaceHttpTrait<MixedRealityStsClientBuilder>
- Parameters:
customPolicy
- Apipeline policy
.- Returns:
- The updated
MixedRealityStsClientBuilder
object.
-
buildClient
Create aMixedRealityStsClient
based on options set in the builder. Every timebuildClient()
is called a new instance ofMixedRealityStsClient
is created.- Returns:
- A
MixedRealityStsClient
with the options set from the builder. - Throws:
IllegalStateException
- If bothretryOptions(RetryOptions)
andretryPolicy(RetryPolicy)
have been set.
-
buildAsyncClient
Create aMixedRealityStsAsyncClient
based on options set in the builder. Every timebuildAsyncClient()
is called a new instance ofMixedRealityStsAsyncClient
is created.- Returns:
- A
MixedRealityStsAsyncClient
with the options set from the builder. - Throws:
NullPointerException
- If any required values are null.IllegalArgumentException
- If the accountId or endpoint are not properly formatted.IllegalStateException
- If bothretryOptions(RetryOptions)
andretryPolicy(RetryPolicy)
have been set.
-
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 theHttpClientOptions
class (a subclass of theClientOptions
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 noHttpPipeline
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 anHttpPipeline
is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.- Specified by:
clientOptions
in interfaceHttpTrait<MixedRealityStsClientBuilder>
- Parameters:
clientOptions
- A configured instance ofHttpClientOptions
.- Returns:
- The updated
MixedRealityStsClientBuilder
object. - See Also:
-
credential
Sets theTokenCredential
used to authorize requests sent to the service. Refer to the Azure SDK for Java identity and authentication documentation for more details on proper usage of theTokenCredential
type.- Specified by:
credential
in interfaceTokenCredentialTrait<MixedRealityStsClientBuilder>
- Parameters:
tokenCredential
-TokenCredential
used to authorize requests sent to the service.- Returns:
- The updated
MixedRealityStsClientBuilder
object. - Throws:
NullPointerException
- IftokenCredential
is null.
-
credential
Sets theAzureKeyCredential
used to authenticate HTTP requests.Note: Not recommended for production applications.
- Specified by:
credential
in interfaceAzureKeyCredentialTrait<MixedRealityStsClientBuilder>
- Parameters:
keyCredential
- TheAzureKeyCredential
used to authenticate HTTP requests.- Returns:
- The updated
MixedRealityStsClientBuilder
object. - Throws:
NullPointerException
- IfkeyCredential
is null.
-
configuration
Sets the configuration store that is used during construction of the service client. The default configuration store is a clone of theglobal configuration store
, useConfiguration.NONE
to bypass using configuration settings during construction.- Specified by:
configuration
in interfaceConfigurationTrait<MixedRealityStsClientBuilder>
- Parameters:
configuration
- The configuration store used to- Returns:
- The updated MixedRealityStsClientBuilder object.
-
endpoint
Sets the Mixed Reality STS service endpoint.- Specified by:
endpoint
in interfaceEndpointTrait<MixedRealityStsClientBuilder>
- Parameters:
endpoint
- The Mixed Reality STS service endpoint.- Returns:
- The updated MixedRealityStsClientBuilder object.
- Throws:
IllegalArgumentException
- Ifendpoint
is null or it cannot be parsed into a valid URL.
-
httpClient
Sets theHttpClient
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 noHttpPipeline
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 anHttpPipeline
is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.- Specified by:
httpClient
in interfaceHttpTrait<MixedRealityStsClientBuilder>
- Parameters:
client
- TheHttpClient
to use for requests.- Returns:
- The updated ConfigurationClientBuilder object.
-
httpLogOptions
Sets thelogging configuration
to use when sending and receiving requests to and from the service. If alogLevel
is not provided, default value ofHttpLogDetailLevel.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 noHttpPipeline
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 anHttpPipeline
is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.- Specified by:
httpLogOptions
in interfaceHttpTrait<MixedRealityStsClientBuilder>
- Parameters:
logOptions
- Thelogging configuration
to use when sending and receiving requests to and from the service.- Returns:
- The updated
MixedRealityStsClientBuilder
object.
-
pipeline
Sets theHttpPipeline
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 noHttpPipeline
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 anHttpPipeline
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 fromendpoint
to buildMixedRealityStsAsyncClient
orMixedRealityStsClient
.- Specified by:
pipeline
in interfaceHttpTrait<MixedRealityStsClientBuilder>
- Parameters:
pipeline
-HttpPipeline
to use for sending service requests and receiving responses.- Returns:
- The updated
MixedRealityStsClientBuilder
object.
-
retryPolicy
Sets theRetryPolicy
that is used to retry requests.The default retry policy will be used if not provided
buildAsyncClient()
to buildMixedRealityStsAsyncClient
orMixedRealityStsClient
.Setting this is mutually exclusive with using
retryOptions(RetryOptions)
.- Parameters:
retryPolicy
- TheRetryPolicy
that will be used to retry requests.- Returns:
- The updated MixedRealityStsClientBuilder object.
-
retryOptions
Sets theRetryOptions
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 noHttpPipeline
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 anHttpPipeline
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)
.- Specified by:
retryOptions
in interfaceHttpTrait<MixedRealityStsClientBuilder>
- Parameters:
retryOptions
- TheRetryOptions
to use for all the requests made through the client.- Returns:
- The updated MixedRealityStsClientBuilder object.
-
serviceVersion
Sets theMixedRealityStsServiceVersion
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 the client library will have the result of potentially moving to a newer service version.
- Parameters:
version
-MixedRealityStsServiceVersion
of the service to be used when making requests.- Returns:
- The updated ConfigurationClientBuilder object.
-