JSON에서 C#로

관련 추천

JSON에서 C#로 정보: JSON 데이터를 컴파일 가능한 C# POCO 클래스로 변환

사용 사례

• ASP.NET Core Web API: OpenAPI/Swagger 문서의 샘플 JSON을 DTO 클래스로 변환, [FromBody] 모델 바인딩과 함께 프론트엔드 요청 수신
• ASP.NET Core MVC: 폼/JSON 요청 본문을 강한 타입 Model로 변환, ModelState 자동 검증과 함께 사용
• Newtonsoft.Json 역직렬화: 타사 인터페이스 응답 JSON을 [JsonProperty]가 있는 POCO 클래스로 변환, 수동 필드 매핑 불필요
• System.Text.Json 고성능 시나리오: JSON을 record 타입 또는 init 전용 속성으로 변환, JsonSerializer.Deserialize<T>와 함께 시작 속도 향상
• Unity 게임 스크립트: 네트워크 API에서 반환되는 JSON(플레이어 데이터, 레벨 구성, 상점 아이템, 랭킹)을 직렬화 가능한 ScriptableObject 데이터 모델로 변환
• .NET MAUI 크로스플랫폼 앱: 백엔드 API JSON을 Model 클래스로 변환, XAML 데이터 바인딩에서 사용, iOS/Android/Windows에서 비즈니스 모델 공유
• Blazor Server / WebAssembly: API JSON을 강한 타입 컴포넌트 매개변수/서버 모델로 변환, @inject HttpClient와 함께 프론트엔드/백엔드 공유 타입 소비
• Entity Framework Core: 데이터베이스에서 내보낸 JSON 문서를 엔티티 클래스로 변환, EF Core 모델 마이그레이션의 참조 기본 클래스로 사용, [Key]/[Required] 등 데이터 어노테이션과 함께 사용
• Azure Functions / AWS Lambda: Event Grid/SNS/API Gateway/Cosmos DB 트리거 이벤트의 JSON을 강한 타입 이벤트 매개변수로 변환, 서버리스 함수 시그니처 간소화
• SignalR 실시간 통신: 서버에서 푸시되는 JSON 메시지(채팅, 알림, 시세, IoT 데이터)를 C# 타입으로 변환, Hub 메서드에서 강한 타입으로 소비
• 마이크로서비스 인터페이스 계약: 서비스 간 RPC(gRPC-Web/HTTP/WCF)의 JSON 요청/응답 샘플을 C# 클래스로 변환, 다중 팀 공유 계약 정의로 사용
• 구성 파일 로드: appsettings.json 하위 구조를 Options 패턴 클래스로 변환(예: MyOptions : IOptions<MyOptions>를 IConfiguration.Bind와 함께 사용)
• 테스트 데이터 준비: JSON 픽스처를 C# 클래스로 변환한 후 Newtonsoft/System.Text.Json으로 역직렬화하여 유닛 테스트 주도, xUnit/NUnit/MSTest와 함께 사용
• 크롤러 데이터 파싱: HtmlAgilityPack/AngleSharp/PuppeteerSharp로 수집한 JSON 데이터를 C# 클래스로 변환, JObject 동적 접근으로 인한 필드 누락 방지
• API 문서 작성: Swagger/OpenAPI 문서, ReDoc, Knife4j, Swagger UI에 C# 클래스 샘플을 schema 정의로 포함하여 문서 가독성 향상
• 코드 리뷰 협업: API 응답 JSON을 직접 읽기 쉬운 POCO로 변환, Code Review 시 필드 명명, 타입 선택, 어노테이션 사용에 대해 논의하기 쉽게
• 기존 프로젝트 리팩토링: JObject/Dictionary<string, object> 기반 동적 접근을 POCO 기반 강한 타입 접근으로 리팩토링하여 컴파일 타임 타입 검사와 유지보수성 향상
• 교육 및 훈련: C# 과정, .NET 입문 교육에서 샘플 JSON을 POCO로 변환하여 객체 지향 모델링, 속성 접근자, 직렬화 원리 시연

이용 방법

1. 왼쪽 에디터에 JSON 내용을 붙여넣거나 업로드 버튼을 클릭하여 .json/.txt 파일을 선택하거나 샘플 버튼을 클릭하여 내장 데이터를 로드합니다
2. 400ms 기다리면 자동으로 변환되어 오른쪽에 생성된 C# POCO 클래스 코드가 표시됩니다
3. JSON 형식 오류가 있는 경우 「JSON 복구」 버튼을 클릭하여 일반적인 구문 문제를 자동 복구한 후 다시 변환합니다
4. 「복사」 버튼을 클릭하여 단일 클래스를 클립보드에 복사하여 Visual Studio/Rider/VS Code에 붙여넣거나 「다운로드」를 클릭하여 .cs 파일로 저장합니다

