View a markdown version of this page

Konfigurasi Klien - AWS SDK untuk Java 1.x
Konfigurasi ProxyKonfigurasi Transportasi HTTPPetunjuk Ukuran Buffer Soket TCP

AWS SDK untuk Java 1.x mencapai akhir dukungan pada 31 Desember 2025. Kami menyarankan Anda bermigrasi ke AWS SDK for Java 2.x untuk terus menerima fitur baru, peningkatan ketersediaan, dan pembaruan keamanan.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Konfigurasi Klien

Ini AWS SDK untuk Java memungkinkan Anda untuk mengubah konfigurasi klien default, yang sangat membantu ketika Anda ingin:

  • Hubungkan ke Internet melalui proxy

  • Mengubah pengaturan transportasi HTTP, seperti batas waktu koneksi dan permintaan percobaan ulang

  • Tentukan petunjuk ukuran buffer soket TCP

Konfigurasi Proxy

Saat membangun objek klien, Anda dapat meneruskan ClientConfiguration objek opsional untuk menyesuaikan konfigurasi klien.

Jika Anda terhubung ke Internet melalui server proxy, Anda harus mengkonfigurasi pengaturan server proxy Anda (host proxy, port, dan username/password) melalui ClientConfiguration objek.

Konfigurasi Transportasi HTTP

Anda dapat mengkonfigurasi beberapa opsi transportasi HTTP dengan menggunakan ClientConfiguration objek. Opsi baru kadang-kadang ditambahkan; untuk melihat daftar lengkap opsi yang dapat Anda ambil atau atur, lihat Referensi AWS SDK untuk Java API.

catatan

Setiap nilai yang dapat dikonfigurasi memiliki nilai default yang ditentukan oleh konstanta. Untuk daftar nilai konstan untukClientConfiguration, lihat Nilai Bid ang Konstan di Refer AWS SDK untuk Java ensi API.

Koneksi Maksimum

Anda dapat mengatur jumlah maksimum koneksi HTTP terbuka yang diizinkan dengan menggunakan ClientConfiguration.setMaxConnections metode ini.

penting

Tetapkan koneksi maksimum ke jumlah transaksi bersamaan untuk menghindari perselisihan koneksi dan kinerja yang buruk. Untuk nilai koneksi maksimum default, lihat Nilai Bid ang Konstan di Refer AWS SDK untuk Java ensi API.

Waktu habis dan Penanganan Kesalahan

Anda dapat mengatur opsi yang terkait dengan batas waktu dan penanganan kesalahan dengan koneksi HTTP.

  • Batas Waktu Koneksi

    Waktu tunggu koneksi adalah jumlah waktu (dalam milidetik) koneksi HTTP akan menunggu untuk membuat koneksi sebelum menyerah. Defaultnya adalah 10.000 ms.

    Untuk mengatur nilai ini sendiri, gunakan ClientConfiguration.setConnectionTimeout metode ini.

  • Waktu Koneksi untuk Langsung (TTL)

    Secara default, SDK akan mencoba menggunakan kembali koneksi HTTP selama mungkin. Dalam situasi kegagalan di mana koneksi dibuat ke server yang telah keluar dari layanan, memiliki TTL yang terbatas dapat membantu pemulihan aplikasi. Misalnya, mengatur TTL 15 menit akan memastikan bahwa meskipun Anda memiliki koneksi yang dibuat ke server yang mengalami masalah, Anda akan membangun kembali koneksi ke server baru dalam waktu 15 menit.

    Untuk mengatur koneksi HTTP TTL, gunakan ClientConfiguration.setConnectionTTL metode ini.

  • Percobaan Ulang Kesalahan Maksimum

    Jumlah coba ulang maksimum default untuk kesalahan yang dapat diambil adalah 3. Anda dapat mengatur nilai yang berbeda dengan menggunakan ClientConfiguration.setMaxErrorRetry metode ini.

Alamat Lokal

Untuk mengatur alamat lokal yang akan diikat klien HTTP, gunakan ClientConfiguration.setLocalAddress.

Petunjuk Ukuran Buffer Soket TCP

Pengguna tingkat lanjut yang ingin menyetel parameter TCP tingkat rendah juga dapat mengatur petunjuk ukuran buffer TCP melalui objek. ClientConfiguration Mayoritas pengguna tidak perlu mengubah nilai-nilai ini, tetapi mereka disediakan untuk pengguna tingkat lanjut.

Ukuran buffer TCP yang optimal untuk aplikasi sangat bergantung pada konfigurasi dan kemampuan jaringan dan sistem operasi. Misalnya, sebagian besar sistem operasi modern menyediakan logika penyetelan otomatis untuk ukuran buffer TCP. Ini dapat berdampak besar pada kinerja untuk koneksi TCP yang dipegang terbuka cukup lama untuk penyetelan otomatis untuk mengoptimalkan ukuran buffer.

Ukuran buffer besar (misalnya, 2 MB) memungkinkan sistem operasi untuk menyangga lebih banyak data dalam memori tanpa mengharuskan server jarak jauh untuk mengakui penerimaan informasi itu, dan dengan demikian dapat sangat berguna ketika jaringan memiliki latensi tinggi.

Ini hanya petunjuk, dan sistem operasi mungkin tidak menghormatinya. Saat menggunakan opsi ini, pengguna harus selalu memeriksa batas dan default yang dikonfigurasi sistem operasi. Sebagian besar sistem operasi memiliki batas ukuran buffer TCP maksimum yang dikonfigurasi, dan tidak akan membiarkan Anda melampaui batas itu kecuali Anda secara eksplisit menaikkan batas ukuran buffer TCP maksimum.

Banyak sumber daya tersedia untuk membantu mengonfigurasi ukuran buffer TCP dan pengaturan TCP khusus sistem operasi, termasuk yang berikut ini: