MongoDBのJava開発環境を構築する方法【初心者向け完全ガイド】

MongoDBのインストールと起動

MongoDBを使ったJava開発を始めるには、まずMongoDBサーバー本体をインストールして起動しておく必要があります。以下の手順に従って進めましょう。

• MongoDB公式サイトにアクセスし、「Software」のドロップダウンメニューから「Community Server」を選択します。

• MongoDB Community Serverのページで、自分が使用しているプラットフォーム(OSやバージョン)を指定し、対応するMongoDBサーバーをダウンロードします。

• ダウンロードしたソフトウェアをインストールします。その後、Cドライブ直下に「data」という名前のフォルダ(ディレクトリ)を作成し、データベースファイルの保存先として準備しておきます。

• MongoDBのbinディレクトリへのパスを環境変数(Path)に設定します。
  例： C:\Program Files\MongoDB\Server\4.2\bin

• コマンドプロンプトを開き、以下のように「mongod」コマンドを実行してMongoDBサーバーを起動します。

C:\Users\Tutorialspoint>mongod --dbpath "C:\data"

• 別のコマンドプロンプトを開き、「mongo」コマンドを実行してサーバーに接続します。接続に成功すると、MongoDBシェルが起動します。

• MongoDBシェル上では、データベース内のデータを自由に操作できます。

セットアップの動作確認

正しくセットアップできているか確認するために、「use」コマンドを使って「myDatabase」というデータベースに接続してみましょう。セットアップが成功していれば、以下のような結果が表示されます。

> use myDatabase;
switched to db myDatabase

Java用MongoDBドライバーの導入

EclipseでMongoDBのJava環境を構築するには、まず「Java – Mavenプロジェクト」を作成し、そのプロジェクトの pom.xml ファイルに以下の依存関係(dependency)を追加します。

<dependency>
   <groupId>org.mongodb</groupId>
   <artifactId>mongo-java-driver</artifactId>
   <version>3.12.2</version>
</dependency>

この依存関係を追加することで、Mavenが必要なMongoDB Javaドライバーを自動的にダウンロードし、プロジェクトで利用できるようになります。

接続テストによる検証

環境構築が完了したら、実際にMongoDB上のデータベースへ接続するプログラムを実行して、動作を確認してみましょう。

サンプルコード

import com.mongodb.MongoClient;
public class ConnectToDB {
   public static void main( String args[] ) {
      // MongoDBクライアントの生成
      MongoClient mongo = new MongoClient( "localhost" , 27017 );
      // データベースへのアクセス
      mongo.getDatabase("myDatabase");
      System.out.println("Connected to the database successfully");
   }
}

このプログラムは、ローカルホストのポート27017で稼働しているMongoDBサーバーに接続し、「myDatabase」データベースへアクセスするものです。すべてが正常であれば、実行時に以下の出力が得られます。

Connected to the database successfully

このメッセージが表示されれば、MongoDBとJavaの連携環境は正常に構築されています。あとはこの基盤をもとに、データの登録・取得・更新・削除(CRUD操作)など、さまざまな処理を試してみてください。