Java로 MongoDB 컬렉션에 문서 삽입하는 방법: insertOne() 완벽 가이드

MongoDB에 문서 삽입하기

MongoDB에서는 insert() 메서드를 사용하여 기존 컬렉션에 문서를 손쉽게 삽입할 수 있습니다.

기본 문법

db.coll.insert(doc)

각 구성 요소의 의미는 다음과 같습니다.

• db : 데이터베이스를 나타냅니다.

• coll : 문서를 삽입할 대상 컬렉션의 이름입니다.

• doc : 삽입하려는 문서입니다.

몽고DB 셸 예제

> use myDatabase()
switched to db myDatabase()
> db.createCollection(sample)
{ "ok" : 1 }
> db.sample.insert({name:"Ram", age:26, city:"Hyderabad"})
WriteResult({ "nInserted" : 1 })

위 실행 결과의 nInserted : 1은 문서가 정상적으로 1건 삽입되었음을 의미합니다.

Java 프로그램으로 문서 삽입하기

Java에서는 com.mongodb.client.MongoCollection 인터페이스가 제공하는 insertOne() 메서드를 사용하여 컬렉션에 문서를 삽입할 수 있습니다. 이 메서드는 삽입할 문서 객체를 매개변수로 받습니다.

Java 프로그램으로 MongoDB에 문서를 삽입하려면 다음 단계를 따르세요.

• 시스템에 MongoDB가 설치되어 있는지 확인합니다.

• Java 프로젝트의 pom.xml 파일에 MongoDB Java 드라이버 의존성을 추가합니다.

1. Maven 의존성 추가

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

2. 문서 삽입 절차

• MongoClient 클래스를 인스턴스화하여 MongoDB 클라이언트를 생성합니다.

• getDatabase() 메서드를 사용하여 데이터베이스에 연결합니다.

• 삽입할 문서를 준비합니다.

• getCollection() 메서드를 사용하여 문서를 삽입할 컬렉션 객체를 가져옵니다.

• 문서를 매개변수로 전달하며 insertOne() 메서드를 호출합니다.

3. 전체 예제 코드

import com.mongodb.client.MongoDatabase;
import org.bson.Document;
import com.mongodb.MongoClient;

public class InsertingDocument {
    public static void main( String args[] ) {
        // MongoDB 클라이언트 생성
        MongoClient mongo = new MongoClient( "localhost" , 27017 );
        // 데이터베이스 연결
        MongoDatabase database = mongo.getDatabase("myDatabase");
        // 컬렉션 생성
        database.createCollection("students");
        // 삽입할 문서 준비
        Document document = new Document();
        document.append("name", "Ram");
        document.append("age", 26);
        document.append("city", "Hyderabad");
        // 컬렉션에 문서 삽입
        database.getCollection("students").insertOne(document);
        System.out.println("Document inserted successfully");
    }
}

실행 결과

Document inserted successfully

참고 사항

위 예제는 MongoDB Java 드라이버 3.x 버전 기준입니다. 4.x 이상 버전에서는 new MongoClient("localhost", 27017) 생성자가 deprecated 되었으므로, MongoClients.create("mongodb://localhost:27017") 방식을 사용하는 것이 권장됩니다. 또한 여러 개의 문서를 한 번에 삽입해야 하는 경우 insertMany() 메서드를 활용하면 됩니다.