JSON을 Java class 코드로 변환하세요!

JSON을 입력하면 중첩 객체까지 Java DTO·POJO·record 코드로 변환합니다! Jackson @JsonProperty, Lombok 지원. Spring Boot JPA 엔티티·MongoDB 도큐먼트는 위 탭에서.
JSON
결과
 

JSON을 Java class 코드로 변환하세요!

JSON 예시를 넣으면 Jackson으로 바로 역직렬화할 수 있는 Java 클래스나 record를 만듭니다. 중첩 객체는 같은 파일 안의 클래스로 이어지고, 배열은 List<T>가 됩니다.

Spring Boot에서 외부 API 응답을 받는 DTO, RestTemplate·WebClient·Feign 클라이언트의 반환 타입처럼 필드를 일일이 옮겨 적기 번거로운 클래스를 만들 때 씁니다. Java 16 이상이라면 record, 기존 코드베이스가 Lombok을 쓴다면 Lombok 옵션으로 프로젝트 스타일에 맞출 수 있습니다.

사용 방법

  1. API 응답 JSON을 입력 칸에 붙여넣습니다.
  2. 타입 이름에 DTO 이름을 적습니다. 첫 번째 클래스만 public이 되므로 파일 이름과 같게 정하는 것이 좋습니다.
  3. 스타일에서 class(getter/setter 포함) 또는 record를 고릅니다.
  4. class를 골랐다면 Lombok을 켜서 getter/setter 대신 @Data·@NoArgsConstructor·@AllArgsConstructor로 바꿀 수 있습니다.
  5. 생성된 코드를 .java 파일에 붙여넣고 패키지 선언을 추가합니다.

예시

입력 (JSON)
{
  "id": 1296269,
  "full_name": "octocat/Hello-World",
  "private": false,
  "stargazers_count": 80,
  "owner": { "login": "octocat", "site_admin": false },
  "topics": ["api", "demo"]
}
출력 (Java · class)
import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;

public class Repository {
    private Integer id;
    @JsonProperty("full_name") private String fullName;
    @JsonProperty("private") private Boolean private_;
    @JsonProperty("stargazers_count") private Integer stargazersCount;
    private Owner owner;
    private List<String> topics;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getFullName() {
        return fullName;
    }

    public void setFullName(String fullName) {
        this.fullName = fullName;
    }

    public Boolean getPrivate() {
        return private_;
    }

    public void setPrivate(Boolean private_) {
        this.private_ = private_;
    }

    public Integer getStargazersCount() {
        return stargazersCount;
    }

    public void setStargazersCount(Integer stargazersCount) {
        this.stargazersCount = stargazersCount;
    }

    public Owner getOwner() {
        return owner;
    }

    public void setOwner(Owner owner) {
        this.owner = owner;
    }

    public List<String> getTopics() {
        return topics;
    }

    public void setTopics(List<String> topics) {
        this.topics = topics;
    }
}

class Owner {
    private String login;
    @JsonProperty("site_admin") private Boolean siteAdmin;

    public String getLogin() {
        return login;
    }

    public void setLogin(String login) {
        this.login = login;
    }

    public Boolean getSiteAdmin() {
        return siteAdmin;
    }

    public void setSiteAdmin(Boolean siteAdmin) {
        this.siteAdmin = siteAdmin;
    }
}

full_name처럼 snake_case인 키는 fullName 필드에 @JsonProperty로 연결됩니다. private는 Java 예약어라 필드는 private_가 되었지만 접근자는 getPrivate()/setPrivate()로 만들어지고, owner 객체는 같은 파일의 Owner 클래스로 분리됐습니다.

