HTTP-Clients

Sie können den HTTP-Client ändern, der für Ihren Service-Client verwendet werden soll, sowie die Standardkonfiguration für HTTP-Clients mit dem ändern AWS SDK for Java 2.x. In diesem Abschnitt werden HTTP-Clients und Einstellungen für das SDK beschrieben.

Im SDK for Java verfügbare HTTP-Clients

Synchrone Clients

Synchrone HTTP-Clients im SDK for Java implementieren die SdkHttpClientSchnittstelle. Ein synchroner Dienstclient, wie der S3Client oder derDynamoDbClient, erfordert die Verwendung eines synchronen HTTP-Clients. Der AWS SDK for Java bietet drei synchrone HTTP-Clients.

ApacheHttpClient (Standard)

ApacheHttpClientist der Standard-HTTP-Client für synchrone Service-Clients. Hinweise zur Konfiguration von finden Sie ApacheHttpClient unterDen Apache-basierten HTTP-Client konfigurieren.

AwsCrtHttpClient

AwsCrtHttpClientbietet hohen Durchsatz und blockierungsfreie I/O. Es basiert auf dem AWS Common Runtime (CRT) Http Client. Hinweise zur Konfiguration AwsCrtHttpClient und Verwendung mit Service-Clients finden Sie unterAWS CRT-basierte HTTP-Clients konfigurieren.

UrlConnectionHttpClient

Um die Anzahl der von Ihrer Anwendung verwendeten JAR-Dateien und Bibliotheken von Drittanbietern zu minimieren, können Sie die verwenden UrlConnectionHttpClient. Hinweise zur Konfiguration von finden UrlConnectionHttpClient Sie unterDen URL-verbindungsbasierten HTTP-Client konfigurieren.

Asynchrone Clients

Asynchrone HTTP-Clients im SDK for Java implementieren die SdkAsyncHttpClientSchnittstelle. Ein asynchroner Dienstclient, wie der S3AsyncClient oder derDynamoDbAsyncClient, erfordert die Verwendung eines asynchronen HTTP-Clients. Der AWS SDK for Java bietet zwei asynchrone HTTP-Clients.

NettyNioAsyncHttpClient (Standard)

NettyNioAsyncHttpClientist der Standard-HTTP-Client, der von asynchronen Clients verwendet wird. Hinweise zur Konfiguration von finden Sie NettyNioAsyncHttpClient unterDen Netty-basierten HTTP-Client konfigurieren.

AwsCrtAsyncHttpClient

Der AwsCrtAsyncHttpClientbasiert auf dem AWS Common Runtime (CRT) -HTTP-Client. Hinweise zur Konfiguration von finden Sie AwsCrtAsyncHttpClient unterAWS CRT-basierte HTTP-Clients konfigurieren.

Empfehlungen für HTTP-Clients

Bei der Auswahl einer HTTP-Client-Implementierung spielen mehrere Faktoren eine Rolle. Verwenden Sie die folgenden Informationen als Entscheidungshilfe.

Flussdiagramm für Empfehlungen

Das folgende Flussdiagramm enthält allgemeine Hinweise, anhand derer Sie bestimmen können, welcher HTTP-Client verwendet werden soll.

Vergleich von HTTP-Clients

Die folgende Tabelle enthält detaillierte Informationen für jeden HTTP-Client.

HTTP-Client	Synchronisieren oder asynchron	Wann sollte dies verwendet werden?	Einschränkung/Nachteil
Apache-basierter HTTP-Client (Standard-Synchronisierungs-HTTP-Client)	Synchronisierung	Verwenden Sie ihn, wenn Sie eine niedrige Latenz einem hohen Durchsatz vorziehen	Langsamere Startzeit im Vergleich zu anderen HTTP-Clients
Auf URL-Verbindung basierender HTTP-Client	Synchronisierung	Verwenden Sie ihn, wenn Sie unbedingt die Abhängigkeiten von Drittanbietern einschränken möchten	Unterstützt nicht die HTTP-PATCH-Methode, die für einige APIS wie Amazon APIGateway-Aktualisierungsvorgänge erforderlich ist
AWS CRT-basierter Sync-HTTP-Client 1	Synchronisierung	• Verwenden Sie es, wenn Ihre Anwendung in läuft AWS Lambda • Verwenden Sie es, wenn Sie einen hohen Durchsatz einer niedrigen Latenz vorziehen • Verwenden Sie es, wenn Sie SDK-Clients synchronisieren möchten	N/A
Netty-basierter HTTP-Client (standardmäßiger asynchroner HTTP-Client)	Asynchron	• Verwenden Sie es, wenn Ihre Anwendung APIs aufruft, für die HTTP/2-Unterstützung erforderlich ist, z. B. die Kinesis-API SubscribeToShard	Langsamere Startzeit im Vergleich zu anderen HTTP-Clients
AWS CRT-basierter asynchroner HTTP-Client 1	Asynchron	• Verwenden Sie es, wenn Ihre Anwendung in läuft AWS Lambda • Verwenden Sie es, wenn Sie einen hohen Durchsatz einer niedrigen Latenz vorziehen • Verwenden Sie es, wenn Sie asynchrone SDK-Clients bevorzugen	• Unterstützt keine Service-Clients, die HTTP/2-Unterstützung benötigen, wie und KinesisAsynClient TranscribeStreamingAsyncClient

