클라이언트 구성 - AWS SDK for Java 1.x

AWS SDK for Java 1.x는 2024년 7월 31일부터 유지 관리 모드로 전환되었으며 2025년 12월 end-of-support31일에 출시될 예정입니다. 새 기능, 가용성 개선 사항 및 AWS SDK for Java 2.x보안 업데이트를 계속 받으려면 로 마이그레이션하는 것이 좋습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

클라이언트 구성

를 AWS SDK for Java 사용하면 기본 클라이언트 구성을 변경할 수 있으며, 이는 다음과 같은 경우에 유용합니다.

  • 프록시를 통해 인터넷에 연결

  • 연결 제한 시간 및 요청 재시도와 같은 HTTP 전송 설정을 변경합니다.

  • TCP소켓 버퍼 크기 힌트 지정

프록시 구성

클라이언트 객체를 생성할 때 선택적 ClientConfiguration객체를 전달하여 클라이언트 구성을 사용자 지정할 수 있습니다.

프록시 서버를 통해 인터넷에 연결하는 경우 ClientConfiguration 객체를 통해 프록시 서버 설정(프록시 호스트, 포트 및 사용자 이름/암호)을 구성해야 합니다.

HTTP전송 구성

ClientConfiguration객체를 사용하여 여러 HTTP 전송 옵션을 구성할 수 있습니다. 새 옵션이 추가되는 경우가 있습니다. 검색하거나 설정할 수 있는 전체 옵션 목록을 보려면 AWS SDK for Java API 참조를 참조하십시오.

참고

각각의 구성 가능한 값마다 기본값이 상수로 정의되어 있습니다. 의 상수 값 목록은 AWS SDK for Java API 참조의 상수 필드 값을 참조하십시오. ClientConfiguration

최대 연결 수

를 사용하여 열린 HTTP 연결의 최대 허용 수를 설정할 수 ClientConfiguration있습니다. setMaxConnections메서드.

중요

연결 충돌과 성능 저하를 방지하기 위해 최대 연결 수를 동시 트랜잭션 수에 맞게 설정합니다. 기본 최대 연결 값은 AWS SDK for Java API 참조의 상수 필드 값을 참조하십시오.

제한 시간 및 오류 처리

제한 시간 및 HTTP 연결 오류 처리와 관련된 옵션을 설정할 수 있습니다.

로컬 주소

HTTP클라이언트가 바인딩할 로컬 주소를 설정하려면 를 사용합니다ClientConfiguration. setLocalAddress.

TCP소켓 버퍼 크기 힌트

저수준 TCP 파라미터를 조정하려는 고급 사용자는 객체를 통해 TCP 버퍼 크기 힌트를 추가로 설정할 수 있습니다. ClientConfiguration 대부분의 사용자는 이러한 값을 변경할 필요가 없으며, 이 기능은 고급 사용자용으로 제공됩니다.

애플리케이션의 최적 TCP 버퍼 크기는 네트워크 및 운영 체제 구성과 기능에 따라 크게 달라집니다. 예를 들어, 대부분의 최신 운영 체제는 TCP 버퍼 크기에 대한 자동 조정 로직을 제공합니다. 이는 자동 튜닝이 버퍼 크기를 최적화하도록 충분히 오랫동안 열린 상태로 유지되는 TCP 연결의 성능에 큰 영향을 미칠 수 있습니다.

대형 버퍼 크기(예: 2MB)를 사용하면 운영 체제는 원격 서버에서 해당 정보 수신 여부를 확인할 필요가 없으므로 메모리 더 많은 데이터를 버퍼링할 수 있으며, 이는 네트워크 지연 시간이 긴 경우에 특히 유용합니다.

이 옵션은 힌트일 뿐, 운영 체제에서는 인식하지 못할 수도 있습니다. 이 옵션을 사용하는 경우 사용자는 운영 체제의 구성된 제한 및 기본값을 항상 확인해야 합니다. 대부분의 운영 체제에는 최대 TCP 버퍼 크기 제한이 구성되어 있으며, 최대 버퍼 크기 제한을 명시적으로 늘리지 않는 한 이 제한을 초과할 수 없습니다. TCP

다음을 포함하여 TCP 버퍼 크기 및 운영 체제별 TCP 설정을 구성하는 데 도움이 되는 많은 리소스가 있습니다.