DTO

DTO에서 Map이나 Map를 사용하는 이유는 확장 가능한 필드나 유동적인 구조를 처리하기 위해서다. 하지만 내부 로직에서는 HashMap을 자주 쓰기 때문에, DTO에서도 HashMap을 써도 되는지 의문이 들었다. 따라서 이번 글에서는 DTO에서 Map 타입을 사용하는 이유부터 HashMap을 사용하면 생기는 문제점, 그리고 실무에서 추천하는 선언 방식까지 정리해보려 한다.DTO에서 Map을 사용하는 이유Map은 키-값 구조로 데이터를 표현할 수 있어 다음과 같은 상황에 적합하다.구조가 고정되지 않은 동적 JSON 필드를 처리할 때메시지 또는 요청 본문에 확장성을 부여할 때외부 입력을 그대로 받되, 정확한 구조를 알 수 없을 때예를 들어 다음과 같은 JSON이 들어올 때,{ "type": "noti..

API를 설계하다 보면 하나의 기능에도 다양한 요청 구조가 존재할 수 있다.예를 들어 단일 항목 등록, 다중 항목 일괄 등록, 간단한 등록, 복잡한 등록처럼 요청 방식이나 포함 필드가 달라지는 경우, 이를 어떻게 DTO 클래스로 잘 표현할 수 있을지 고민하게 된다. 따라서 이번 포스팅에서는 요청 JSON 구조에 따라 DTO를 어떻게 나누고 상속할 것인지, 그 판단 기준과 설계 전략을 정리해보려 한다.✅ 흔히 마주치는 JSON 구조예시로, 상품 등록 API를 설계한다고 가정했을때,클라이언트에서 보낼 수 있는 요청은 다음과 같이 다양할 수 있습니다.1. 단건 상품 등록 { "productId": "P1234", "name": "Notebook", "price": 120000}2. 다건 상품 등록 (일괄..

API를 구현하고 테스트하는 중, 분명히 요청 JSON에 값이 들어있는데도 DTO의 필드 값이 null로 들어오는 이슈가 있었다. 코드도 문제 없고, 필드명도 잘 맞췄다고 생각했는데, 알고 보니 클라이언트는 snake_case로 JSON을 보내고 있었고, 서버는 camelCase로 작성된 DTO로 값을 받도록 설계되어 있었던 것이 원인이었다. 이에 따라 이번 포스팅에서는 Jackson 라이브러리에서의 snake_case JSON 매핑 이슈와 그 해결 방법에 대해 정리해보려 한다.💡 문제 상황다음과 같은 요청 JSON이 클라이언트로부터 들어올 때,{ "user_id": "kim123", "user_name": "kim"}DTO는 일반적으로 자바 컨벤션을 따라 camelCase로 정의하고 있다.pub..

기존 프로젝트에서 클라이언트가 보내는 요청 데이터를 @RequestBody로 받을 때 JsonNode를 사용하고 있었다. 처음엔 큰 고민 없이 따라 썼지만, 점점 요청 구조가 명확해지고, 검증이 필요해지면서 "DTO 클래스로 받는 게 더 깔끔하지 않을까?"하는 생각이 들었다. 실제로 API 요청을 JSON으로 받을 때는 보통 Map, DTO 클래스, 그리고 JsonNode 중 하나를 선택하게 되는데, 각각의 방식은 분명한 차이점과 쓰임새가 존재한다. 따라서 이번 포스팅에서는 세 가지 방식의 특징과 언제 어떤 방식이 적절한지에 대해 정리해 보려한다.Map으로 받을 경우public ResponseEntity send(@RequestBody Map request) { ... }JSON 데이터를 그냥 key-v..

API를 개발하던 중, 요청으로 들어오는 JSON 구조와 실제 DB에 저장해야 하는 컬럼 구조가 서로 다른 경우를 마주했다. 그동안은 상황에 따라 Model 클래스를 임의로 만들거나, DB 구조 또는 요청 구조 중 하나에 맞춰 사용하는 방식으로 처리해왔다. 하지만 이번에는 요청 객체를 그대로 DB에 저장할 수 없는 상황이 생기면서, 구조 분리를 어떻게 해야 할지 고민이 깊어졌다.이 과정에서 DTO와 VO의 개념을 다시 떠올렸지만, 정확히 언제 어떻게 나눠서 써야 하는지에 대해서는 명확하지 않았다. 따라서 이번 포스팅에서는 DTO와 VO의 정의, 구조, 사용 위치 등에 대해 정리해보려 한다.DTO와 VO란?🧾 DTO (Data Transfer Object)정의: 계층 간 또는 네트워크 전송 시 데이터를 ..

API 개발 중 JSON 배열 형태의 요청을 받게 되었고, 이를 DTO로 어떻게 구성할지 고민이 생겼다. 특히 하위 구조를 내부 클래스로 만들지, static 중첩 클래스로 할지, 혹은 별도 파일로 분리할지 결정이 쉽지 않았다. 각 방식의 차이점과 효율성에 대해 명확히 알지 못했던 터라, 이번 기회에 정리해두면 좋겠다고 생각했다. 그래서 이 글에서는 Java의 내부 클래스와 중첩 클래스의 차이점, 그리고 DTO 설계 시 어떤 기준으로 선택해야 하는지를 실무 중심으로 정리해보려 한다.중첩 클래스와 내부 클래스 개념 정리✅ 내부 클래스 (Inner Class)클래스 내부에 정의된 인스턴스 클래스바깥 클래스의 인스턴스에 암묵적으로 참조를 가짐정적(static) 키워드가 없음일반적으로 UI 구성, 이벤트 처리 ..