JSON을 C# 클래스로

출력 예시

다음 입력에 대해:

{ "firstName": "Alice", "age": 30, "emails": ["a@a.com"], "address": { "city": "Madrid" } }

System.Text.Json 출력(C# 10 이상):

public class User
{
    [JsonPropertyName("firstName")]
    public string FirstName { get; set; } = default!;

    [JsonPropertyName("age")]
    public int Age { get; set; }

    [JsonPropertyName("emails")]
    public List<string> Emails { get; set; } = new();

    [JsonPropertyName("address")]
    public Address Address { get; set; } = default!;
}

public class Address
{
    [JsonPropertyName("city")]
    public string City { get; set; } = default!;
}

형식 매핑

특성 옵션

• System.Text.Json([JsonPropertyName("foo")]). NET 6 이상 및 신규 프로젝트에 권장됩니다.
• Newtonsoft.Json([JsonProperty("foo")]), 레거시 프로젝트나 Newtonsoft 고유 기능이 필요할 때 사용합니다.
• 없음, 속성 이름이 JSON 키와 정확히 일치합니다(JSON 키가 이미 PascalCase인 경우에만 동작합니다).

흔한 실수

• 오버플로 가능성이 있는 필드에 int 사용. JSON에 int.MaxValue를 초과하는 값이 있으면 long을 사용하세요. 생성기는 큰 값을 감지하면 자동으로 승격합니다.
• 계산 속성에 [JsonIgnore] 누락. 생성된 클래스에 헬퍼 속성을 추가한다면 [JsonIgnore]로 표시하세요. 그렇지 않으면 출력 시 직렬화됩니다.
• 문화권 독립적 파싱 잊기. decimal 필드는 CultureInfo.InvariantCulture로 역직렬화해야 합니다. System.Text.Json은 기본적으로 이를 수행하며, Newtonsoft는 전역 설정으로 수행합니다.
• 샘플 하나만으로 생성기를 신뢰하기. 널 허용 여부와 배열 요소 형식은 입력된 데이터로부터 추론됩니다. 널 허용 주석은 항상 실제 API 동작과 대조하여 확인하세요.