주요 기능

• 순수 브라우저 로컬 생성: JSON 파싱과 C# 코드 생성은 모두 JavaScript + quicktype-core로 브라우저 내에서 완료되며, 입력 데이터는 어떤 서버에도 업로드되지 않습니다
• POCO + record 두 가지 형태: 기본적으로 직렬화 가능한 POCO 클래스를 생성하며, 원클릭으로 C# 9+ record 타입으로 전환 가능하여 현대 .NET 코딩 스타일에 맞춥니다
• Newtonsoft [JsonProperty] 어노테이션: 각 필드에 자동으로 [JsonProperty("원본 key")]를 생성하여 Newtonsoft.Json 기본 동작과 호환되며, PascalCase 필드명이 역직렬화에 영향을 주지 않습니다
• 중첩 객체 자동 분할: JSON 중첩 객체는 재귀적으로 독립된 C# 클래스로 생성되며, 필드명 첫 글자 대문자로 명명 (예: address → Address)하여 타입 중복을 피합니다
• List 제네릭 자동 전개: JSON 배열은 자동으로 List<T>로 변환되며, T는 배열 첫 번째 항목에서 자동 추론 (["a","b"] → List<string>, [{...}] → List<Item>)
• Nullable<T> 자동 추론: JSON null 값 필드는 자동으로 Nullable<T>로 표시 (예: long? / string? / bool?)되어 컴파일 타임에 널 참조 예외를 방지합니다
• PascalCase 필드 명명: snake_case 입력은 자동으로 PascalCase로 변환 (예: user_name → UserName)되며, 동시에 [JsonProperty] 어노테이션은 원본 key를 유지하여 역직렬화 호환성을 유지합니다
• 다양한 값 타입 매핑: string → string, integer → long, float → double, bool → bool, array → List<T>, null → Nullable<T>
• 완전한 .cs 템플릿: using System.Collections.Generic; + namespace + public class + 필드 + 속성을 포함한 표준 C# 파일을 생성하여 직접 컴파일 가능
• 복사 및 다운로드: 원클릭으로 단일 클래스를 클립보드에 복사하거나 .cs 파일로 다운로드하여 Visual Studio / Rider / VS Code에 직접 드래그 앤 드롭
• JSON 오류 원클릭 복구: 뒤에 붙은 쉼표, 작은따옴표, 따옴표 누락 등 일반적인 형식 오류를 자동으로 복구하며, 복구 성공 후 C# 코드 생성을 계속합니다
• 로컬 기록: localStorage 기반으로 최근 입력을 자동 저장하여 페이지를 새로고침하거나 실수로 닫은 후에도 빠르게 복원하여 편집을 계속할 수 있습니다

코드 예제

using Newtonsoft.Json;
using System;
using System.Net.Http;
using System.Threading.Tasks;

public class ApiClient
{
    private static readonly HttpClient _http = new HttpClient();

    // 본 도구가 생성한 POCO:
    public class User
    {
        [JsonProperty("id")]
        public long Id { get; set; }

        [JsonProperty("name")]
        public string Name { get; set; }

        [JsonProperty("email")]
        public string Email { get; set; }

        [JsonProperty("is_active")]
        public bool? IsActive { get; set; }
    }

    public static async Task<User> GetUserAsync(int userId)
    {
        // 1) API를 호출하여 JSON 문자열 가져오기
        var json = await _http.GetStringAsync($"https://api.example.com/users/{userId}");

        // 2) 본 도구가 생성한 POCO로 역직렬화
        //    내부에서 [JsonProperty("id")] 등 어노테이션에 따라 snake_case JSON 자동 매핑
        var user = JsonConvert.DeserializeObject<User>(json);

        Console.WriteLine($"User: {user.Name} ({user.Email})");
        return user;
    }
}

using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;
using System.Linq;

// 본 도구가 생성한 POCO(기본적으로 Newtonsoft [JsonProperty] 사용):
public class CreateOrderRequest
{
    [Newtonsoft.Json.JsonProperty("user_id")]
    public long UserId { get; set; }

    [Newtonsoft.Json.JsonProperty("items")]
    public List<OrderItem> Items { get; set; }
}

public class OrderItem
{
    [Newtonsoft.Json.JsonProperty("product_id")]
    public long ProductId { get; set; }

    [Newtonsoft.Json.JsonProperty("quantity")]
    public long Quantity { get; set; }
}

