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

JSON을 입력하면 중첩 객체까지 C# class 코드로 변환합니다! System.Text.Json [JsonPropertyName] 지원, .NET·ASP.NET Core 프로젝트에.
JSON
결과
 

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

JSON을 System.Text.Json용 C# 클래스로 변환합니다. 속성 이름은 PascalCase로 바꾸고, 모든 속성에 [JsonPropertyName]을 달아 원래 JSON 키와 정확히 연결합니다.

ASP.NET Core 컨트롤러의 요청·응답 모델, HttpClient.GetFromJsonAsync<T>()로 받는 외부 API 타입, Unity·MAUI 앱의 데이터 클래스를 만들 때 필드 목록을 손으로 옮기는 수고를 덜어 줍니다.

사용 방법

  1. JSON 응답이나 설정 파일 내용을 붙여넣습니다.
  2. 타입 이름에 루트 클래스 이름을 입력합니다(예: PaymentResult).
  3. 출력된 클래스를 프로젝트의 .cs 파일에 붙여넣고 namespace를 추가합니다.
  4. JsonSerializer.Deserialize<PaymentResult>(json) 또는 GetFromJsonAsync<PaymentResult>(url)로 사용합니다.

예시

입력 (JSON)
{
  "paymentId": "pay_8f2k",
  "amount": 15000,
  "currency": "KRW",
  "approved": true,
  "approvedAt": "2024-05-01T12:30:00Z",
  "card": { "issuer": "VISA", "last4": "4242" },
  "metadata": null
}
출력 (C# · System.Text.Json)
using System.Collections.Generic;
using System.Text.Json;
using System.Text.Json.Serialization;

public class PaymentResult
{
    [JsonPropertyName("paymentId")]
    public string PaymentId { get; set; } = string.Empty;

    [JsonPropertyName("amount")]
    public int Amount { get; set; }

    [JsonPropertyName("currency")]
    public string Currency { get; set; } = string.Empty;

    [JsonPropertyName("approved")]
    public bool Approved { get; set; }

    [JsonPropertyName("approvedAt")]
    public string ApprovedAt { get; set; } = string.Empty;

    [JsonPropertyName("card")]
    public Card Card { get; set; } = new();

    [JsonPropertyName("metadata")]
    public JsonElement? Metadata { get; set; }
}

public class Card
{
    [JsonPropertyName("issuer")]
    public string Issuer { get; set; } = string.Empty;

    [JsonPropertyName("last4")]
    public string Last4 { get; set; } = string.Empty;
}

모든 속성에 [JsonPropertyName]이 붙어 paymentId ↔ PaymentId가 대소문자까지 정확히 연결됩니다. 값이 null뿐인 metadata는 타입을 정할 수 없어 JsonElement?가 되었고, 문자열·객체 속성에는 string.Empty·new() 초기값이 들어가 null 경고 없이 컴파일됩니다.

지원 기능

  • 속성마다 [JsonPropertyName("원래키")]를 붙이고 using System.Text.Json.Serialization;을 넣습니다.
  • 타입: string, int, 32비트를 넘는 정수는 long, 소수는 double, bool, 배열은 List<T>.
  • 타입이 섞이거나 알 수 없는 값은 JsonElement로 두고 using System.Text.Json;을 추가합니다.
  • 일부 항목에만 있거나 null이 섞인 속성은 int?, string? 같은 nullable 타입이 됩니다.
  • 필수 속성에는 = string.Empty;, = new(); 초기값을 넣어 nullable 참조 형식 경고(CS8618)를 피합니다.
  • 속성 이름이 클래스 이름과 같아지면 C# 규칙상 쓸 수 없으므로 RootValue처럼 Value를 붙입니다.
  • 최상위가 배열이면 // Root: List<RootItem> 주석과 요소 클래스를 만듭니다.

사용 사례

HttpClient로 외부 API 호출

결제·배송 조회 API의 응답 예시를 변환해 await http.GetFromJsonAsync<PaymentResult>(url)의 타입으로 쓰면, 응답 필드를 JsonDocument로 하나씩 꺼내는 코드가 필요 없어집니다.

ASP.NET Core 웹훅 수신 모델

외부 서비스가 보내는 웹훅 페이로드 예시로 클래스를 만들어 [FromBody] 파라미터로 받으면 모델 바인딩과 유효성 검사를 그대로 쓸 수 있습니다.

appsettings·게임 데이터 파일

Unity나 콘솔 앱에서 읽는 JSON 데이터 파일의 구조를 클래스로 고정해 두면, 데이터 파일이 바뀌었을 때 역직렬화 단계에서 바로 드러납니다.

주의사항

  • Newtonsoft.Json([JsonProperty])용 코드는 만들지 않습니다. Json.NET을 쓴다면 어트리뷰트를 [JsonProperty("key")]로 바꿔야 합니다.
  • 날짜 문자열은 string입니다. ISO 8601 형식이라면 타입을 DateTime이나 DateTimeOffset으로 바꾸기만 해도 System.Text.Json이 파싱합니다.
  • new() 대상 형식 생성식과 string? 표기를 쓰므로 C# 9 이상, nullable 컨텍스트가 켜진 프로젝트(.NET 6 기본값)를 기준으로 합니다.
  • record나 required 키워드 출력은 없습니다. 불변 모델이 필요하면 { get; set; }을 { get; init; }으로 바꿔 쓰세요.
  • 모든 클래스가 하나의 코드 블록으로 나오므로 파일 분리와 namespace는 직접 정리해야 합니다.

자주 묻는 질문

키와 이름이 같은데도 [JsonPropertyName]이 왜 붙나요?

System.Text.Json은 기본적으로 대소문자를 구분합니다. JsonSerializerOptions를 따로 설정하지 않은 콘솔·워커 프로젝트에서는 paymentId가 PaymentId에 들어가지 않기 때문에, 설정과 관계없이 동작하도록 항상 명시합니다.

JsonElement? 속성은 어떻게 읽나요?

ValueKind로 실제 종류를 확인한 뒤 GetString(), GetInt32(), Deserialize<T>() 등으로 꺼냅니다. 실제 값의 타입을 알게 되면 그 타입으로 바꾸는 편이 좋습니다.

속성 이름을 camelCase 그대로 두고 싶어요.

C# 관례상 PascalCase로 만듭니다. 원래 키는 [JsonPropertyName]에 남아 있으므로 속성 이름을 바꾸더라도 어트리뷰트만 유지하면 직렬화 결과는 같습니다.

Unity의 JsonUtility에서도 쓸 수 있나요?

JsonUtility는 프로퍼티가 아니라 [Serializable] 클래스의 public 필드만 다루고 [JsonPropertyName]도 읽지 않습니다. Unity에서는 Newtonsoft.Json 패키지나 System.Text.Json과 함께 쓰는 것을 권합니다.