문서 삽입

개요

이 가이드 에서는 Java Reactive Streams 운전자 를 사용하여 삽입 작업을 수행하여 MongoDB 컬렉션 에 문서를 추가하는 방법을 학습 수 있습니다.

삽입 작업은 하나 이상의 문서를 MongoDB 컬렉션 에 삽입합니다. insertOne() 또는 insertMany() 메서드를 사용하여 삽입 작업을 수행할 수 있습니다.

_id 필드

MongoDB 컬렉션에서 각 문서에는 고유한 필드 값이 있는 _id 필드가 포함되어야 합니다.

MongoDB를 사용하면 이 필드를 두 가지 방법으로 관리할 수 있습니다.

• 각 _id 필드 값이 고유하도록 각 문서에 대해 이 필드를 직접 설정할 수 있습니다.

• 드라이버가 각 문서 _id 에 대해 고유한 ObjectId 값을 자동으로 생성하도록 할 수 있습니다. 문서에 대해 _id 값을 수동으로 설정하지 않으면 드라이버가 필드를 ObjectId 으로 채웁니다.

고유성을 보장할 수 없는 경우 드라이버가 _id 값을 자동으로 생성하도록 하는 것이 좋습니다.

_id 필드에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 고유 인덱스 가이드를 참조하세요.

문서 구조 및 규칙에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 문서 가이드를 참조하세요.

문서 하나 삽입

MongoDB 컬렉션 에 단일 문서 를 추가하려면 insertOne() 메서드를 호출하고 추가하려는 문서 를 전달합니다. 그런 다음 insertOne() 결과를 Mono 의 정적 Mono.from() 메서드에 전달합니다. Mono 는 Project Reactor 라이브러리의 클래스입니다. Java Reactive Streams에서 운전자 메서드는 콜드 Publisher 인스턴스를 반환하며, 이는 반환된 Publisher 을(를) 구독 하지 않는 한 해당 작업이 발생하지 않음을 의미합니다. 이 가이드 에서는 Project Reactor 라이브러리를 사용하여 이를 사용합니다. 에 학습 보려면 Mono 를 참조하세요. Project Reactor 문서에서 확인 가능합니다.Mono

다음 예시 에서는 insertOne() 메서드를 사용하여 name 값이 "Mongo's Burgers" 인 문서 를 restaurants 컬렉션 에 삽입합니다.

 Document document = new Document("name", "Mongo's Burgers");
 Publisher<InsertOneResult> insertPublisher = restaurants.insertOne(document);
 Mono.from(insertPublisher).block();

여러 문서를 삽입합니다.

MongoDB 컬렉션 에 여러 문서를 추가하려면 insertMany() 메서드를 호출하고 추가하려는 문서 목록을 전달합니다. 그런 다음 insertMany() 결과를 Mono 의 정적 Mono.from() 메서드에 전달합니다. Mono 는 Project Reactor 라이브러리의 클래스입니다. Java Reactive Streams에서 운전자 메서드는 콜드 Publisher 인스턴스를 반환하며, 이는 반환된 Publisher 을(를) 구독 하지 않는 한 해당 작업이 발생하지 않음을 의미합니다. 이 가이드 에서는 Project Reactor 라이브러리를 사용하여 이를 사용합니다. 에 학습 보려면 Mono 를 참조하세요. Project Reactor 문서에서 확인 가능합니다.Mono

다음 예시 에서는 insertMany() 메서드를 사용하여 restaurants 컬렉션 에 문서 목록을 삽입합니다.

 Document doc1 = new Document("name", "Mongo's Pizza");
 Document doc2 = new Document("name", "Mongo's Coffee");
 List<Document> documents = Arrays.asList(doc1, doc2);
 Publisher<InsertManyResult> insertPublisher = restaurants.insertMany(documents);
 Mono.from(insertPublisher).block();

삽입 동작 수정

InsertOneOptions 클래스에는 insertOne() 메서드의 동작을 수정하는 메서드가 포함되어 있습니다. InsertOneOptions 클래스를 사용하려면 클래스의 새 인스턴스 를 구성한 다음 해당 메서드 중 하나 이상을 호출하여 삽입 작업을 수정합니다. 이러한 메서드 호출을 함께 연결할 수 있습니다. 삽입 작업의 동작을 수정하려면 클래스 인스턴스 와 연결된 메서드 호출을 insertOne() 메서드의 두 번째 인수로 전달합니다.

InsertManyOptions 클래스를 사용하여 insertMany() 메서드를 비슷하게 수정할 수 있습니다.

InsertOneOptions 클래스에서 다음 메서드를 사용하여 insertOne() 메서드를 수정할 수 있습니다. 모든 메서드는 선택 사항입니다.

InsertManyOptions 클래스에는 이전 메서드와 다음 ordered() 메서드가 포함되어 있습니다.

 Document doc1 = new Document("name", "Mongo's Burgers");
 Document doc2 = new Document("name", "Mongo's Pizza");
 Document doc3 = new Document("name", "Mongo's Coffee");
 List<Document> documents = Arrays.asList(doc1, doc2, doc3);
Publisher<InsertManyResult> insertPublisher =
        restaurants.insertMany(documents,
                new InsertManyOptions().bypassDocumentValidation(true));
 Mono.from(insertPublisher).block();

추가 정보

Java Reactive Streams 운전자 를 사용하여 문서를 삽입하는 실행 가능한 코드 예제는 MongoDB 에 데이터 쓰기 가이드 를 참조하세요.