JSON

에러코드를 클라이언트에 JSON 형식으로 응답하려고 할 때, 라이브러리를 사용하지 않고 간단하게 문자열을 조합하는 toJson() 메서드를 직접 만들고 싶었다. public class MsgCode { private String code = "ER01"; private String message = "인증코드가 유효하지 않습니다."; public String toJson() { // 구현 방식에 따라 다름 }} 이때 어떤 방식으로 문자열을 조합할지 고민하게 되었고, 가장 흔히 사용되는 다음 3가지 방식을 비교해 보게 되었다.String.format(...)StringBuilder+ 연산자 따라서 이번 포스팅에서는 간단한 JSON 문자열을 직접 만들 때 사용할 수 있는 3..

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..