문서 교체

개요

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

바꾸기 작업은 MongoDB 컬렉션 의 문서 하나를 지정한 새 필드와 값으로 바꿉니다. replaceOne() 메서드를 사용하여 바꾸기 작업을 수행할 수 있습니다.

대체 작업

MongoCollection 인스턴스 에서 replaceOne() 메서드를 사용하여 바꾸기 작업을 수행할 수 있습니다. 이 메서드는 검색 기준과 일치하는 첫 번째 문서 에서 _id 필드 를 제외한 모든 필드를 제거한 다음 지정한 필드와 값을 빈 문서 에 추가합니다.

바꾸기 예시

MongoDB 컬렉션 의 단일 문서 대체하려면 replaceOne() 메서드를 호출하고 쿼리 필터하다 문서 와 대체 문서 매개변수로 전달합니다. 그런 다음 replaceOne() 결과를 Mono의 정적 Mono.from() 메서드에 전달합니다. Mono 는 Project Reactor 라이브러리의 클래스입니다. Java Reactive Streams에서 운전자 메서드는 콜드 Publisher 인스턴스를 반환하므로 반환된 Publisher를 구독 않는 한 해당 작업이 발생하지 않습니다. 이 가이드 Project Reactor 라이브러리를 사용하여 이를 사용합니다. Mono에 대해 자세히 학습하려면 Project Reactor 문서에서 Mono 를 참조하세요.

다음 예시 에서는 replaceOne() 메서드를 사용하여 문서 의 필드와 값을 name 필드 값 "Pizza Town" 로 바꿉니다. replaceOne() 메서드는 원본 문서 를 name 필드 값이 "Mongo's Pizza" 이고 cuisine 필드 값이 "Pizza" 인 문서 로 대체합니다.

 Publisher<UpdateResult> replacePublisher = restaurants.replaceOne(
         eq("name", "Pizza Town"),
         new Document().append("name", "Mongo's Pizza")
                 .append("cuisine", "Pizza"));
 Mono.from(replacePublisher).block();

바꾸기 동작 수정

옵션 메서드를 호출하여 replaceOne() 메서드의 동작을 선택적으로 수정할 수 있습니다. ReplaceOptions 클래스는 replaceOne() 메서드의 동작을 수정하는 메서드를 제공합니다. ReplaceOptions 클래스를 사용하려면 클래스의 새 인스턴스 를 구성한 다음 해당 메서드 중 하나 이상을 호출하여 바꾸기 작업을 수정합니다. 이러한 메서드 호출을 함께 연결할 수 있습니다. 대체 작업의 동작을 수정하려면 클래스 인스턴스 와 연결된 메서드 호출을 replaceOne() 메서드의 마지막 인수로 전달합니다.

ReplaceOptions 클래스에서 다음 메서드를 사용하여 replaceOne() 메서드를 수정할 수 있습니다.

Publisher<UpdateResult> replacePublisher = restaurants.replaceOne(
        eq("name", "Food Town"),
        new Document().append("name", "Food World")
                .append("cuisine", "Mixed"),
        new ReplaceOptions().upsert(true));
Mono.from(replacePublisher).block();

반환 값

replaceOne() 메서드는 UpdateResult 객체 를 반환합니다. UpdateResult 유형에서 다음 메서드를 사용하여 해당 정보에 액세스 합니다.

추가 정보

문서를 Java Reactive Streams 운전자 로 바꾸는 실행 가능한 코드 예제는 CRUD 작업 가이드 참조하세요.