새로운 기능

다음 네트워크 주소 관련 메서드는 더 이상 사용되지 않으며 v5.0에서 제거됩니다.

• ServerAddress 메서드 getSocketAddress() 및 getSocketAddresses().

  getSocketAddress() 대신 java.net.InetAddress의 getByName() 인스턴스 메서드를 사용합니다.

  getSocketAddresses() 대신 java.net.InetAddress의 getAllByName() 인스턴스 메서드를 사용합니다.

• UnixServerAddress 메서드 getUnixSocketAddress().

  getUnixSocketAddress() 대신 jnr.unixsocket.UnixSocketAddress의 인스턴스를 구성합니다. 생성자에 UNIX 소켓 파일의 전체 경로를 전달합니다. 기본적으로 MongoDB는 "/tmp/mongodb-27017.sock"에 UNIX 소켓 파일을 생성합니다. UnixSocketAddress에 대한 자세한 내용은 UnixSocketAddress API 문서에서 확인하세요.

StreamFactory 인터페이스와 관련된 다음 메서드 및 유형은 더 이상 사용되지 않으며 v5에서 제거될 예정입니다.0:

• streamFactoryFactory() 다음의 메서드 MongoClientSettings.Builder

• getStreamFactoryFactory() 다음의 메서드 MongoClientSettings

• NettyStreamFactoryFactory 클래스

• NettyStreamFactory 클래스

• AsynchronousSocketChannelStreamFactory 클래스

• AsynchronousSocketChannelStreamFactoryFactory 클래스

• BufferProvider 클래스

• SocketStreamFactory 클래스

• Stream 클래스

• StreamFactory 클래스

• StreamFactoryFactory 클래스

• TlsChannelStreamFactoryFactory 클래스

MongoClientSettings.Builder.streamFactoryFactory()를 사용하여 Netty를 구성하는 경우 코드가 다음과 비슷할 수 있습니다.

import com.mongodb.connection.netty.NettyStreamFactoryFactory;
// ...
MongoClientSettings settings = MongoClientSettings.builder()
        .streamFactoryFactory(NettyStreamFactoryFactory.builder().build())
        .build();

다음 예시와 같이 이 코드를 TransportSettings.nettyBuilder()로 대체합니다.

import com.mongodb.connection.TransportSettings;
// ...
MongoClientSettings settings = MongoClientSettings.builder()
        .transportSettings(TransportSettings.nettyBuilder().build())
        .build();

SOCKS5 프록시를 사용하여 MongoDB에 연결할 수 있도록 지원합니다.

16MB를 초과하는 change stream 이벤트의 일부를 식별하기 위해 ChangeStreamDocument 클래스에 getSplitEvent() 메서드를 추가했습니다. 16MB를 초과하는 events를 처리하려면 change stream에서 애그리게이션 단계 $changeStreamSplitLargeEvent 를 사용해야 합니다.

$vectorSearch 에 대한 애그리게이션 단계 빌더를 추가했습니다.

Atlas Search 인덱스 관리 헬퍼가 추가되었습니다.

Snappy 및 zstd 압축 라이브러리 종속성 버전이 업데이트되었습니다. 현재 종속성 버전에 학습 보려면 네트워크 압축을 참조하세요.

연결 풀 이벤트 기간을 모니터링하기 위해 다음 클래스에 getElapsedTime() 메서드를 추가했습니다.

• ConnectionCheckOutFailedEvent

• ConnectionCheckedOutEvent

• ConnectionReadyEvent

Java 21 가상 스레드 및 구조적 동시성을 지원합니다. 가상 스레드가 불필요하게 고정되는 것을 방지하고 스레드의 중단된 상태를 유지하기 위해 드라이버 내부가 업데이트되었습니다. 이는 취소에 사용되는 구조적 동시성에 후자가 중요하기 때문입니다.

가상 스레드에 대한 자세한 내용은 가상 스레드 JDK 개선 제안을 참조하세요. 구조적 동시성에 대해 자세히 알아보려면 구조적 동시성 JDK 개선 제안을 참조하세요.

다음 유형에 대한 API 문서가 업데이트되었습니다.

• ClusterListener

• ServerListener

• ServerMonitorListener