リリースノート

5.1での非推奨

• MongoDB Server v 3.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[Unit] ではなくorg.mongodb.scala.Observable[Void] であるため、このメソッドは使用できなくなりました。これは、このリリースの Observables に関する重大な変更に関連します。

5.0 での動作の変更

• getElapsedTime()com.mongodb.event.ConnectionReadyEventの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 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()
  );

  コレクションが Capped コレクションであるかどうかを判断するには、前述の例の集計で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 に接続する 」を参照してください。

• 16 MB を超える 変更ストリーム イベントのフラグメントを識別するために、 ChangeStreamDocumentクラスにgetSplitEvent()メソッドを追加しました。 16 MB を超えるイベントを処理するには、変更ストリームの集計ステージ$changeStreamSplitLargeEventを使用する必要があります。 詳細については、「大規模な変更ストリーム イベントの分割 」を参照してください。

• $vectorSearchの集計ステージ ビルダを追加しました。 詳細については、「 Atlas Vector Search 」を参照してください。

• Atlas Search インデックス マネジメント ヘルパーを追加しました。 詳しくは、「 Atlas Search インデックス 」を参照してください。

• Snappyおよびzstd圧縮ライブラリの依存関係バージョンを更新しました。 現在の依存関係バージョンの詳細については、「ネットワーク圧縮 」を参照してください。

• 接続プール イベントの期間をモニタリングするために、次のクラスにgetElapsedTime()メソッドを追加しました。

  • ConnectionCheckOutFailedEvent

  • ConnectionCheckedOutEvent

  • ConnectionReadyEvent

• Java 21 仮想スレッドと構造化同時実行性のサポート。 仮想スレッドの不要な固定を回避し、スレッドの中断された状態を保持するようにドライバー内部がアップデートされました。後者はキャンセルに使用される構造化同時実行性において重要であるためです。

  仮想スレッドの詳細については、Virtual Threads JDK の拡張提案」を参照してください。構造化同時実行の詳細については、構造化同時実行 JDK 機能強化の提案 を参照してください。

• 次のタイプの API ドキュメントを更新しました。

  • ClusterListener

  • ServerListener

  • ServerMonitorListener