[ApiController]
[Route("api/[controller]")]
public class OrdersController : ControllerBase
{
    [HttpPost]
    public IActionResult Create([FromBody] CreateOrderRequest request)
    {
        if (request == null || request.Items == null || !request.Items.Any())
        {
            return BadRequest("Items cannot be empty");
        }

        // 비즈니스 로직: 주문 저장
        // var order = OrderService.Create(request);

        return Ok(new { order_id = 12345, status = "created" });
    }
}

/*
 * 해당 .csproj 종속성:
 * <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="7.0.0" />
 * <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
 */

using System.Net.Http.Json;
using System.Text.Json.Serialization;
using System.Threading.Tasks;

// 본 도구는 기본적으로 POCO class를 생성; 다음과 같이 수동으로 record 타입(불변 데이터 전달 객체)으로 변경:
public record User
{
    [JsonPropertyName("id")]
    public long Id { get; init; }

    [JsonPropertyName("name")]
    public string Name { get; init; }

    [JsonPropertyName("email")]
    public string Email { get; init; }

    [JsonPropertyName("is_active")]
    public bool? IsActive { get; init; }
}

public class ApiClient
{
    private static readonly HttpClient _http = new HttpClient();

    public static async Task<User> GetUserAsync(int userId)
    {
        // System.Text.Json: GetFromJsonAsync가 HTTP + 역직렬화를 한 줄로 완료
        var user = await _http.GetFromJsonAsync<User>(
            $"https://api.example.com/users/{userId}");

        System.Console.WriteLine($"User: {user.Name} ({user.Email})");
        return user;
    }
}

/*
 * 해당 .csproj 종속성(System.Text.Json은 내장되어 있어 추가 설치 불필요):
 * <TargetFramework>net7.0</TargetFramework>
 *
 * 프로젝트가 .NET 7+이고 [JsonProperty] Newtonsoft 구문과 호환시키고 싶은 경우
 * Program.cs에 다음을 추가할 수 있습니다:
 *   builder.Services.AddControllers()
 *       .AddNewtonsoftJson(options =>
 *       {
 *           options.SerializerSettings.ContractResolver =
 *               new Newtonsoft.Json.Serialization.DefaultContractResolver();
 *       });
 */

Best Practices

자주 묻는 질문

문제 해결

용어집

POCO (Plain Old CLR Object)

C#/.NET에서 「평범한 CLR 객체」의 약칭으로, 제약 조건은: 퍼블릭 기본 생성자 + private 필드 + 퍼블릭 { get; set; } 속성 + 프레임워크 비의존성. 본 도구가 생성하는 것은 표준 POCO입니다.

record

C# 9+에서 도입된 불변 데이터 전달 객체 타입으로, 참조 동등성이 아닌 값 동등성을 사용합니다. 본 도구에서 생성 후 수동으로 record로 변경할 수 있으며 DTO, API 응답 모델, 불변 구성 등의 시나리오에 적합합니다.

[JsonProperty]

Newtonsoft.Json의 필드 매핑 특성. 본 도구는 기본적으로 각 필드에 [JsonProperty("원본 key")]를 추가하여 PascalCase 필드명이 snake_case JSON을 올바르게 역직렬화할 수 있도록 합니다.

Newtonsoft.Json

Json.NET이라고도 하며 .NET 생태계에서 가장 인기 있는 JSON 라이브러리. 생태계가 가장 풍부하고 호환성이 가장 좋아 거의 모든 .NET 프로젝트에서 지원됩니다. ASP.NET Core 3.0 이전에는 기본으로 사용되었으며, 3.0 이후 System.Text.Json으로 변경되었지만 NuGet 패키지를 통해 계속 호환됩니다.

System.Text.Json

.NET Core 3.0+에 내장된 고성능 JSON 라이브러리. 시작이 빠르고 메모리 사용량이 적으며 AOT 친화적입니다. 기능에는 [JsonPropertyName](Newtonsoft의 [JsonProperty]에 해당)과 JsonNamingPolicy 커스텀 명명 정책이 포함됩니다.

Nullable<T>

C#에서 값 타입이 널 가능함을 나타내는 형식(예: long? / bool?). 본 도구는 JSON null 필드를 자동으로 Nullable<T>로 추론하여 컴파일 타임에 널 참조 예외를 방지합니다.

List<T>

.NET 컬렉션 프레임워크의 제네릭 리스트 타입. 본 도구는 JSON 배열을 자동으로 List<T>로 변환하며 T는 배열 첫 번째 항목에서 자동 추론됩니다(예: ["a"] → List<string>).

namespace

C#에서 클래스를 구성하기 위한 네임스페이스 키워드로, Java의 package와 유사합니다. 본 도구가 생성하는 코드는 기본적으로 namespace가 없으며 수동으로 추가할 수 있습니다(예: namespace MyApp.Models).

ASP.NET Core