¹ Aufgrund ihrer zusätzlichen Vorteile empfehlen wir, wenn möglich die AWS CRT-basierten HTTP-Clients zu verwenden.

Standardeinstellungen für die intelligente Konfiguration

Die AWS SDK for Java 2.x (Version 2.17.102 oder höher) bietet eine Funktion für intelligente Standardeinstellungen für Konfigurationen. Diese Funktion optimiert zwei HTTP-Client-Eigenschaften zusammen mit anderen Eigenschaften, die den HTTP-Client nicht beeinflussen.

Die Standardeinstellungen der intelligenten Konfiguration legen sinnvolle Werte für die tlsNegotiationTimeoutInMillis Eigenschaften connectTimeoutInMillis und fest, die auf einem von Ihnen angegebenen Standardmoduswert basieren. Sie wählen den Standardmoduswert auf der Grundlage der Eigenschaften Ihrer Anwendung.

Weitere Informationen zu den Standardeinstellungen für intelligente Konfigurationen und zur Auswahl des Standardmoduswerts, der für Ihre Anwendungen am besten geeignet ist, finden Sie im Referenzhandbuch für AWS SDKs und Tools.

Im Folgenden finden Sie vier Möglichkeiten, den Standardmodus für Ihre Anwendung festzulegen.

Service client

Verwenden Sie den Service Client Builder, um den Standardmodus direkt auf dem Service Client zu konfigurieren. Im folgenden Beispiel wird der Standardmodus auto für den auf festgelegt. DynamoDbClient

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

System property

Sie können die aws.defaultsMode Systemeigenschaft verwenden, um den Standardmodus anzugeben. Wenn Sie die Systemeigenschaft in Java festlegen, müssen Sie die Eigenschaft festlegen, bevor Sie einen Service-Client initialisieren.

Das folgende Beispiel zeigt Ihnen, wie Sie den Standardmodus so einstellen, dass er eine in auto Java festgelegte Systemeigenschaft verwendet.

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

Das folgende Beispiel zeigt, wie Sie den Standardmodus auto mithilfe einer -D Option des Befehls auf „Standardmodus“ festlegen. java

java -Daws.defaultsMode=auto

Environment variable

Geben Sie einen Wert für die Umgebungsvariable einAWS_DEFAULTS_MODE, um den Standardmodus für Ihre Anwendung auszuwählen.

Die folgenden Informationen zeigen den Befehl, der ausgeführt werden muss, um den Wert für den Standardmodus auf die auto Verwendung einer Umgebungsvariablen festzulegen.

Betriebssystem	Befehl zum Setzen von Umgebungsvariablen
Linux, macOS oder Unix	export AWS_DEFAULTS_MODE=auto
Windows	set AWS_DEFAULTS_MODE=auto

AWS config file

Sie können der gemeinsam genutzten AWS config Datei eine defaults_mode Konfigurationseigenschaft hinzufügen, wie das folgende Beispiel zeigt.

[default]
defaults_mode = auto

Wenn Sie den Standardmodus global mit der Systemeigenschaft, der Umgebungsvariablen oder der AWS Konfigurationsdatei festlegen, können Sie die Einstellungen beim Erstellen eines HTTP-Clients überschreiben.

Wenn Sie mit httpClientBuilder() dieser Methode einen HTTP-Client erstellen, gelten die Einstellungen nur für die Instanz, die Sie gerade erstellen. Ein Beispiel dafür wird hier gezeigt. Der Netty-basierte HTTP-Client in diesem Beispiel überschreibt alle global für und festgelegten Standardmoduswerte. connectTimeoutInMillis tlsNegotiationTimeoutInMillis