릴리스 노트

5.1에서 사용 중단된 기능

• MongoDB Server v3.6 에 대한 지원은 더 이상 사용되지 않으며 다음 운전자 버전 출시하다 에서 제거될 예정입니다. MongoDB Server 배포서버 서버를 업그레이드 하는 방법을 학습 보려면 MongoDB Server 매뉴얼의 릴리스 노트 를 참조하세요.

5.1의 개선 사항

• GraalVM 네이티브 이미지 기술에 대한 내부 테스트입니다. 이러한 테스트에는 GraalVM 네이티브 이미지 도구를 사용하여 네이티브 애플리케이션을 빌드하는 것이 포함됩니다.

• MONGODB-OIDC 인증 메커니즘에 대한 지원이 강화되었습니다. OIDC에 대한 자세한 내용은 엔터프라이즈 인증 메커니즘 가이드의 MONGODB-OIDC 섹션을 참조하세요.

5.1의 새로운 기능.

• serverMonitoringMode 연결 URI 옵션을 도입합니다. 이 옵션에 대한 자세한 내용은 연결 옵션 가이드 를 참조하세요.

5.0의 사용 중단

• org.mongodb.scala.Observable.completeWithUnit() 메서드는 더 이상 지원되지 않습니다. 이제 드라이버가 org.mongodb.scala.Observable[Void] 대신 org.mongodb.scala.Observable[Unit]을(를) 노출하므로 이 메서드는 더 이상 유용하지 않습니다. 이는 이번 릴리스에서 옵저버블에 관한 호환성이 손상되는 변경과 관련이 있습니다.

5.0의 동작 변경 사항

• com.mongodb.event.ConnectionReadyEvent 의 getElapsedTime() 메서드에는 ConnectionCreatedEvent 전송하는 데 걸리는 시간이 포함되어 있습니다. 즉, 반환된 시간에는 com.mongodb.event.ConnectionPoolListener.connectionCreated() 메서드의 지속 시간이 포함됩니다.

  com.mongodb.event.ConnectionCheckedOutFailedEvent 및 com.mongodb.event.ConnectionCheckedOutEvent 의 getElapsedTime() 메서드에는 com.mongodb.event.ConnectionCheckOutStartedEvent 전송하는 데 걸리는 시간이 포함되어 있습니다. 즉, 반환된 시간에는 com.mongodb.eventConnectionPoolListener.connectionCheckOutStarted() 메서드의 지속 시간이 포함됩니다.

5.0의 새로운 기능

5.0 드라이버 릴리스에는 다음과 같은 기능이 도입되었습니다.

• listCollections 명령의 authorizedCollection 옵션에 대한 지원을 추가합니다. 이는 com.mongodb.client.MongoDatabase.listCollectionNames() 메서드를 변경하여 수행되었습니다. 반환 유형은 이제 com.mongodb.client.ListCollectionNamesIterable 이지만, 이전에는 MongoIterable<String> 이었습니다. 이 변경을 통해 ListCollectionNamesIterable.authorizedCollections() 메서드를 사용하고 authorizedCollections 옵션을 지정하여 반환 값을 구성할 수 있습니다. 다음 클래스와 인터페이스에 동등한 변경 사항이 적용되었습니다.

  • com.mongodb.reactivestreams.client.MongoDatabase

  • org.mongodb.scala.MongoDatabase

  • com.mongodb.kotlin.client.MongoDatabase

  • com.mongodb.kotlin.client.coroutine.MongoDatabase

  이러한 변경 사항 은 listCollectionsNames() 메서드에 바이너리 호환성이 손상되는 변경을 도입합니다. MongoDatabase.listCollectionNames() 메서드 및 authorizedCollections 옵션에 대한 자세한 내용은 listCollections MongoDB Server 매뉴얼 페이지 또는 컬렉션 목록 가져오기를 참조하세요.

4.11의 지원 중단

4.11 드라이버 릴리스에서는 다음 항목이 더 이상 사용되지 않습니다.

• DBCollection 클래스의 getStats() 및 isCapped() 인스턴스 메서드는 더 이상 사용되지 않습니다. 해당 서버 명령은 MongoDB v6.2 이상에서 더 이상 사용되지 않습니다. 대신 $collStats 집계 파이프라인 단계를 사용하여 이러한 메서드에서 제공하는 정보를 검색하세요. 다음 코드 예시와 같이 집계를 실행할 수 있습니다.

  Cursor cursor = collection.aggregate(Arrays.asList(
          new BasicDBObject("$collStats",
                  new BasicDBObject("storageStats", new BasicDBObject()))),
          AggregationOptions.builder().build()
  );

  컬렉션이 고정 사이즈 컬렉션인지 확인하려면 이전 예시 집계에서 Cursor 인스턴스가 반환한 storageStats.capped 필드 값에 액세스합니다.

  $collStats 집계 연산자에 대해 자세히 알아보려면 $collStats(집계) 서버 수동 항목을 참조하세요.

• 다음 네트워크 주소 관련 메서드는 더 이상 사용되지 않으며 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();

4.11의 새로운 기능

4.11 드라이버 릴리스의 새로운 기능은 다음과 같습니다.

• SOCKS5 프록시를 사용하여 MongoDB에 연결할 수 있도록 지원합니다. 자세한 내용은 SOCKS5 프록시를 사용하여 MongoDB에 연결을 참조하세요.

• 16MB를 초과하는 변경 스트림 이벤트의 일부를 식별하기 위해 ChangeStreamDocument 클래스에 getSplitEvent() 메서드를 추가했습니다. 16MB를 초과하는 이벤트를 처리하려면 변경 스트림에서 집계 단계 $changeStreamSplitLargeEvent를 사용해야 합니다. 자세한 내용은 대규모 변경 스트림 이벤트 분할을 참조하세요.

• $vectorSearch에 대한 집계 단계 빌더를 추가했습니다. 자세히 알아보려면 Atlas Vector Search를 참조하세요.

• Atlas Search 인덱스 관리 헬퍼가 추가되었습니다. 자세히 알아보려면 Atlas Search 인덱스를 참조하세요.

• Snappy 및 Zstd 압축 라이브러리 종속성 버전이 업데이트되었습니다. 현재 종속성 버전에 대한 자세한 내용은 네트워크 압축을 참조하세요.

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

  • ConnectionCheckOutFailedEvent

  • ConnectionCheckedOutEvent

  • ConnectionReadyEvent

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

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

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

  • ClusterListener

  • ServerListener

  • ServerMonitorListener