SdkAdvancedAsyncClientOption (AWS Java SDK :: Bundle 2.25.23 API)

java.lang.Object
- software.amazon.awssdk.utils.AttributeMap.Key<T>
- - software.amazon.awssdk.core.client.config.ClientOption<T>
  - - software.amazon.awssdk.core.client.config.SdkAdvancedAsyncClientOption<T>

Type Parameters:

T - The type of value associated with the option.
```
public final class SdkAdvancedAsyncClientOption<T>
extends ClientOption<T>
```
A collection of advanced options that can be configured on an async AWS client via ClientAsyncConfiguration.Builder.advancedOption(SdkAdvancedAsyncClientOption, Object).
These options are usually not required outside of testing or advanced libraries, so most users should not need to configure them.

Nested Class Summary
- Nested classes/interfaces inherited from class software.amazon.awssdk.utils.AttributeMap.Key
  software.amazon.awssdk.utils.AttributeMap.Key.UnsafeValueType

Field Summary

Fields
Modifier and Type	Field	Description
`static SdkAdvancedAsyncClientOption<Executor>`	`FUTURE_COMPLETION_EXECUTOR`	Configure the `Executor` that should be used to complete the `CompletableFuture` that is returned by the async service client.

Method Summary
- Methods inherited from class software.amazon.awssdk.utils.AttributeMap.Key
  convertValue, toString
- Methods inherited from class java.lang.Object
  clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - FUTURE_COMPLETION_EXECUTOR
```
public static final SdkAdvancedAsyncClientOption<Executor> FUTURE_COMPLETION_EXECUTOR
```
    Configure the Executor that should be used to complete the CompletableFuture that is returned by the async service client. By default, this is a dedicated, per-client ThreadPoolExecutor that is managed by the SDK.
    The configured Executor will be invoked by the async HTTP client's I/O threads (e.g., EventLoops), which must be reserved for non-blocking behavior. Blocking an I/O thread can cause severe performance degradation, including across multiple clients, as clients are configured, by default, to share a single I/O thread pool (e.g., EventLoopGroup).
    You should typically only want to customize the future-completion Executor for a few possible reasons:
    
    You want more fine-grained control over the ThreadPoolExecutor used, such as configuring the pool size or sharing a single pool between multiple clients.
    You want to add instrumentation (i.e., metrics) around how the Executor is used.
    WARNING
    We strongly discourage using Runnable::run, which executes the future-completion directly from within the I/O thread because it may block the I/O thread and cause deadlock, especially if you are sending another SDK request in the CompletableFuture chain since the SDK may perform blocking calls in some cases.