MongoDB는 NoSQL 데이터베이스로, 그 유연성 덕분에 Spring Boot와 자주 함께 사용됩니다. Spring Boot에서는 Spring Data MongoDB를 통해 MongoDB 연동을 쉽게 할 수 있습니다. Spring Data MongoDB는 두 가지 주요 방식을 제공합니다.

바로 MongoTemplate와 MongoRepository 입니다.
 
이번 포스팅에서는 이 두 가지 방법을 비교하고, 어떤 상황에서 각각을 사용하는 것이 좋은지 살펴보겠습니다.
 
[MongoRepository]
MongoRepository는 레파지토리 패턴을 기반으로 한 인터페이스입니다. 기본적인 CRUD 메서드를 자동으로 제공합니다. Spring Data JPA와 비슷하게 작동하며, MongoDB 데이터를 처리하는 데 매우 간단한 방법을 제공합니다.
 
장점
 * 기본적인 CRUD 작업을 자동으로 처리
 * 코드가 매우 간결하고 유지보수가 쉬움
 * 메서드 이름만으로 커스텀 쿼리를 작성할 수 있음 (ex. findByCategory)
단점
 * 복잡한 쿼리 작업에서는 제한적
 * 커스터마이징이 어렵고 고급 기능을 구현하기에 한계가 있음
 
[MongoTemplate]
MongoTemplate은 Spring의 템플릿 패턴을 사용한 MongoDB 연동 방식입니다. 더 복잡한 MongoDB 제어가 가능하며, 어려운 쿼리 작성에 적합합니다.
 
장점
 * 복잡한 쿼리나 커스텀 작업을 더 쉽게 수행 가능
 * MongoDB와의 깊이 있는 상호작용에 적합
 * 더 세밀한 데이터 처리와 제어가 가능
단점
 * 기본적인 CRUD 작업도 코드로 직접 작성해야 하므로 코드가 다소 복잡해짐
 * 레파지토리 패턴보다 다소 비효율적일 수 있음
 
[MongoRepository 사용 예시]

Product 엔티티
@Document(collection = "products")
public class Product {
    @Id
    private String id;
    private String name;
    private String category;
}

ProductRepository 인터페이스
public interface ProductRepository extends MongoRepository<Product, String> {
    List<Product> findByCategory(String category);
}

MongoRepository를 확장한 ProductRepository를 정의하였습니다. CRUD 메서드는 기본으로 제공되며, 커스텀으로 findByCategory 같은 메서드를 쉽게 추가할 수 있습니다.
 
CRUD 작업 사용 예시
@Autowired
private ProductRepository productRepository;

public void addProduct(Product product) {
    productRepository.save(product);
}

public List<Product> getProductsByCategory(String category) {
    return productRepository.findByCategory(category);
}

이처럼 MongoRepository를 사용하면 간단한 CRUD 작업을 매우 직관적으로 처리할 수 있습니다.
 
[MongoTemplate 사용 예시]
이번에는 같은 Product 엔티티를 사용하여 MongoTemplate을 이용한 예제를 살펴보겠습니다.
 
MongoTemplate으로 복잡한 쿼리 작성
@Autowired
private MongoTemplate mongoTemplate;

public List<Product> findProductsByCategory(String category) {
    Query query = new Query();
    query.addCriteria(Criteria.where("category").is(category));
    return mongoTemplate.find(query, Product.class);
}

위 코드에서는 MongoTemplate을 사용하여 MongoDB 쿼리를 직접 사용했습니다. Criteria와 Query 객체를 이용해 더 복잡한 쿼리나 고급 기능을 쉽게 구현할 수 있습니다.
 
CRUD 작업 처리 
public void addProduct(Product product) {
    mongoTemplate.save(product);
}

public Product getProductById(String id) {
    return mongoTemplate.findById(id, Product.class);
}

MongoTemplate을 사용하면 모든 작업을 수동으로 처리해야 하지만, 그만큼 더 세밀하게 제어할 수 있는 장점이 있습니다.
 
[어떤 것을 선택해야 할까?]
MongoRepository를 사용해야 할 때:
 * 기본적인 CRUD 작업을 빠르게 처리해야 할 때
 * 코드의 간결함과 유지보수의 용이함이 중요할 때
MongoTemplate을 사용해야 할 때:
 * 복잡한 쿼리나 트랜잭션 처리가 필요한 경우
 * 데이터베이스와의 더 세밀한 상호작용이 필요할 때
 
[결론]
MongoDB와 Spring Boot의 연동에서 MongoRepository와 MongoTemplate은 각각 다른 용도에 맞춰 설계된 도구입니다. 저는 실제 프로젝트에서 bulk upsert 기능이 필요한 상황을 겪었는데, MongoRepository에는 해당 기능이 기본적으로 제공되지 않아, 더 유연한 MongoTemplate을 사용할 수밖에 없었습니다. 물론 upsert를 여러 번 호출하는 방법도 가능하지만, 이는 비효율적이므로 MongoTemplate을 통해 간단히 처리할 수 있었습니다.
 
반면, 단순한 조회 작업에서는 MongoRepository를 사용했습니다. MongoTemplate보다 코드가 훨씬 깔끔하고 유지보수하기가 쉬웠기 때문입니다. 이처럼 MongoRepository는 기본적인 작업에 최적화되어 있고, MongoTemplate은 고급 작업에서 강력한 기능을 제공합니다.
 
