HTTP 客户端 - AWS SDK for Java 2.x

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

HTTP 客户端

您可以使用 AWS SDK for Java 2.x更改用于服务客户端的 HTTP 客户端,也可以更改 HTTP 客户端的默认配置。本部分讨论 SDK 的 HTTP 客户端和设置。

SDK for Java 中可用的 HTTP 客户端

同步客户端

适用于 Java 的 SDK 中的同步 HTTP 客户端实现了该SdkHttpClient接口。同步服务客户端(例如 S3ClientDynamoDbClient)需要使用同步 HTTP 客户端。 AWS SDK for Java 提供了三个同步 HTTP 客户端。

ApacheHttpClient (默认)

ApacheHttpClient是同步服务客户端的默认 HTTP 客户端。有关配置 ApacheHttpClient 的信息,请参阅配置基于 Apache 的 HTTP 客户端

AwsCrtHttpClient

AwsCrtHttpClient提供高吞吐量和无阻塞 IO。它建立在 AWS 通用运行时 (CRT) Http 客户端之上。有关配置 AwsCrtHttpClient 并将其用于服务客户端的信息,请参阅配置 AWS 基于 CRT 的 HTTP 客户

UrlConnectionHttpClient

要最大限度地减少应用程序使用的 jar 和第三方库的数量,可以使用。UrlConnectionHttpClient有关配置 UrlConnectionHttpClient 的信息,请参阅配置基于 URLConnection 的 HTTP 客户端

异步客户端

适用于 Java 的 SDK 中的异步 HTTP 客户端实现了该SdkAsyncHttpClient接口。异步服务客户端(例如 S3AsyncClientDynamoDbAsyncClient)需要使用异步 HTTP 客户端。 AWS SDK for Java 提供了两个异步 HTTP 客户端。

NettyNioAsyncHttpClient (默认)

NettyNioAsyncHttpClient是异步客户端使用的默认 HTTP 客户端。有关配置 NettyNioAsyncHttpClient 的信息,请参阅配置基于 Netty 的 HTTP 客户端

AwsCrtAsyncHttpClient

基于 AWS 通用运行时 (CRT) HTTP 客户端。AwsCrtAsyncHttpClient有关配置 AwsCrtAsyncHttpClient 的信息,请参阅配置 AWS 基于 CRT 的 HTTP 客户

HTTP 客户端建议

选择 HTTP 客户端实现时,应考虑几个因素。以下信息可帮助您做出决定。

建议流程图

以下流程图提供了一般指导,有助于确定使用哪个 HTTP 客户端。

HTTP 客户端建议流程图。

HTTP 客户端比较

下表提供了各 HTTP 客户端的详细信息。

HTTP 客户端 同步还是异步 何时使用 限制/缺点
基于 Apache 的 HTTP 客户端

(默认同步 HTTP 客户端)

同步 如果您更需要低延迟而不是高吞吐量,请使用它 与其他 HTTP 客户端相比,启动较慢
基于 URLConnection 的 HTTP 客户端 同步 如果您对限制第三方依赖项有硬性要求,请使用它 不支持某些 API(例如 Amazon API Gateway 的 Update 操作)所要求的 HTTP PATCH 方法
AWS 基于 CRT 同步的 HTTP 客户端 1 同步

• 如果您的应用程序正在中运行,请使用它 AWS Lambda

• 如果您更需要高吞吐量而不是低延迟,请使用它

• 如果您更喜欢同步 SDK 客户端,请使用它

不适用
基于 Netty 的 HTTP 客户端

(默认异步 HTTP 客户端)

异步

• 如果您的应用程序调用需要 HTTP/2 支持的 API(例如 Kinesis API),请使用它 SubscribeToShard

与其他 HTTP 客户端相比,启动较慢
AWS 基于 CRT 的异步 HTTP 客户端 1 异步

• 如果您的应用程序在 AWS Lambda中运行,请使用它

• 如果您更需要高吞吐量而不是低延迟,请使用它

• 如果您更喜欢异步 SDK 客户端,请使用它

• 不支持需要 HTTP/2 支持的服务客户端,例如 KinesisAsynClientTranscribeStreamingAsyncClient

1 由于基于 CRT 的 HTTP 客户端,我们建议您尽可能使用 AWS 基于 CRT 的 HTTP 客户端。

智能配置默认值

AWS SDK for Java 2.x (版本 2.17.102 或更高版本)提供智能配置默认功能。此功能优化了 HTTP 客户端的两个属性以及不影响 HTTP 客户端的其他属性。

智能配置默认值会根据您提供的默认模式值,为 connectTimeoutInMillistlsNegotiationTimeoutInMillis 属性设置合理的值。您可以根据应用程序的特性选择默认模式值。

有关智能配置默认值以及如何选择最适合应用程序的默认模式值的更多信息,请参阅 AWS SDKs and Tools Reference Guide

以下是为应用程序设置默认模式的四种方法。

Service client

使用服务客户端生成器直接在服务客户端上配置默认模式。以下示例将 DynamoDbClient 的默认模式设置为 auto

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

您可以使用 aws.defaultsMode 系统属性来指定默认模式。如果在 Java 中设置系统属性,则需要在初始化任何服务客户端之前设置该属性。

以下示例演示了如何使用在 Java 中设置的系统属性将默认模式设置为 auto

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

以下示例演示了如何使用 java 命令的 -D 选项将默认模式设置为 auto

java -Daws.defaultsMode=auto
Environment variable

为环境变量 AWS_DEFAULTS_MODE 设置一个值以选择应用程序的默认模式。

以下信息显示了使用环境变量将默认模式的值设置为 auto 时,所运行的命令。

操作系统 设置环境变量的命令

Linux、macOS 或 Unix

export AWS_DEFAULTS_MODE=auto

Windows

set AWS_DEFAULTS_MODE=auto
AWS config file

您可以向共享 AWS config文件添加defaults_mode配置属性,如下例所示。

[default] defaults_mode = auto

如果您使用系统属性、环境变量或 AWS 配置文件在全局范围内设置了默认模式,则在生成 HTTP 客户端时可以覆盖这些设置。

使用 httpClientBuilder() 方法生成 HTTP 客户端时,设置仅适用于您正在生成的实例。此处显示了此方法一个示例。本示例中基于 Netty 的 HTTP 客户端会覆盖在全局范围内为 connectTimeoutInMillistlsNegotiationTimeoutInMillis 设置的任何默认模式值。