JSON to Rust 구조체 변환기

JSON to Rust 변환이란 무엇인가요?

예시

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub id: i64,
    pub name: String,
    pub email: String,
    pub active: bool,
    pub roles: Vec<String>,
}

{"repo":"serde","owner":{"login":"dtolnay","id":100}}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub repo: String,
    pub owner: Owner,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Owner {
    pub login: String,
    pub id: i64,
}

{"users":[{"id":1,"nick":"x"},{"id":2}]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub users: Vec<User>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct User {
    pub id: i64,
    pub nick: Option<String>,
}

{"login":"octocat","publicRepos":15,"followerCount":9001,"createdAt":"2011-01-25"}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub login: String,
    #[serde(rename = "publicRepos")]
    pub public_repos: i64,
    #[serde(rename = "followerCount")]
    pub follower_count: i64,
    #[serde(rename = "createdAt")]
    pub created_at: String,
}

JSON을 Rust로 변환하는 방법

1. 1

   JSON 붙여넣기

   JSON 객체, 배열 또는 API 응답을 입력 상자에 넣으세요. 변환이 즉시 시작됩니다.

2. 2

   출력 조정

   루트 구조체의 이름을 바꾸고 serde derive, Debug와 Clone, pub 가시성을 토글하여 crate 스타일에 맞추세요.

3. 3

   복사 또는 다운로드

   생성된 Rust를 한 번의 클릭으로 가져와 프로젝트에 바로 붙여넣으세요.

Common Use Cases

타입이 지정된 API 클라이언트

REST나 GraphQL 응답 샘플을 reqwest 같은 클라이언트를 위한 serde 구조체로 바꿉니다. 역직렬화 보일러플레이트를 손으로 쓸 필요가 없습니다.

설정과 픽스처 파싱

serde_json으로 역직렬화해야 하는 JSON 설정 파일, 테스트 픽스처, 웹훅 페이로드의 구조체를 생성합니다.

빠른 프로토타이핑

낯선 페이로드를 붙여넣으면 그 형태가 Rust 타입으로 즉시 표시됩니다 — 연결하기 전에 새로운 API를 빠르게 탐색하는 방법입니다.

변환이 작동하는 방식

구조적 추론

각 객체는 명명된 구조체가 되며, 동일한 형태는 중복 제거되어 복사본이 아닌 하나의 구조체를 얻습니다. 객체 배열은 키 단위로 병합되고, 일부 항목에 없는 키는 Option<T>가 됩니다.

올바른 숫자 타입 지정

정수는 i64로 매핑되고, i64::MAX를 넘으면 u64로 승격되며, u64를 넘으면 f64로 폴백합니다. 부동소수점은 토큰(1.0, 2e3)에서 감지되므로 serde 역직렬화가 부동소수점과 정수의 불일치로 실패하지 않습니다.

관용적이고 컴파일 가능한 식별자

키는 #[serde(rename)]으로 원래 키로 되돌리는 snake_case 필드가 됩니다. Rust 키워드, 중복 이름, 식별자가 아닌 키는 정제되므로 출력은 항상 컴파일됩니다.

100% 클라이언트 측

파싱과 생성이 네트워크 호출 없이 브라우저에서 실행되므로 데이터가 비공개로 유지됩니다.

깔끔한 Rust 구조체를 위한 팁

루트 구조체 이름 짓기

읽기 쉬운 코드를 위해 기본값 Root 대신 의미 있는 루트 이름(예: User, ApiResponse)을 설정하세요.

serde_json은 필요할 때만 추가

serde_json::Value는 비어 있거나 타입이 혼합된 배열과 null만 있는 필드에서 나타납니다. 가능하면 더 풍부한 샘플에서 그 필드에 구체적인 타입을 주거나, Cargo.toml에 serde_json을 추가하세요.

Option과 필수를 검토

필드는 샘플이 그것을 생략할 때만 Option<T>로 표시됩니다. 대표적인 페이로드를 붙여넣어 도구가 필수 필드와 선택적 필드를 정확히 추론하도록 하세요.

자주 묻는 질문