JSON을 Rust struct 코드로 변환하세요!

JSON을 입력하면 중첩 객체까지 Rust serde struct 코드(Serialize, Deserialize, #[serde(rename)])로 변환합니다!
JSON
결과
 

JSON을 Rust struct 코드로 변환하세요!

JSON 예시를 serde로 (역)직렬화할 수 있는 Rust struct로 바꿉니다. 모든 struct에 #[derive(Debug, Clone, Serialize, Deserialize)]가 붙고, 필드 이름은 Rust 관례인 snake_case로 맞춘 뒤 원래 키가 다르면 #[serde(rename)]으로 연결합니다.

reqwest로 받은 API 응답을 타입으로 받고 싶을 때, axum·actix-web 핸들러의 Json<T> 추출기에 넣을 요청 타입이 필요할 때, 로그·이벤트 JSON을 파싱하는 CLI 도구를 만들 때 출발점으로 쓸 수 있습니다.

사용 방법

  1. 변환할 JSON을 붙여넣습니다. 여러 항목이 있는 배열을 넣으면 선택 필드를 더 정확히 찾습니다.
  2. 타입 이름에 최상위 struct 이름을 적습니다(예: AccessLog).
  3. 결과를 .rs 파일에 붙여넣고, Cargo.toml에 serde(derive 기능)와 serde_json을 추가합니다.
  4. serde_json::from_str::<AccessLog>(&body)? 또는 resp.json::<AccessLog>().await?로 사용합니다.

예시

입력 (JSON)
{
  "timestamp": 1714550400,
  "level": "warn",
  "type": "http_request",
  "status": 503,
  "latency_ms": 1250.7,
  "headers": [{ "name": "user-agent", "value": "curl/8.4" }],
  "trace_id": null
}
출력 (Rust · serde)
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AccessLog {
    pub timestamp: i64,
    pub level: String,
    #[serde(rename = "type")]
    pub type_: String,
    pub status: i64,
    pub latency_ms: f64,
    pub headers: Vec<Header>,
    pub trace_id: serde_json::Value,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Header {
    pub name: String,
    pub value: String,
}

type은 Rust 키워드라 type_ 필드에 #[serde(rename = "type")]가 붙었습니다. 정수는 범위와 관계없이 i64, latency_ms는 f64입니다. 값이 null뿐인 trace_id는 타입을 알 수 없어 serde_json::Value로 남았으니 실제 타입(예: Option<String>)으로 바꿔 주세요.

지원 기능

  • struct마다 #[derive(Debug, Clone, Serialize, Deserialize)]와 pub 필드.
  • 키가 snake_case 필드 이름과 다르면 필드별 #[serde(rename = "원래키")].
  • 일부 항목에만 있는 필드: Option<T>와 #[serde(default, skip_serializing_if = "Option::is_none")].
  • 모든 항목에 있지만 null이 섞인 필드: 어트리뷰트 없이 Option<T>.
  • 타입: 정수 i64, 소수 f64, bool, String, 배열 Vec<T>, 타입이 섞인 값은 serde_json::Value.
  • type, match, ref 같은 키워드 키는 type_처럼 _를 붙입니다.
  • 최상위가 배열이면 pub type Root = Vec<RootItem>; 별칭을 만듭니다.

사용 사례

reqwest 응답을 타입으로 받기

serde_json::Value에서 ["status"].as_i64()로 꺼내던 코드를 resp.json::<AccessLog>()로 바꾸면 필드 오타가 컴파일 단계에서 걸립니다.

axum·actix-web 요청 바디

클라이언트가 보내는 JSON 예시로 struct를 만들어 Json(payload): Json<CreateOrder>로 받으면, 필드가 빠졌거나 타입이 틀린 요청은 핸들러 코드가 실행되기 전에 프레임워크가 오류 응답으로 돌려보냅니다.

JSON Lines 로그 분석 CLI

로그 한 줄을 넣어 만든 struct로 BufReader::lines()를 돌며 역직렬화하면, 필드별 집계 도구를 몇 줄로 만들 수 있습니다.

주의사항

  • 정수는 값이 작아도 항상 i64입니다. u16 상태 코드나 u32 카운트처럼 범위가 정해져 있다면 직접 좁혀 주세요.
  • 타임스탬프·날짜 문자열은 i64·String 그대로입니다. chrono나 time 크레이트 타입으로 바꾸려면 해당 크레이트의 serde 기능을 켜야 합니다.
  • serde_json::Value를 쓰는 출력은 use serde_json 없이 전체 경로로 적혀 있어 import는 필요 없지만 serde_json 의존성은 있어야 합니다.
  • #[serde(rename_all = "camelCase")] 같은 struct 단위 어트리뷰트 대신 필드별 rename을 씁니다. 키 표기가 일정하다면 직접 묶어도 됩니다.
  • enum(태그 있는 유니온)은 만들지 않습니다. "level": "warn"처럼 값이 정해진 필드는 생성 후 enum으로 바꾸는 것을 고려하세요.

자주 묻는 질문

선택 필드에 #[serde(default)]가 왜 함께 붙나요?

serde는 Option 필드가 없을 때 None으로 채우지만, default를 명시해 두면 나중에 타입을 Vec<T> 등 비 Option으로 바꿔도 키가 빠진 입력을 받아들입니다. skip_serializing_if는 다시 JSON으로 쓸 때 None 필드를 생략해 원본 모양을 유지합니다.

null이 섞인 필드와 아예 없는 필드는 어떻게 다르게 나오나요?

둘 다 Option<T>지만, 키가 빠지는 필드만 default·skip_serializing_if 어트리뷰트를 받습니다. 항상 키가 있고 값만 null인 필드는 직렬화할 때도 null로 다시 써집니다.

왜 Deserialize<'de> 수명이나 &str 필드를 쓰지 않나요?

제로 카피 역직렬화(&'a str)는 입력 버퍼보다 오래 살 수 없어서 일반적인 응답 처리에는 불편합니다. 기본은 소유 타입 String이고, 성능이 중요하면 필요한 필드만 Cow<'a, str> 등으로 바꾸면 됩니다.

Default나 PartialEq derive도 추가할 수 있나요?

출력에는 Debug, Clone, Serialize, Deserialize만 들어갑니다. 필드 타입이 모두 지원한다면 derive 목록에 직접 추가하면 됩니다(serde_json::Value는 PartialEq를 지원).