Computer >> 컴퓨터 >  >> 프로그래밍 >> Java

MongoDB Java 개발 환경 설정 방법 완벽 가이드

Java 애플리케이션에서 MongoDB를 사용하려면 먼저 MongoDB 서버를 설치·실행하고, Java 프로젝트에 MongoDB 드라이버를 추가해야 합니다. 이 글에서는 MongoDB 설치부터 Eclipse에서의 환경 구성, 그리고 정상 동작 여부 확인까지 전 과정을 단계별로 안내합니다.

MongoDB 설치 및 실행

MongoDB 서버를 설치하고 실행하는 절차는 다음과 같습니다.

  • MongoDB 공식 홈페이지 방문: MongoDB 공식 사이트에 접속한 뒤, 상단의 Software(소프트웨어) 드롭다운 메뉴에서 Community Server를 선택합니다.

  • 플랫폼 선택 후 다운로드: MongoDB Community Server 페이지에서 자신의 운영체제(OS)와 버전 등 플랫폼 정보를 지정하고, 해당 플랫폼에 맞는 MongoDB 서버를 다운로드합니다.

  • 설치 및 데이터 폴더 생성: 다운로드한 소프트웨어를 설치한 후, 데이터베이스 파일을 저장할 data 폴더를 C 드라이브 루트에 생성합니다.

  • 환경 변수(Path) 설정: MongoDB의 bin 디렉터리 경로를 시스템 환경 변수에 추가합니다. 예: C:\Program Files\MongoDB\Server\4.2\bin

  • MongoDB 서버 실행: 명령 프롬프트(cmd)를 열고 아래와 같이 mongod 명령을 실행하여 서버를 시작합니다.

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

  • 클라이언트 연결: 새 명령 프롬프트 창을 열고 mongo 명령을 실행하면 서버에 접속되며, MongoDB 셸(shell)을 사용할 수 있게 됩니다.

  • 데이터 조작: 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 프로젝트를 업데이트하면(Maven Update), 필요한 JAR 파일들이 자동으로 다운로드되어 클래스패스에 포함됩니다.

설정 검증하기

아래 JDBC 프로그램은 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");
    }
}

모든 설정이 정상적으로 완료되었다면, 위 프로그램을 실행했을 때 다음과 같은 출력 결과를 얻을 수 있습니다.

Connected to the database successfully

마무리

지금까지 MongoDB 서버 설치와 실행, 환경 변수 설정, Maven 기반 Java 프로젝트에 MongoDB 드라이버 추가, 그리고 간단한 연결 테스트까지 살펴보았습니다. 이 과정을 완료하면 Java 애플리케이션에서 MongoDB의 강력한 NoSQL 기능을 활용할 준비가 끝난 것입니다. 이후에는 컬렉션 생성, 문서 삽입·조회 등 CRUD 작업을 익혀나가시기 바랍니다.