JSON을 System.Text.Json용 C# 클래스로 변환합니다. 속성 이름은 PascalCase로 바꾸고, 모든 속성에 [JsonPropertyName]을 달아 원래 JSON 키와 정확히 연결합니다.
ASP.NET Core 컨트롤러의 요청·응답 모델, HttpClient.GetFromJsonAsync<T>()로 받는 외부 API 타입, Unity·MAUI 앱의 데이터 클래스를 만들 때 필드 목록을 손으로 옮기는 수고를 덜어 줍니다.
타입 이름에 루트 클래스 이름을 입력합니다(예: PaymentResult)..cs 파일에 붙여넣고 namespace를 추가합니다.JsonSerializer.Deserialize<PaymentResult>(json) 또는 GetFromJsonAsync<PaymentResult>(url)로 사용합니다.{
"paymentId": "pay_8f2k",
"amount": 15000,
"currency": "KRW",
"approved": true,
"approvedAt": "2024-05-01T12:30:00Z",
"card": { "issuer": "VISA", "last4": "4242" },
"metadata": null
}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)를 피합니다.RootValue처럼 Value를 붙입니다.// Root: List<RootItem> 주석과 요소 클래스를 만듭니다.결제·배송 조회 API의 응답 예시를 변환해 await http.GetFromJsonAsync<PaymentResult>(url)의 타입으로 쓰면, 응답 필드를 JsonDocument로 하나씩 꺼내는 코드가 필요 없어집니다.
외부 서비스가 보내는 웹훅 페이로드 예시로 클래스를 만들어 [FromBody] 파라미터로 받으면 모델 바인딩과 유효성 검사를 그대로 쓸 수 있습니다.
Unity나 콘솔 앱에서 읽는 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; }으로 바꿔 쓰세요.[JsonPropertyName]이 왜 붙나요?System.Text.Json은 기본적으로 대소문자를 구분합니다. JsonSerializerOptions를 따로 설정하지 않은 콘솔·워커 프로젝트에서는 paymentId가 PaymentId에 들어가지 않기 때문에, 설정과 관계없이 동작하도록 항상 명시합니다.
JsonElement? 속성은 어떻게 읽나요?ValueKind로 실제 종류를 확인한 뒤 GetString(), GetInt32(), Deserialize<T>() 등으로 꺼냅니다. 실제 값의 타입을 알게 되면 그 타입으로 바꾸는 편이 좋습니다.
C# 관례상 PascalCase로 만듭니다. 원래 키는 [JsonPropertyName]에 남아 있으므로 속성 이름을 바꾸더라도 어트리뷰트만 유지하면 직렬화 결과는 같습니다.
JsonUtility는 프로퍼티가 아니라 [Serializable] 클래스의 public 필드만 다루고 [JsonPropertyName]도 읽지 않습니다. Unity에서는 Newtonsoft.Json 패키지나 System.Text.Json과 함께 쓰는 것을 권합니다.