Configuración de clientes de servicio en código para el AWS SDK for Java 2.x

Como alternativa a la configuración externa de los clientes de servicio, o además de ella, puede configurarlos mediante programación en código.

Al configurar los clientes de servicio en código, obtiene un control pormenorizado de las numerosas opciones disponibles. La mayoría de las configuraciones que puede configurar externamente también están disponibles en código.

Configuración básica en código

Por ejemplo, el siguiente fragmento establece el t Región de AWS EU_SOUTH_2 para un cliente de servicio Amazon S3 en el código:

S3Client s3Client = S3Client.builder()
        .region(Region.EU_SOUTH_2)
        .build();

El fragmento anterior muestra el método de fábrica estático,. builder() El método builder() devuelve un objeto builder que permite personalizar el cliente de servicio. Los métodos Fluent Setter devuelven el builder objeto (en este caso, una S3ClientBuilderinstancia) para que puedas encadenar las llamadas a los métodos por comodidad y para que el código sea más legible. Después de configurar las propiedades que desee, puede llamar al método build() para crear el cliente.

Configuración avanzada en código

El siguiente fragmento muestra opciones de configuración adicionales:

ClientOverrideConfiguration clientOverrideConfiguration =
        ClientOverrideConfiguration.builder()
                .apiCallAttemptTimeout(Duration.ofSeconds(1))
                .addMetricPublisher(CloudWatchMetricPublisher.create())
                .build();

S3Client s3Client = S3Client.builder()
        .region(Region.EU_SOUTH_2)
        .credentialsProvider(EnvironmentVariableCredentialsProvider.create())
        .overrideConfiguration(clientOverrideConfiguration)
        .httpClientBuilder(
                ApacheHttpClient.builder()
                        .maxConnections(100)
                        .connectionTimeout(Duration.ofSeconds(5))
                        .proxyConfiguration(ProxyConfiguration.builder()
                                .endpoint(URI.create("http://proxy:8080"))
                                .build())
        ).build();

En el fragmento anterior, puede ver varios puntos de entrada para configurar un cliente de servicio:

S3Client s3Client = S3Client.builder()
        .region(Region.EU_SOUTH_2)
        .credentialsProvider(EnvironmentVariableCredentialsProvider.create())
        .overrideConfiguration(b -> b
                .apiCallAttemptTimeout(Duration.ofSeconds(1))
                .addMetricPublisher(CloudWatchMetricPublisher.create()))
        .httpClientBuilder(ApacheHttpClient.builder()
                .maxConnections(100)
                .connectionTimeout(Duration.ofSeconds(5))
                .proxyConfiguration(ProxyConfiguration.builder()
                        .endpoint(URI.create("http://proxy:8080"))
                        .build()))
        .build();

Las opciones de configuración no están disponibles en el código

Como la siguiente configuración afecta a los procesos de inicialización fundamentales del SDK, puede establecer las siguientes opciones de configuración solo de forma externa y no en código:

Configuración de ubicación de archivos

Estos ajustes controlan la ubicación de los archivos de configuración y credenciales compartidos y no se pueden anular mediante programación una vez que el SDK los haya cargado:

Estos ajustes se deben establecer antes de que el SDK cargue los archivos de configuración, ya que determinan dónde busca el SDK la configuración. Una vez inicializado el SDK, el cambio de estos valores no tiene ningún efecto.

Desactivación del servicio de metadatos de la instancia

Esta configuración controla si el SDK intenta utilizar el servicio de metadatos de instancias o no. EC2 Una vez que el SDK se haya inicializado, no podrás cambiar esta configuración mediante programación.

Selección de perfil

Esta configuración indica al SDK qué perfil debe cargar desde los archivos de configuración y credenciales compartidos. Una vez cargado, el cambio de este valor no tiene ningún efecto.

Rutas de credenciales de contenedores

Estas variables de entorno se utilizan para indicar al SDK cómo obtener las credenciales de los servicios de contenedores. Una vez que se haya establecido la cadena de proveedores de credenciales durante la inicialización del cliente de servicio, no podrás cambiar esta configuración.

Selección de implementación HTTP predeterminada

Esta configuración global determina qué implementación de cliente HTTP usa el SDK para todos los clientes de servicio, a menos que se anule en el código para los clientes de servicio individuales. Debe configurarlos antes de que el SDK inicialice sus clientes HTTP y no se pueden cambiar posteriormente.