View a markdown version of this page

Configurar clientes HTTP no AWS SDK for Java 2.x - AWS SDK for Java 2.x
Clientes disponíveisRecomendações do clientePadrões inteligentes

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar clientes HTTP no AWS SDK for Java 2.x

É possível alterar o cliente HTTP a ser usado para o cliente de serviço, bem como alterar a configuração padrão para clientes HTTP com o AWS SDK for Java 2.x. Esta seção discute os clientes HTTP e as configurações do SDK.

Clientes HTTP disponíveis no SDK para Java

Clientes síncronos

Clientes HTTP síncronos no SDK para Java implementam a SdkHttpClient interface. Um cliente de serviço síncrono, como o S3Client ou o DynamoDbClient, requer o uso de um cliente HTTP síncrono. O AWS SDK para Java oferece três clientes HTTP síncronos.

Apache5HttpClient (padrão)

Apache5HttpClienté uma versão atualizada ApacheHttpClient que é construída no Apache HttpClient 5.x. A versão 5.x é a versão mantida ativamente pelo Apache e melhora a versão anterior usada, ApacheHttpClient trazendo compatibilidade com o ecossistema Java moderno, incluindo suporte a threads virtuais para Java 21 e maior flexibilidade de registro por meio do SLF4J. Apache5HttpClientsubstituído ApacheHttpClient como o cliente síncrono padrão na versão 2.46.0 do AWS SDK para Java 2.x. Ele tem uma API e recursos idênticos, o que o torna ideal como substituto imediato. Para obter mais informações sobre a configuração do Apache5HttpClient, consulte Configurar o cliente HTTP baseado em Apache 5.x.

ApacheHttpClient
nota

ApacheHttpClientestá obsoleto porque o Apache HttpClient 4.x está em modo de manutenção. Use o baseado em Apache HttpClient 5.x. Apache5HttpClient

ApacheHttpClienté construído no Apache HttpClient 4.x. Para obter mais informações sobre a configuração do ApacheHttpClient, consulte Configurar o cliente Apache-based HTTP.

AwsCrtHttpClient

AwsCrtHttpClientfornece alta taxa de transferência e E/S sem bloqueio. Ele é construído no AWS Common Runtime (CRT) Http Client. Para receber informações sobre como configurar o AwsCrtHttpClient e usá-lo com clientes de serviço, consulte Configurar clientes AWS HTTP baseados em CRT.

UrlConnectionHttpClient

Para minimizar o número de jars e bibliotecas de terceiros que seu aplicativo usa, você pode usar o. UrlConnectionHttpClient Para obter mais informações sobre a configuração do UrlConnectionHttpClient, consulte Configurar o cliente HTTP URLConnection baseado.

Clientes assíncronos

Clientes HTTP assíncronos no SDK para Java implementam a interface. SdkAsyncHttpClient Um cliente de serviço assíncrono, como o S3AsyncClient ou o DynamoDbAsyncClient, requer o uso de um cliente HTTP assíncrono. O AWS SDK para Java oferece dois clientes HTTP assíncronos.

NettyNioAsyncHttpClient (padrão)

NettyNioAsyncHttpClienté o cliente HTTP padrão usado por clientes assíncronos. Para obter mais informações sobre a configuração do NettyNioAsyncHttpClient, consulte Configurar o cliente HTTP baseado em Netty.

AwsCrtAsyncHttpClient

O AwsCrtAsyncHttpClient é baseado no cliente HTTP AWS Common Runtime (CRT). Para obter mais informações sobre a configuração do AwsCrtAsyncHttpClient, consulte Configurar clientes AWS HTTP baseados em CRT.

Recomendações do cliente HTTP

Diversos fatores entram em cena quando você escolhe uma implementação de cliente HTTP. Use as informações a seguir para ajudá-lo a decidir.

Comparação de clientes HTTP

A tabela a seguir contém informações detalhadas para cada cliente HTTP.

Cliente HTTP Síncrono ou assíncrono Quando usar Limitation/drawback
Cliente HTTP baseado em Apache 5.x

(cliente HTTP síncrono padrão)

 Síncrono Use-o se você preferir baixa latência em vez de alta taxa de transferência Tempo de inicialização mais lento em comparação com outros clientes HTTP
URLConnection-based Cliente HTTP Sincronização Use-o se você tiver um requisito rígido de limitar dependências de terceiros

• Não suporta o método HTTP PATCH, exigido por algumas APIs, como as operações de atualização do Amazon APIGateway

