소켓 설정

개요

이 가이드 에서는 Java 운전자 소켓 설정을 관리하는 방법에 대해 학습 수 있습니다.

연결 문자열 사용하거나 MongoClientSettings 객체를 MongoClients 생성자에 전달하여 소켓에 대한 설정을 지정할 수 있습니다. Connection String 또는 MongoClientSettings 탭 선택하여 사용 가능한 옵션을 확인합니다.

옵션 이름	유형	설명
`connectTimeoutMS`	integer	Java 드라이버가 시간 초과되기 전에 연결이 열릴 때까지 기다리는 최대 시간(밀리초)을 지정합니다. `0` 값은 드라이버가 연결이 열릴 때까지 기다리는 동안 시간이 초과되지 않도록 합니다. 기본값: `10000`(10초)
`socketTimeoutMS`	integer	Java 드라이버가 시간 초과되기 전에 요청을 보내거나 받기를 기다리는 최대 시간(밀리초)을 지정합니다. `0` 값은 드라이버가 요청을 보내거나 받기를 기다리는 동안 시간이 초과되지 않도록 합니다. 기본값: `0`

이 예시 연결이 열릴 때까지 15 초 동안 대기한 후 운전자 시간 초과되도록 지정합니다.

ConnectionString connectionString = "mongodb://<host>:<port>/?connectTimeoutMS=15000"
MongoClient mongoClient = MongoClients.create(connectionString)

이러한 매개변수에 대한 자세한 내용은 ConnectionString API 문서를 참조하세요.

applyToSocketSettings() 메서드를 체인으로 연결하여 MongoDB deployment 에 연결하고 통신할 때 드라이버의 동작을 수정합니다.

다음 표에서는 설정을 연결하여 드라이버 동작을 수정할 수 있는 방법을 설명합니다.

메서드	설명
`applyConnectionString()`	`ConnectionString` 객체의 설정을 사용합니다.
`applySettings()`	`SocketSettings` 객체에 지정된 소켓 설정을 사용합니다.
`connectTimeout()`	시간 초과 예외가 발생하기 전에 사용 가능한 소켓에 연결하는 최대 시간을 설정합니다. 기본값: `10 seconds`
`readTimeout()`	시간 초과 예외가 발생하기 전에 사용 가능한 소켓에서 읽을 최대 시간을 설정합니다. 기본값: `0`, 이는 시간 초과 없음을 나타냅니다.
`receiveBufferSize()`	수신 시 소켓의 버퍼 크기를 설정합니다. 기본값: 운영 체제 기본값
`sendBufferSize()`	전송 시 소켓의 버퍼 크기를 설정합니다. 기본값: 운영 체제 기본값

참고

SOCKS5 프록시를 사용하여 MongoDB 에 연결

applyToProxySettings() 메서드를 소켓 설정에 연결하여 SOCKS5 프록시를 사용하여 MongoDB 에 연결할 수 있습니다. SOCKS5 프록시를 사용하고 프록시 설정을 설정하다 방법을 학습 SOCKS5 프록시를 사용하여 MongoDB 에 연결 가이드 를 참조하세요.

이 예시에서는 MongoDB 소켓에서 다음과 같은 드라이버 동작을 지정합니다:

내부에서 사용 가능한 소켓에 연결하려면 다음을 수행합니다. 10 SECONDS
다음 항목 내 사용 가능한 소켓에서 읽기: 15 SECONDS

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
    .applyConnectionString(new ConnectionString("<your connection string>"))
    .applyToSocketSettings(builder ->
        builder.connectTimeout(10, SECONDS)
        .readTimeout(15, SECONDS))
    .build());

연결된 메서드에 대한 자세한 내용은 MongoClientSettings.Builder API 문서를 참조하세요.

돌아가기

서버 설정

클라이언트 수준 CRUD 설정 구성