JSON to Java record 변환기

사용 방법

1. 1

   JSON 객체 또는 배열 붙여 넣기

   페이로드를 붙여 넣거나 예제(API 응답, 중첩 배열, 엣지 케이스) 중 하나를 불러옵니다. 최상위가 문자열·숫자·불리언·null 단독 값이면 이름을 붙일 타입이 없어 오류가 표시됩니다.

2. 2

   옵션 설정

   루트 타입 이름(기본 Payload)과 패키지(기본은 비어 있어 package 줄이 없음)를 입력하고, Jackson @JsonProperty를 켜거나 끕니다.

3. 3

   출력 읽기

   import가 먼저 나오고, 이어서 public 루트 record, 그다음 중첩 record가 처음 만난 순서대로 나옵니다. 루트가 배열이면 루트 record 대신 // The root JSON value is List<...> 주석이 나옵니다.

4. 4

   import 확인

   com.fasterxml.jackson.annotation.JsonProperty는 Jackson 옵션이 켜져 있고 이름이 바뀐 컴포넌트가 하나 이상일 때만 나옵니다. java.util.List는 컴포넌트 타입으로 리스트가 선언될 때만 나옵니다.

5. 5

   복사하거나 .java로 저장

   루트 record가 public이므로 Payload.java처럼 루트 이름으로 파일을 저장합니다. 중첩 record는 패키지 전용이라 같은 파일에 둘 수 있습니다.

작동 원리

@JsonProperty("first_name")
String firstName,
List<Long> scores,
Long qty

실제 예시

{"id":42,"user":{"name":"Ada","active":true},"roles":["admin","editor"]}

import java.util.List;

public record Payload(
    long id,
    PayloadUser user,
    List<String> roles
) {}

record PayloadUser(
    String name,
    boolean active
) {}

{"first_name":"Ada","class":"A","default":true,"user-agent":"curl","2fa":false}

import com.fasterxml.jackson.annotation.JsonProperty;

public record Payload(
    @JsonProperty("first_name")
    String firstName,
    @JsonProperty("class")
    String class_,
    @JsonProperty("default")
    boolean default_,
    @JsonProperty("user-agent")
    String userAgent,
    @JsonProperty("2fa")
    boolean field2fa
) {}

{"scores":[1,2,3],"flags":[true,false],"grid":[[1.5,2],[3]]}

import java.util.List;

public record Payload(
    List<Long> scores,
    List<Boolean> flags,
    List<List<Double>> grid
) {}

{"orders":[{"id":1,"total":9.5,"coupon":null},{"id":2,"total":12,"note":"gift"}]}

import java.util.List;

public record Payload(
    List<PayloadOrder> orders
) {}

record PayloadOrder(
    long id,
    double total,
    Object coupon,
    String note
) {}

[{"user_id":1},{"user_id":2,"email":"a@b.c"}]

package com.acme.model;

// The root JSON value is List<UserListItem>

record UserListItem(
    long userId,
    String email
) {}

자주 하는 실수

• 샘플 하나로는 항상 있는 필드인지 알 수 없습니다

  래퍼 타입은 붙여 넣은 요소 중 하나 이상에서 키가 없거나 null일 때만 나옵니다. 레코드가 하나뿐이면 전부 원시 타입이 되고, Jackson은 없는 키를 오류 없이 0이나 false로 바꿉니다. 값이 빠진 레코드를 포함해 여러 개를 붙여 넣으세요.

• Jackson을 끄면 이름이 바뀐 키가 바인딩되지 않습니다

  Jackson 옵션을 끄면 user_id 같은 키는 어노테이션 없는 userId 컴포넌트가 됩니다. ObjectMapper는 userId를 찾다가 데이터를 놓칩니다. 키를 대신 매핑해 주는 명명 전략을 쓰지 않는다면 옵션을 켜 두세요.

• 2^63 미만의 정수 표기는 long입니다

  절댓값 2^63 미만인 정수 표기는 long, 2^63 이상은 double입니다. 10.0과 1e3도 double입니다. 2^53을 넘는 정확한 ID는 문자열로 입력하고 String이나 BigInteger를 쓰세요.

• null뿐인 필드는 Object가 됩니다

  붙여 넣은 모든 레코드에서 null인 키나 빈 배열은 타입 정보가 없어 Object 또는 List<Object>가 됩니다. 실제 타입을 알게 되면 String, Long, record 등으로 바꾸세요.

• 파일 하나에 public record는 하나

  루트 record만 public이므로 Payload.java처럼 그 이름으로 파일을 저장해야 합니다. 중첩 record는 패키지 전용이라 다른 패키지에서 쓰려면 별도 파일로 옮기세요. 루트 타입 이름을 바꾸면 파일 이름도 바뀝니다.

• 충돌하는 이름은 합쳐지지 않고 번호가 붙습니다

  한 객체의 user_id와 userId는 userId와 userId2가 되고, 둘 다 자기 키를 가리키는 @JsonProperty를 받습니다. 두 키가 정말 다른 필드인지 확인하세요.

자주 묻는 질문