지원 기능

  • 출력 스타일: getter/setter가 있는 일반 class 또는 불변 record.
  • Lombok 옵션(class일 때만): @Data, @NoArgsConstructor, @AllArgsConstructor와 import를 넣고 접근자 코드를 생략합니다.
  • JSON 키와 필드 이름이 다를 때만 @JsonProperty를 붙이고 com.fasterxml.jackson.annotation.JsonProperty를 import합니다.
  • 모든 필드는 Integer, Long, Double, Boolean 같은 래퍼 타입이라 JSON의 null을 그대로 담을 수 있습니다.
  • 21억(32비트)을 넘는 정수가 있으면 Long, 타입이 섞인 값은 Object가 됩니다.
  • class, default 같은 예약어 키는 뒤에 _를 붙이고, 숫자로 시작하는 키는 앞에 n을 붙입니다.
  • 최상위가 배열이면 Java에 타입 별칭이 없으므로 // Root: List<RootItem> 주석과 요소 클래스를 만듭니다.

사용 사례

Spring Boot에서 외부 API 응답 DTO 만들기

결제사·지도·메신저 API 문서의 응답 예시를 붙여넣으면 restTemplate.getForObject(url, PaymentResponse.class)에 바로 넘길 수 있는 클래스가 나옵니다. 중첩 구조가 깊을수록 손으로 쓸 때보다 빠지는 필드가 적습니다.

record로 읽기 전용 응답 모델 정의

응답을 받아 읽기만 하는 모델이라면 record가 setter 없이 짧고, Jackson 2.12 이상은 record 생성자로 바로 역직렬화합니다.

테스트 픽스처 JSON에서 모델 역추적

레거시 프로젝트에서 테스트용 JSON 파일만 있고 대응하는 클래스가 없을 때, 픽스처를 넣어 필드 구성을 확인하고 DTO 초안을 잡을 수 있습니다.

주의사항

  • 필드가 일부 항목에만 있어도 래퍼 타입이라 null로 들어올 뿐 별도 표시가 없습니다. 필수 값 검증이 필요하면 @NotNull 등을 직접 추가하세요.
  • 알 수 없는 키가 오면 Jackson 기본 설정에서 예외가 납니다. API가 필드를 추가할 수 있다면 @JsonIgnoreProperties(ignoreUnknown = true)나 FAIL_ON_UNKNOWN_PROPERTIES 설정을 고려하세요.
  • 날짜 문자열은 String으로 나옵니다. LocalDateTime·OffsetDateTime으로 바꾸려면 jackson-datatype-jsr310 모듈이 필요합니다.
  • record를 고르면 Lombok 옵션은 숨겨집니다. record에는 Lombok이 필요하지 않기 때문입니다.
  • 중첩 클래스는 public이 아닌 같은 파일의 패키지 전용 클래스로 나옵니다. 다른 패키지에서 쓰려면 파일을 나누세요.

자주 묻는 질문

boolean 필드인데 getter가 왜 isXxx가 아니라 getXxx인가요?

필드 타입이 원시 boolean이 아니라 Boolean 래퍼라서입니다. Jackson은 오랫동안 isXxx 접근자를 원시 boolean에만 인정해 왔기 때문에, 버전에 상관없이 같은 프로퍼티로 읽히도록 getXxx로 만듭니다.

record 출력도 @JsonProperty가 붙나요?

네. 이름이 바뀐 컴포넌트 앞에 @JsonProperty("full_name") String fullName처럼 붙습니다. Jackson 2.12 이상이면 record의 정규 생성자를 사용해 값이 채워집니다.

Spring의 spring.jackson.property-naming-strategy=SNAKE_CASE를 쓰면 @JsonProperty를 지워도 되나요?

전역 SNAKE_CASE 전략을 켜 두었다면 full_name ↔ fullName 매핑은 어노테이션 없이도 됩니다. 다만 private_처럼 예약어 때문에 바뀐 이름은 전략으로 맞춰지지 않으니 그 어노테이션은 남겨 두세요.

Gson에서도 쓸 수 있나요?

Gson은 @JsonProperty를 읽지 않습니다. 생성된 class 출력에서 어노테이션을 @SerializedName으로 바꾸면 Gson에서도 같은 구조로 쓸 수 있습니다. record는 Gson 2.10 이상에서 지원됩니다.