Konfiguration von Service-Clients im Code für AWS SDK for Java 2.x

Als Alternative oder zusätzlich zur externen Konfiguration von Service-Clients können Sie sie programmgesteuert im Code konfigurieren.

Durch die Konfiguration von Service-Clients im Code erhalten Sie eine detaillierte Kontrolle über die vielen Optionen, die Ihnen zur Verfügung stehen. Die meisten Konfigurationen, die Sie extern festlegen können, stehen Ihnen auch zur Verfügung, um sie im Code festzulegen.

Grundkonfiguration im Code

Der folgende Codeausschnitt setzt beispielsweise den AWS-Region Wert EU_SOUTH_2 für einen Amazon S3-Serviceclient im Code:

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

Das vorherige Snippet zeigt die statische Factory-Methode,. builder() Die builder() Methode gibt ein builder Objekt zurück, mit dem Sie den Service-Client anpassen können. Die Fluent-Setter-Methoden geben das builder Objekt — in diesem Fall eine S3ClientBuilderInstanz — zurück, sodass Sie die Methodenaufrufen der Einfachheit halber und für besser lesbaren Code verketten können. Nachdem Sie die gewünschten Eigenschaften konfiguriert haben, rufen Sie die Methode auf, um den Client zu erstellen. build()

Erweiterte Konfiguration im Code

Das folgende Snippet zeigt zusätzliche Konfigurationsoptionen:

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();

Im vorherigen Snippet sehen Sie mehrere Einstiegspunkte für die Konfiguration eines Service-Clients:

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();

Konfigurationsoptionen sind im Code nicht verfügbar

Da sich die folgenden Einstellungen auf grundlegende Initialisierungsprozesse im SDK auswirken, können Sie die folgenden Konfigurationseinstellungen nur extern und nicht im Code festlegen:

Einstellungen für den Speicherort der Datei

Diese Einstellungen steuern den Speicherort der gemeinsam genutzten Konfigurations- und Anmeldeinformationsdateien und können nicht programmgesteuert außer Kraft gesetzt werden, nachdem das SDK sie geladen hat:

Diese Einstellungen müssen festgelegt werden, bevor das SDK die Konfigurationsdateien lädt, da sie bestimmen, wo das SDK nach der Konfiguration sucht. Sobald das SDK initialisiert wurde, hat eine Änderung dieser Werte keine Auswirkung.

Deaktivierung des Instanz-Metadatendienstes

Diese Einstellung steuert, ob das SDK versucht, den Instanz-Metadatendienst überhaupt zu verwenden. EC2 Sobald das SDK initialisiert wurde, können Sie diese Einstellung nicht programmgesteuert ändern.

Auswahl des Profils

Diese Einstellung teilt dem SDK mit, welches Profil aus den gemeinsam genutzten Konfigurations- und Anmeldeinformationsdateien geladen werden soll. Nach dem Laden hat die Änderung dieses Werts keine Auswirkung.

Pfade für Container-Anmeldeinformationen

Sie verwenden diese Umgebungsvariablen, um dem SDK mitzuteilen, wie Anmeldeinformationen von Containerdiensten abgerufen werden sollen. Nachdem die Anmeldeinformationsanbieterkette während der Initialisierung des Service Clients eingerichtet wurde, können Sie diese Einstellungen nicht mehr ändern.

Auswahl der standardmäßigen HTTP-Implementierung

Diese globalen Einstellungen bestimmen, welche HTTP-Client-Implementierung das SDK für alle Service-Clients verwendet, sofern sie nicht im Code für einzelne Service-Clients überschrieben werden. Sie müssen diese Einstellungen festlegen, bevor das SDK seine HTTP-Clients initialisiert. Sie können danach nicht mehr geändert werden.