客戶端組態 - AWS SDK for Java 1.x
代理組態HTTP 傳輸組態TCP Socket 緩衝區大小提示

截至 2024 年 7 月 31 日， AWS SDK for Java 1.x 已進入維護模式，並將end-of-support在 2025 年 12 月 31 日送達。我們建議您遷移至 AWS SDK for Java 2.x，以繼續接收新功能、可用性改進和安全性更新。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

客戶端組態

AWS SDK for Java 可讓您變更預設用戶端組態，這在您想要執行下列動作時很有幫助：

  • 透過代理連線到網際網路

  • 變更HTTP傳輸設定，例如連線逾時和請求重試

  • 指定TCP通訊端緩衝區大小提示

代理組態

建構用戶端物件時，您可以在選用ClientConfiguration物件中傳遞，以自訂用戶端的組態。

如果您透過代理伺服器連線至網際網路，則需要透過 ClientConfiguration 物件設定代理伺服器設定 （代理主機、連接埠和使用者名稱/密碼）。

HTTP 傳輸組態

您可以使用 ClientConfiguration 物件設定數個HTTP傳輸選項。偶爾會新增新選項；若要查看您可以擷取或設定的選項完整清單，請參閱 AWS SDK for Java API 參考。

注意

每個可設定的值都有一個由常數定義的預設值。如需 的恆定值清單ClientConfiguration，請參閱 參考中的 AWS SDK for Java API恆定欄位值。

連線數上限

您可以使用 ClientConfiguration.setMaxConnections 方法設定允許的開啟HTTP連線數量上限。

重要

設定連線數上限到並行交易，避免連線失敗和效能不佳。如需預設連線上限值，請參閱 參考中的 AWS SDK for Java API恆定欄位值。

逾時和錯誤處理

您可以設定與逾時和使用HTTP連線處理錯誤相關的選項。

  • 連線逾時

    連線逾時是HTTP連線在放棄之前等待建立連線的時間量 （以毫秒為單位）。預設值為 10，000 毫秒。

    若要自行設定此值，請使用 ClientConfiguration.setConnectionTimeout 方法。

  • 連線存留時間 （TTL）

    根據預設， SDK會盡可能嘗試重複使用HTTP連線。在與已停止服務的伺服器建立連線的失敗情況下，具有有限TTL度有助於應用程式復原。例如，設定 15 分鐘TTL可確保即使您已與遇到問題的伺服器建立連線，您也會在 15 分鐘內重新建立與新伺服器的連線。

    若要設定HTTP連線 TTL，請使用 ClientConfiguration.setConnectionTTL 方法。

  • 錯誤重試次數上限

    可重試錯誤的預設重試計數上限為 3。您可以使用 ClientConfiguration.setMaxErrorRetry 方法設定不同的值。

本機地址

若要設定HTTP用戶端將繫結的本機地址，請使用 ClientConfiguration。setLocalAddress

TCP Socket 緩衝區大小提示

想要調整低階TCP參數的進階使用者可以透過 ClientConfiguration 物件額外設定TCP緩衝區大小提示。大多數使用者永遠不需要調整這些值，但會提供給進階使用者。

應用程式的最佳TCP緩衝區大小高度取決於網路和作業系統組態和功能。例如，大多數現代作業系統都會為TCP緩衝區大小提供自動調整邏輯。這可能會對長時間保持開啟的TCP連線效能產生重大影響，以便自動調整可最佳化緩衝區大小。

較大的緩衝區大小 （例如 2 MB） 可讓作業系統緩衝記憶體中的更多資料，而不需要遠端伺服器確認收到該資訊，因此當網路具有高延遲時，特別有用。

這只是一個提示 ，作業系統可能無法承兌它。使用此選項時，使用者應一律檢查作業系統設定的限制和預設值。大多數作業系統已設定TCP緩衝區大小上限，除非您明確提高緩衝TCP區大小上限，否則不會讓您超過該限制。

許多資源可協助您設定TCP緩衝區大小和作業系統特定的TCP設定，包括下列項目：