• Não suporta um tempo limite de conexão inativa configurável. Consulte Configurar o cliente URLConnection-based HTTP para obter detalhes.
AWS CRT-based cliente HTTP de sincronização 1 Sincronização

• Use-o se seu aplicativo estiver sendo executado em AWS Lambda

• Use-o se você preferir alta taxa de transferência em vez de baixa latência

• Use-o se preferir clientes do SDK síncronos.

As seguintes propriedades do sistema Java não são compatíveis:

  • javax.net.ssl.keyStore

  • javax.net.ssl.key StorePassword

  • javax.net.ssl.trustStore

  • javax.net.ssl.trust StorePassword
Netty-based Cliente HTTP

(cliente HTTP síncrono padrão)

 Assíncrono

• Use-o se seu aplicativo depender das propriedades do sistema Java para configuração de TLS (como) javax.net.ssl.keyStore

 Tempo de inicialização mais lento em comparação com outros clientes HTTP
AWS CRT-based cliente HTTP assíncrono 1 Assíncrono

• Use-o se seu aplicativo estiver sendo executado no AWS Lambda

• Use-o se você preferir alta taxa de transferência em vez de baixa latência

• Use-o se preferir clientes do SDK assíncronos.

As seguintes propriedades do sistema Java não são compatíveis:

  • javax.net.ssl.keyStore

  • javax.net.ssl.key StorePassword

  • javax.net.ssl.trustStore

  • javax.net.ssl.trust StorePassword

1 Por causa de seus benefícios adicionais, recomendamos que você use os clientes AWS CRT-based HTTP, se possível.

Padrões de configuração inteligentes

O AWS SDK for Java 2.x (versão 2.17.102 ou posterior) oferece um recurso inteligente de padrões de configuração. Esse recurso otimiza duas propriedades do cliente HTTP além de outras propriedades que não afetam o cliente HTTP.

Os padrões de configuração inteligentes definem valores razoáveis para as propriedades connectTimeoutInMillis e tlsNegotiationTimeoutInMillis com base em um valor de modo padrão fornecido por você. Você escolhe o valor de modo padrão com base nas características do seu aplicativo.

Para obter mais informações sobre padrões de configuração inteligentes e como escolher o valor do modo padrão mais adequado para seus aplicativos, consulte o Guia de referência de SDKs e ferramentas da AWS.

A seguir estão quatro maneiras de definir o modo padrão para seu aplicativo.

Service client

Use o builder do cliente de serviço para configurar o modo padrão diretamente no cliente de serviço. O exemplo a seguir define o modo padrão como auto para o DynamoDbClient.

DynamoDbClient ddbClient = DynamoDbClient.builder()
                            .defaultsMode(DefaultsMode.AUTO)
                            .build();
System property

Você pode usar a propriedade aws.defaultsMode do sistema para especificar o modo padrão. Se você definir a propriedade do sistema em Java, precisará defini-la antes de inicializar qualquer cliente de serviço.

O exemplo a seguir mostra como definir o modo padrão como auto usando uma propriedade do sistema definida em Java.

System.setProperty("aws.defaultsMode", "auto");

O exemplo a seguir demonstra como definir o modo padrão como auto usando uma opção -D do comando java.

java -Daws.defaultsMode=auto
Environment variable

Defina um valor para a variável de ambiente AWS_DEFAULTS_MODE para selecionar o modo padrão para o seu aplicativo.

As informações a seguir mostram o comando a ser executado para definir o valor do modo padrão como auto usando uma variável de ambiente.

Sistema operacional Comando para definir variáveis de ambiente

Linux, macOS ou Unix

 export AWS_DEFAULTS_MODE=auto

Windows

 set AWS_DEFAULTS_MODE=auto
AWS config file

Você pode adicionar uma propriedade defaults_mode de configuração ao AWS config arquivo compartilhado, conforme mostrado no exemplo a seguir.

[default]
defaults_mode = auto

Se você definir o modo padrão globalmente com a propriedade do sistema, a variável de ambiente ou o arquivo config da AWS , poderá substituir as configurações ao criar um cliente HTTP.

Quando você cria um cliente HTTP com o método httpClientBuilder(), as configurações se aplicam somente à instância que você está criando. Um exemplo disso é mostrado aqui. O cliente Netty-based HTTP neste exemplo substitui todos os valores de modo padrão definidos globalmente para e. connectTimeoutInMillis tlsNegotiationTimeoutInMillis