Javaドライバーを使い始める

ドライバーの依存関係をインストールする

このチュートリアルを開始する前に、次の依存関係をインストールしていることを確認してください。

• JDK 8バージョン 以降

• 統合開発環境（IDE）（IntelliJ IDEA や Eclipse など）

Javaドライバーのドキュメントの Java ドライバーの追加

IDE で、新しい Maven または Gradleプロジェクトを作成します。 MongoDB JVMアーティファクトのアイテム請求書（BOM）をプロジェクトに追加して、依存関係バージョンを整理します。 BOM は、 Javaドライバーと Core ドライバー ライブラリ間など、一貫した互換性のあるバージョンの依存関係を維持することで、依存関係の管理を簡素化します。 BOM を使用すると、バージョンの競合を回避し、アップグレードを簡素化できます。

次の Maven タブと Gradle タブから選択すると、各依存関係マネージャーに BOM を追加するための手順が表示されます。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>5.4.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

dependencies {
    implementation(platform("org.mongodb:mongodb-driver-bom:5.4.0"))
}

BOM が管理する依存関係のリストを表示するには、 Maven Repositoryウェブサイトの mongodb-Driver-bom 依存関係リスト を参照してください。

Javaドライバーをインストール

Maven を使用する場合は、次のコードを pom.xml 依存関係リストに追加します。

<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-sync</artifactId>
    </dependency>
</dependencies>

Gradle を使用する場合は、次のコードを build.gradle 依存関係リストに追加します。

dependencies {
  implementation 'org.mongodb:mongodb-driver-sync'
}

BOM をインストールしたため、 Javaドライバーの依存関係エントリでバージョンを省略できます。 BOM で指定したバージョンによって、インストールする依存関係バージョンが決まります。

依存関係を構成したら、依存関係マネージャーを実行中し、IDE でプロジェクトを更新して、依存関係がプロジェクトで使用できることを確認します。

Atlas で無料の MongoDB 配置を作成

Atlas の使用開始ガイドを完了して、新しい Atlas アカウントと無料階層のMongoDBデプロイを設定します。サンプルデータをロードし、IP アクセス リストにIPアドレスを追加していることを確認します。

認証情報を保存する

データベースユーザーを作成したら、そのユーザーのユーザー名とパスワードを安全な場所に保存して、後の手順で使用します。

MongoDB Atlas 接続文字列を見つける

前のステップ で作成した配置の接続文字列を取得するには、Atlas アカウントにログして「Clusters 」セクションに移動します。次のスクリーンショットに示すように、新しい配置で [] ボタンをクリックします。Connect

次に、Connect your application セクションに進みます。 Driver 選択メニューから「Java」を選択し、Version 選択メニューからインストールしたバージョンに最適なバージョンを選択します。

接続stringのコピー

次のスクリーンショットに示すように、接続文字列の右側にある ボタンをクリックして、接続stringをクリップボードにコピーします。

接続文字列プレースホルダーを編集する

接続文字列をテキストエディターのファイルに貼り付け、後で使用するために安全な場所にファイルします。接続文字列内の、<db_username> と <db_password> のプレースホルダーをデータベースユーザーのユーザー名とパスワードに置き換えます。

Javaアプリケーションファイルを作成

プロジェクトの 基本パッケージディレクトリに、QuickStart.java というファイルを作成します。次のコードをコピーして、このファイルに貼り付けます。このファイルは、sample_mflixデータベース内のmoviesコレクションをクエリします。

import static com.mongodb.client.model.Filters.eq;
import org.bson.Document;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
public class QuickStart {
    public static void main( String[] args ) {
        // Replace the placeholder with your MongoDB deployment's connection string
        String uri = "<connection string uri>";
        try (MongoClient mongoClient = MongoClients.create(uri)) {
            MongoDatabase database = mongoClient.getDatabase("sample_mflix");
            MongoCollection<Document> collection = database.getCollection("movies");
            Document doc = collection.find(eq("title", "Back to the Future")).first();
            if (doc != null) {
                System.out.println(doc.toJson());
            } else {
                System.out.println("No matching documents found.");
            }
        }
    }
}

接続文字列の割り当て

<connection string uri> プレースホルダーを、このガイドの接続文字列の作成ステップからコピーした接続文字列に置き換えます。

Javaアプリケーションの実行

IDE またはシェルでアプリケーションを実行します。出力には、検索された映画ドキュメントの詳細が含まれます。

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}

エラーが発生した場合や出力が表示されない場合は、正しい接続文字列とサンプルデータがロードされていることを確認してください。

javax.net.ssl.SSLHandshakeException: extension (5) should not be presented in certificate_request