Stable APIで接続

Overview

このガイドでは、MongoDB 配置に接続するときにStable API互換性を指定する方法を学習できます。

Stable API 機能を使用すると、指定された API バージョンと互換性のある動作でサーバーに操作が強制的に実行されます。 Stable API を使用すると、サーバーからの一貫した応答が確保され、アプリケーションの API の長期的な安定性が確保されます。

次のセクションでは、MongoDB クライアントの Stable API を有効にしてカスタマイズする方法について説明します。 Stable APIサポートするコマンドのリストを含むStable API の詳細については、MongoDB Server マニュアルの「 」を参照してください。

Stable API を有効にする

Stable API を有効にするには、次の手順を実行します。

1. ServerApiオブジェクトを構築し、Stable API バージョンを指定します。 ServerApiVersion列挙型で定義された Stable API バージョンを使用する必要があります。

2. MongoClientSettings.Builderクラスを使用してMongoClientSettingsオブジェクトを構築します。

3. MongoClient.create()メソッドを使用してMongoClientをインスタンス化し、 MongoClientSettingsインスタンスをパラメーターとして渡します。

次のコード例は、Stable API バージョン1を指定する方法を示しています。

val serverApi = ServerApi.builder()
    .version(ServerApiVersion.V1)
    .build()
// Replace the uri string placeholder with your MongoDB deployment's connection string
val uri = "<connection string>"
val settings = MongoClientSettings.builder()
    .applyConnectionString(ConnectionString(uri))
    .serverApi(serverApi)
    .build()
val client = MongoClient.create(settings)

指定された API バージョンでMongoClientインスタンスを作成すると、クライアントで実行されるすべてのコマンドが指定されたバージョンを使用します。 Stable API の複数のバージョンを使用してコマンドを実行する必要がある場合は、新しいMongoClientを作成します。

Stable API の構成

次の表では、 ServerApiクラスのパラメータを説明しています。 これらのパラメーターを使用して、Stable API の動作をカスタマイズできます。

次のコード例は、 ServerApi.Builderのメソッドを連鎖させて、 ServerApiのインスタンスに 2 つのオプションを設定する方法を示しています。

val serverApi = ServerApi.builder()
    .version(ServerApiVersion.V1)
    .strict(true)
    .deprecationErrors(true)
    .build()

トラブルシューティング

API ドキュメント

Kotlin Sync ドライバーで Stable API を使用する方法の詳細については、次の API ドキュメントを参照してください。

• ServerApi

• ServerApi.Builder

• ServerApiVersion

• ServerAddress

• MongoClientSettings

• MongoClientSettings.Builder

• MongoClient

• MongoClient.create()