결국 중요한 것은 프로젝트의 요구사항에 맞춰 이 두 방식을 적절히 선택하거나 혼합하여 사용하는 것입니다. 각 도구가 제공하는 장점을 최대한 활용해, 프로젝트에 가장 적합한 솔루션을 찾는 것이 성공적인 MongoDB 연동의 핵심입니다.

?️MongoRepository vs MongoTemplate

맥에서 화면녹화를 위해서 기본 녹화 기능을 사용했었는데요.
무료이고 UI도 깔끔한 것 같아서 공유해봅니다.
https://scre.io

화면 녹화 도구

첫 직장에서 3년 2개월, SI 업체에 재직하며 느꼈던 감정들과 배웠던 것들, 그리고 이직을 결심하게 된 계기 등을 정리해 보았습니다 :)
즐겁게 읽어주셨으면 좋겠습니다.

https://datajunseo.tistory.com/5#comment19589257

[회고] 3년 2개월간의 회사생활과 이직을 결심하기까지

위대한상상 마케팅 데이터 사이언티스트 

부릉부릉

위대한상상 백엔드 개발자

익채

레드버튼소프트 CTO

서명석

요기요 데이터분석가

김준서

위대한상상 프로덕트 오너

김진주

위대한상상(요기요) 백엔드 개발자

이승훈

위대한상상 정보보안

이승준

위대한상상 데이터 엔지니어

이재현

위대한상상 시니어 UX/UI 연구원

정수영

이준영

위대한상상 백엔드개발자

김종호

위대한상상 교육 기획운영

권혜성

위대한상상 개발 메니저

박오영

위대한상상/요기요/크리에이티브 센터장

minsoo

위대한상상(요기요) 개발자

상협

Ji Yeon K

개발

신범철

위대한상상(요기요) product owner

poppy

위대한상상(요기요) 백엔드개발자

Haeman

그로스

손완주

프로덕트 디자이너

yams

김지현

포알엑스(홍보/프레젠터)

CHOI

위대한상상(요기요) B2B 세일즈 매니저

이승원

위대한상상(요기요) 데이터 엔지니어

장수완

김병철

심설송

프로덕트 매니저/서비스 기획

위대한상상(요기요) 브랜드마케터

햄쓰

위대한상상(요기요) HRD

정다연

위대한상상(요기요) iOS 개발자

이재은

위대한상상(요기요) 안드로이드 개발

이재우

위대한상상(요기요) Data engineer

ParkJung Hoo

✉️?

위대한상상(요기요) 프로덕트 오너

송유경

잔수

위대한상상(요기요) Data Engineer

이채원

김준영

위대한상상(요기요) 제휴마케팅실 프로모션 마케터

지선

위대한상상(요기요) 프론트 개발자

이경준

위대한상상(요기요) PO

신민정

위대한상상(요기요) serger engineer

안성미

위대한상상(요기요) UX Researcher

황해솔

Product Owner

김명선

위대한상상(요기요) Senior UX Researcher

조수연

오세영

황섬

위대한상상(요기요) 소프트웨어 엔지니어

위대한

두루두

위대한상상(요기요) 개발팀 사원

Young Seok

ㄱㅈㅇ

위대한상상(요기요) 데이터 사이언티스트

조준형

위대한상상(요기요) 프론트엔드 개발자

김하진

위대한상상(요기요) ios 개발자

이장훈

위대한상상(요기요) 실장

김수정

장진호

백엔드 개발자

신일섭

임동명

코린이

큐브라떼

새벽

데브옵스 엔지니어

이주원

요기요 백엔드 개발자

권태형

요기요 소프트웨어 엔지니어

송경용

권진호

이수영

위대한상상(요기요) 머신러닝 엔지니어

위대한상상(요기요) UX/UI 디자이너

이미희

jjss

위대한상상(요기요) 머신러닝 개발자

문희원

수정

weecda

요기요 프로덕트 디자이너

김연수

Data Scientist

Minjae Lee (이민재)

위대한상상(요기요) 프로덕트 디자이너

위대한상상(요기요) 프로덕트 매니저

김효진

데이터 분석

지성민

데이터분석가

박효성

Younguk

위대한상상(요기요) 시니어 프로덕트 매니저

이승혜

김정빈

위대한상상(요기요) 

hiddung12

힐링페이퍼 웹 프론트엔드 개발자

홍단비

김예현

위대한상상(요기요) 사무직

박정인

위대한상상(요기요) 안드로이드 개발자

강원대학교 컴퓨터정보통신공학

김남진

브랜드 마케터

조규민

seongwoo

Frontend Engineer

고진영

위대한상상(요기요) DBA

강민우

김재민

아주대학교 정보 및 컴퓨터공학

종범

세종대학교 대학원 컴퓨터공학과

이승진

위대한상상(요기요) mlops

우종호_torres

위대한상상

언어

프론트엔드

백엔드

데이터베이스

데브옵스

python

Java

typescript

React

Next.js

React Query

Redux

Styled-Components

Recoil

Ruby

Node.js

django

Spring

fastapi

기술 스택

언어