Mengkonfigurasi klien layanan dalam kode untuk AWS SDK for Java 2.x

Sebagai alternatif untuk—atau selain— mengkonfigurasi klien layanan secara eksternal, Anda dapat mengonfigurasinya secara terprogram dalam kode.

Dengan mengonfigurasi klien layanan dalam kode, Anda mendapatkan kontrol halus dari banyak opsi yang tersedia untuk Anda. Sebagian besar konfigurasi yang dapat Anda atur secara eksternal juga tersedia untuk Anda atur dalam kode.

Konfigurasi dasar dalam kode

Misalnya, cuplikan berikut menyetel ke Wilayah AWS EU_SOUTH_2 untuk klien layanan Amazon S3 dalam kode:

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

Cuplikan sebelumnya menunjukkan metode pabrik statis,. builder() builder()Metode mengembalikan builder objek yang memungkinkan Anda untuk menyesuaikan klien layanan. Metode penyetel yang lancar mengembalikan builder objek—dalam hal ini, sebuah S3ClientBuilderinstance—sehingga Anda dapat menghubungkan panggilan metode untuk kenyamanan dan kode yang lebih mudah dibaca. Setelah Anda mengkonfigurasi properti yang Anda inginkan, panggil build() metode untuk membuat klien.

Konfigurasi lanjutan dalam kode

Cuplikan berikut menunjukkan opsi konfigurasi tambahan:

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

Pada cuplikan sebelumnya, Anda dapat melihat beberapa titik masuk untuk mengonfigurasi klien layanan:

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

Opsi konfigurasi tidak tersedia dalam kode

Karena setelan berikut memengaruhi proses inisialisasi mendasar di SDK, Anda dapat mengatur pengaturan konfigurasi berikut hanya secara eksternal dan bukan dalam kode:

Pengaturan Lokasi File

Pengaturan ini mengontrol lokasi file konfigurasi dan kredensyal bersama dan tidak dapat diganti secara terprogram setelah SDK memuatnya:

Pengaturan ini harus diatur sebelum SDK memuat file konfigurasi, karena mereka menentukan di mana SDK mencari konfigurasi. Setelah SDK diinisialisasi, mengubah nilai-nilai ini tidak berpengaruh.

Penonaktifan Layanan Metadata Instance

Setelan ini mengontrol apakah SDK mencoba menggunakan Layanan Metadata EC2 Instance sama sekali. Setelah SDK diinisialisasi, Anda tidak dapat mengubah pengaturan ini secara terprogram.

Pemilihan Profil

Setelan ini memberi tahu SDK profil mana yang akan dimuat dari file konfigurasi dan kredensyal bersama. Setelah dimuat, mengubah nilai ini tidak berpengaruh.

Jalur Kredensyal Kontainer

Anda menggunakan variabel lingkungan ini untuk memberi tahu SDK cara mengambil kredensyal dari layanan kontainer. Setelah rantai penyedia kredensyal dibuat selama inisialisasi klien layanan, Anda tidak dapat mengubah pengaturan ini.

Pilihan Implementasi HTTP Default

Pengaturan global ini menentukan implementasi klien HTTP mana yang digunakan SDK untuk semua klien layanan kecuali diganti dalam kode untuk klien layanan individu. Anda harus menyetel ini sebelum SDK menginisialisasi klien HTTP-nya dan tidak dapat diubah sesudahnya.