마이크로소프트 오픈소스 크로스플랫폼 웹 프레임워크. 본 도구에서 생성되는 POCO 클래스는 ASP.NET Core Controller [FromBody] 모델 바인딩, Minimal API, Blazor 컴포넌트 매개변수 등의 시나리오에서 직접 사용할 수 있습니다.

Unity

세계에서 가장 인기 있는 게임 엔진으로 스크립트 언어로 C#을 사용합니다. 본 도구에서 생성되는 POCO 클래스는 Unity 네트워크 API 응답 파싱, ScriptableObject 구성 데이터 모델링에 사용할 수 있습니다.

Snake_case → PascalCase

필드 명명 규칙 변환. snake_case 명명(예: user_name, created_at)을 PascalCase 명명(예: UserName, CreatedAt)으로 변환하여 .NET 공식 명명 규칙을 준수합니다.

quicktype-core

본 도구가 기반으로 의존하는 오픈소스 다국어 JSON 타입 생성 라이브러리(quicktype 프로젝트). C#, Java, TypeScript, Rust, Go, Swift 등 10개 이상의 언어를 지원하며 TypeScript + WebAssembly 기반으로 브라우저에서 실행됩니다.

.NET MAUI

마이크로소프트 크로스플랫폼 UI 프레임워크(.NET Multi-platform App UI). C# 코드는 iOS/Android/Windows/macOS에서 공유할 수 있습니다. 본 도구에서 생성되는 POCO는 MAUI XAML 데이터 바인딩의 Model로 적합합니다.

Blazor

마이크로소프트 WebAssembly 기반 SPA 프레임워크로 Server와 WebAssembly 두 가지 모드가 있습니다. 본 도구에서 생성되는 C# 클래스는 Blazor 컴포넌트 매개변수, 강한 타입 API 응답 모델에 사용할 수 있어 단일 언어 풀스택 개발 효율을 높입니다.

HttpClient.GetFromJsonAsync

.NET 5+/System.Net.Http.Json 확장 메서드. HTTP GET + JSON 역직렬화를 한 줄로 완료합니다. 본 도구에서 생성되는 POCO와 함께 사용하면 HTTP API 클라이언트 코드를 크게 간소화할 수 있습니다.

JsonNamingPolicy

System.Text.Json에서 JSON 필드명과 C# 속성명 간의 매핑 정책을 제어하는 클래스(예: CamelCase, SnakeCaseLower). Newtonsoft.Json은 [JsonProperty] 어노테이션 또는 ContractResolver로 구현합니다.

IOptions<T>

.NET Options 패턴 핵심 인터페이스. appsettings.json 하위 구조를 강한 타입 클래스에 바인딩합니다. 본 도구에서 생성되는 POCO는 IConfiguration.Bind와 함께 IOptions<T> 구현으로 직접 사용할 수 있습니다.

JSON 타입에서 C# 타입으로 매핑 속참표

도구는 JSON 값의 타입에 따라 대응하는 C#/.NET 타입을 자동으로 추론합니다:

Newtonsoft.Json과 System.Text.Json 어노테이션 비교표

.NET 생태계 두 주류 JSON 라이브러리의 필드 매핑 특성 비교. 본 도구는 기본적으로 Newtonsoft 호환 [JsonProperty]를 생성합니다:

Privacy & Security

본 JSON에서 C#로 도구의 모든 작업은 완전히 귀하의 브라우저 로컬에서 완료됩니다: JSON 파싱, C# 코드 생성, 파일 다운로드는 모두 브라우저 JavaScript + WebAssembly(quicktype-core)를 통해 클라이언트 측에서 실행되며 네트워크를 통해 어떤 서버에도 JSON 내용, 업로드된 파일 또는 생성된 코드를 전송하지 않습니다. 파일 업로드는 브라우저 네이티브 FileReader API를 사용하여 직접 메모리로 읽어들이며 어떤 중간 서비스도 거치지 않습니다. 쿠키 추적을 사용하지 않으며 사용자 입력 데이터나 사용 현황 데이터를 수집하지 않습니다. 페이지를 닫거나 새로고침하면 모든 입력 및 출력 내용이 자동으로 메모리에서 삭제됩니다. API 키, 토큰, 민감한 비즈니스 데이터가 포함된 JSON 처리에 적합합니다.

Authoritative References

• MicrosoftMicrosoft Learn - C# 프로그래밍 가이드
• MicrosoftMicrosoft Learn - System.Text.Json 개요
• NewtonsoftNewtonsoft.Json 공식 문서
• MicrosoftMicrosoft Learn - ASP.NET Core Web API 모델 바인딩
• MicrosoftMicrosoft Learn - C# 9 record 타입