Spring Boot DTO ↔ Entity 변환 방법

📌 왜 DTO ↔ Entity 변환이 필요한가?

Entity는 DB 모델이고, DTO는 입출력·뷰 모델이기 때문.

엔티티를 그대로 노출하면 보안·커플링·유효성 검증·API 스펙 분리 문제가 생기므로,

DTO로 변환해서 외부와 내부를 분리하는 것이 Spring 실무 표준이다.

 

📌 객체 변환 3가지 방법 비교

Spring Boot에서 DTO ↔ Entity 변환 시 대표적으로 아래 3가지를 비교할 수 있다.

 

📍 비교 기준

1. 컬렉션(List) 변환
2. 연관 관계 필드 변환 (예: User → Address 포함)
3. 타입 변환 (예: LocalDateTime → String)

방법	List 변환	연관 관계 필드 변환	타입 변환 (예: LocalDateTime → String)
BeanUtils.copyProperties()	❌ 수동 처리 필요	❌ 자동 변환 불가	❌ 직접 변환 필요
ModelMapper	✅ 자동 변환 가능	😐 일부 변환 가능	✅ 커스텀 변환 지원
수동 변환 (직접 매핑)	✅ 완벽한 제어 가능	✅ 원하는 대로 변환 가능	✅ 원하는 방식으로 변환 가능

---

✅ 1. BeanUtils.copyProperties()

Spring의 BeanUtils.copyProperties()는 간단한 DTO 변환에 유용.
하지만, 연관 관계 필드(@OneToMany, @ManyToOne)나 타입 변환(LocalDateTime → String)이 자동으로 처리되지 않아서 직접 변환해야 한다.

 

🔹 예제 코드

• OrderItemDetails orderItemDetails = new OrderItemDetails();
• BeanUtils.copyProperties(orderItem, orderItemDetails);

 

🔥 장점 & 단점

✔ 장점
빠르고 단순
필드명이 같으면 자동 변환

 

❌ 단점
커스텀/중첩 필드 처리 거의 없음

 

🔹 리스트 변환 및 연관 관계 변환 예제 (수동 처리 필요)

orderItemDetails.setOrderId(orderItem.getOrder().getOrderId()); // 연관 관계 필드 직접 매핑
orderItemDetails.setProductName(orderItem.getProduct().getName());

 

---

✅ 2. ModelMapper

ModelMapper는 List 변환, 연관 관계 변환, 타입 변환을 자동으로 처리.
하지만 성능이 다소 저하될 수 있음.

 

🔹 예제 코드

• ModelMapper modelMapper = new ModelMapper();
• OrderItemDetails orderItemDetails = modelMapper.map(orderItem, OrderItemDetails.class);

 

🔥 장점 & 단점

✔ 장점
자동 매핑, 컨벤션 기반

 

❌ 단점
설정 복잡, 런타임 성능 이슈 가능

 

🔹 리스트 & 연관 관계 자동 변환 예제

modelMapper.createTypeMap(Product.class, ProductDTO.class)
    .addMappings(mapper -> {
        mapper.map(Product::getName, ProductDTO::setProductName);
        mapper.map(src -> src.getCategory().getCategoryName(), ProductDTO::setCategoryName);
    });

 

---

✅ 3. 수동 변환

연관 관계(@OneToMany, @ManyToOne) 필드 변환, 리스트 변환, 타입 변환을 완벽하게 제어할 수 있다.
하지만 코드가 길어질 수 있음.

 

🔹 예제 코드

public static ProductDTO convertToDto(Product product) {
    ProductDTO productDTO = new ProductDTO();
    productDTO.setId(product.getId());
    productDTO.setName(product.getName());

    // 연관 관계 변환
    productDTO.setCategoryName(product.getCategory().getCategoryName());

    // 리스트 변환
    List<ProductDetailDTO.ProductStockDto> stockDTOs = product.getStocks().stream()
        .map(stock -> new ProductDetailDTO.ProductStockDto(
            stock.getSize().getSizeName(),
            stock.getColor().getColorName(),
            stock.getStockQuantity()))
        .collect(Collectors.toList());

    productDTO.setProductStocks(stockDTOs);

    return productDTO;
}

 

🔥 장점 & 단점

✔ 장점
가장 명확, 유지보수 쉬움

 

❌ 단점
코드가 길어질 수 있음

---

🚀 최종 결론: 어떤 방법을 선택할까?

방법	추천 사용 경우
BeanUtils.copyProperties()	필드명이 동일한 간단한 DTO 변환일 때
ModelMapper	자동 변환이 필요한 경우 (연관 관계 포함)
수동 변환	최대 성능 & 정확한 제어가 필요한 경우