Docs Menu
Docs Home
/
言語
/
Java
/
Java Reactive Streams ドライバー
/
MongoDB に接続する

MongoClient の作成

項目一覧

  • Overview
  • 接続URI
  • MongoClient
  • API ドキュメント

Overview

MongoDB 配置に接続するには、次の 2 つのものが必要です。

  • 接続 URI （ 接続string とも呼ばれます）で、接続するJava 配置の Reactive StreamsMongoDB ドライバーに指示します。

  • MongoClientインスタンスMongoDB配置への接続を作成し、それに対して操作を実行できるようにします。

また、これらのコンポーネントのいずれかを使用して、 MongoDB . に接続するときにJava Reactive Streams ドライバーの動作をカスタマイズすることもできます。

このガイドでは、接続string を作成し、{0MongoClient インスタンスを使用してMongoDB に接続する方法を説明します。

接続URI

標準の接続stringには次のコンポーネントが含まれます。

コンポーネント
説明
mongodb://
必須。 標準接続形式の string として URI を識別するプレフィックス。
username:password

任意。 認証資格情報。 これらを含めると、クライアントはauthSourceで指定されたデータベースに対してユーザーを認証します。

authSource接続オプションの詳細については、 認証ガイドを参照してください。

host[:port]
必須。 MongoDBがを実行中ホストとポート番号。 ポート番号を指定しない場合、ドライバーはデフォルトのポート27017を使用します。
/defaultauthdb
任意。 接続stringに username:password@ 認証情報が含まれている一方で、authSource オプションが含まれていない場合に使用する認証データベース。 このコンポーネントを含めない場合、クライアントはadminデータベースに対してユーザーを認証します。
?<options>

任意。接続固有のオプションを <name>=<value> ペアとして指定するクエリ文字列です。

これらのオプションについて詳しくは、「接続 URI オプションの指定 」ガイドを参照してください。

接続 の作成の詳細については、string MongoDB Serverドキュメントの「 接続 文字列 」を参照してください。

MongoClient

MongoDBへの接続を作成するには、接続 URI を string として メソッドに渡し、 MongoClientオブジェクトを構築します。 次の例では、ドライバーはサンプル接続 URI を使用して、 localhostのポート27017上のMongoDBインスタンスに接続します。

import com.mongodb.reactivestreams.client.MongoClients;
import com.mongodb.reactivestreams.client.MongoClient;
public class MongoConnection {
    public static void main(String[] args) {
        String uri = "mongodb://localhost:27017/";
        try (MongoClient client = MongoClients.create(uri)) {
            // use `client` here
        }
    }
}

Tip

クライアントの再利用

各MongoClientインスタンスはデータベースへの接続をプールするため、ほとんどのアプリケーションでは、複数のリクエスト間でもMongoClientのインスタンスが 1 つだけ必要になります。

API ドキュメント

Java Reactive Streams ドライバーでMongoClientインスタンスを作成する方法について詳しくは、次のAPIドキュメントを参照してください。

戻る

MongoDB に接続する

次へ

接続ターゲットの選択