JSON'dan C#'ye

İlgili Öneriler

JSON'dan C#'ye giriş: JSON verilerini derlenebilir C# POCO sınıflarına dönüştürme

Kullanım senaryoları

• ASP.NET Core Web API: OpenAPI/Swagger belgelerindeki örnek JSON'u DTO sınıflarına dönüştürme, [FromBody] model bağlama ile birlikte frontend'den istek alma
• ASP.NET Core MVC: form/JSON istek gövdesini güçlü tür Model'e dönüştürme, ModelState otomatik doğrulama ile birlikte kullanma
• Newtonsoft.Json ters serileştirme: üçüncü taraf arabirim yanıt JSON'unu [JsonProperty] öznitelikli POCO sınıflarına dönüştürme, manuel alan eşleştirmesi gerekmez
• System.Text.Json yüksek performans senaryoları: JSON'u record türüne veya init-only özelliklere dönüştürme, JsonSerializer.Deserialize<T> ile birlikte başlangıç hızını artırma
• Unity oyun betikleri: ağ API'sinin döndürdüğü JSON'u (oyuncu verileri, seviye yapılandırması, mağaza öğeleri, sıralama) serileştirilebilir ScriptableObject veri modellerine dönüştürme
• .NET MAUI çapraz platform uygulamaları: arka uç API JSON'unu Model sınıflarına dönüştürme, XAML veri bağlamada kullanma, iOS/Android/Windows'ta iş modelini paylaşma
• Blazor Server / WebAssembly: API JSON'unu güçlü tür bileşen parametrelerine/sunucu modellerine dönüştürme, @inject HttpClient ile birlikte frontend/backend ortak tür tüketimi
• Entity Framework Core: veritabanından dışa aktarılan JSON belgelerini varlık sınıflarına dönüştürme, EF Core model geçişleri için referans temel sınıflar olarak kullanma, [Key]/[Required] vb. veri ek açıklamalarıyla birlikte kullanma
• Azure Functions / AWS Lambda: Event Grid/SNS/API Gateway/Cosmos DB tetikleyici olaylarının JSON'unu güçlü tür olay parametrelerine dönüştürme, sunucusuz işlev imzalarını basitleştirme
• SignalR gerçek zamanlı iletişim: sunucu tarafından gönderilen JSON mesajlarını (sohbet, bildirimler, fiyatlar, IoT verileri) C# türlerine dönüştürme, Hub yöntemlerinde güçlü tür olarak tüketme
• Mikro hizmet arabirim sözleşmeleri: hizmetler arası RPC (gRPC-Web/HTTP/WCF) JSON istek/yanıt örneklerini C# sınıflarına dönüştürme, birden çok ekip arasında paylaşılan sözleşme tanımları olarak kullanma
• Yapılandırma dosyası yükleme: appsettings.json alt yapısını Options şablon sınıflarına dönüştürme (örneğin MyOptions : IOptions<MyOptions> IConfiguration.Bind ile birlikte)
• Test verileri hazırlama: JSON test fikstürlerini C# sınıflarına dönüştürme, ardından Newtonsoft/System.Text.Json ile ters serileştirerek birim test sürücüsü olarak kullanma, xUnit/NUnit/MSTest ile birlikte kullanma
• Web kazıyıcı veri ayrıştırma: HtmlAgilityPack/AngleSharp/PuppeteerSharp ile toplanan JSON verilerini C# sınıflarına dönüştürme, JObject dinamik erişiminde alan eksikliğini önleme
• API belgesi yazma: Swagger/OpenAPI belgeleri, ReDoc, Knife4j, Swagger UI'da C# sınıfı örneklerini şema tanımlarına dahil ederek belgenin okunabilirliğini artırma
• Kod incelemesi işbirliği: API yanıt JSON'unu doğrudan okunabilir POCO'lara dönüştürme, Code Review sırasında alan adlandırma, tür seçimi, öznitelik kullanımını tartışmayı kolaylaştırma
• Eski proje yeniden yapılandırma: JObject/Dictionary<string, object> tabanlı dinamik erişimi POCO tabanlı güçlü tür erişimine yeniden yapılandırma, derleme zamanı tür denetimi ve bakım kolaylığını artırma
• Eğitim ve öğretim: C# kurslarında, .NET giriş eğitimlerinde örnek JSON'u POCO'ya dönüştürerek nesne yönelimli modelleme, özellik erişimcileri, serileştirme ilkelerini gösterme

Nasıl Kullanılır

1. JSON içeriğini soldaki düzenleyiciye yapıştırın, veya yükle düğmesine tıklayarak .json/.txt dosyası seçin, veya örnek düğmesine tıklayarak yerleşik verileri yükleyin
2. 400 ms bekledikten sonra otomatik olarak dönüştürülür, sağda oluşturulan C# POCO sınıf kodu görüntülenir
3. JSON biçim hataları varsa, «JSON'u düzelt» düğmesine tıklayarak yaygın sözdizimi sorunlarını otomatik olarak düzelttikten sonra yeniden dönüştürebilirsiniz
4. «Kopyala» düğmesine tıklayarak tek sınıfı panoya kopyalayıp Visual Studio/Rider/VS Code'a yapıştırın, veya «İndir» düğmesine tıklayarak .cs dosyası olarak kaydedin

Özellikler

• Saf tarayıcı yerel oluşturma: JSON ayrıştırma ve C# kod oluşturma tamamen JavaScript + quicktype-core aracılığıyla tarayıcı içinde tamamlanır, giriş verileri herhangi bir sunucuya yüklenmez
• POCO + record iki form: varsayılan olarak serileştirilebilir POCO sınıfları oluşturur, tek tıklamayla C# 9+ record türüne geçer, modern .NET kodlama stiline uygundur
• Newtonsoft [JsonProperty] öznitelikleri: her alan için otomatik olarak [JsonProperty("orijinal anahtar")] ekler, Newtonsoft.Json varsayılan davranışıyla uyumlu, PascalCase alan adları ters serileştirmeyi etkilemez
• İç içe geçmiş nesneleri otomatik ayır: JSON iç içe nesneleri özyinelemeli olarak bağımsız C# sınıfları oluşturur, alan adı ilk harfi büyük kuralına göre adlandırır (örneğin address → Address), tür çakışmalarını önler
• List generic otomatik genişletme: JSON dizileri otomatik olarak List<T>'ye dönüştürülür, T dizinin ilk öğesinden otomatik olarak çıkarılır (["a","b"] → List<string>, [{...}] → List<Item>)
• Nullable<T> otomatik çıkarım: JSON'daki null değer alanları otomatik olarak Nullable<T> olarak işaretlenir (örneğin long? / string? / bool?), derleme zamanında null başvuru istisnalarını önler
• PascalCase alan adlandırma: snake_case girdisi otomatik olarak PascalCase'e dönüştürülür (örneğin user_name → UserName), aynı zamanda [JsonProperty] özniteliği orijinal anahtarı koruyarak ters serileştirme uyumluluğunu sağlar
• Zengin değer türü eşleştirmesi: string→string, integer→long, float→double, bool→bool, array→List<T>, null→Nullable<T>
• Tam .cs şablonu: otomatik olarak using System.Collections.Generic; + namespace + public class + alanlar + özellikler içeren standart C# dosyası oluşturur, doğrudan derlenebilir
• Kopyalama ve indirme: tek tıklamayla tek sınıfı panoya kopyalama veya .cs dosyası olarak indirme, doğrudan Visual Studio / Rider / VS Code'a sürükleyip bırakarak kullanma
• JSON hatalarını tek tıklamayla düzeltme: sondaki virgüller, tek tırnaklar, eksik tırnaklar gibi yaygın biçimlendirme hatalarını otomatik olarak düzeltir, başarıyla düzelttikten sonra C# kodu oluşturmaya devam eder
• Yerel geçmiş: localStorage tabanlı olarak son girişleri otomatik olarak kaydeder, sayfayı yeniledikten veya yanlışlıkla kapattıktan sonra hızla geri yükleyerek düzenlemeye devam edebilirsiniz

Kod Örnekleri

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

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

    // Bu araç tarafından oluşturulan 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'yi çağırarak JSON dizesi alın
        var json = await _http.GetStringAsync($"https://api.example.com/users/{userId}");

        // 2) Bu araç tarafından oluşturulan POCO'ya ters serileştirin
        //    İç olarak [JsonProperty("id")] vb. özniteliklere göre snake_case JSON otomatik eşleşir
        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;

// Bu araç tarafından oluşturulan POCO (varsayılan olarak Newtonsoft [JsonProperty] kullanır):
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");
        }

        // İş mantığı: siparişi kaydet
        // var order = OrderService.Create(request);

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

/*
 * Karşılık gelen .csproj bağımlılıkları:
 * <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;

// Araç varsayılan olarak POCO class oluşturur; manuel olarak record türüne (değişmez veri aktarım nesnesi) aşağıdaki gibi değiştirilebilir:
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 + ters serileştirmeyi tek satırda tamamlar
        var user = await _http.GetFromJsonAsync<User>(
            $"https://api.example.com/users/{userId}");

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

/*
 * Karşılık gelen .csproj bağımlılıkları (System.Text.Json yerleşiktir, ek yükleme gerekmez):
 * <TargetFramework>net7.0</TargetFramework>
 *
 * Proje .NET 7+ ise ve [JsonProperty] Newtonsoft söz dizimiyle uyumluluk gerekiyorsa,
 * Program.cs'ye aşağıdakileri ekleyebilirsiniz:
 *   builder.Services.AddControllers()
 *       .AddNewtonsoftJson(options =>
 *       {
 *           options.SerializerSettings.ContractResolver =
 *               new Newtonsoft.Json.Serialization.DefaultContractResolver();
 *       });
 */

Best Practices

Sık Sorulan Sorular

Sorun Giderme

Sözlük

POCO (Plain Old CLR Object)

C#/.NET'te «sade CLR nesnesi» kısaltması, kısıtlamaları şunlardır: genel varsayılan yapıcı + private alanlar + genel { get; set; } özellikleri + çerçeve bağımlılığı yok. Bu aracın oluşturduğu standart bir POCO'dur.

record

C# 9+'da tanıtılan değişmez veri aktarım nesnesi türü, başvuru eşitliği yerine değer eşitliği kullanır. Bu araçta oluşturduktan sonra manuel olarak record olarak değiştirilebilir, DTO'lar, API yanıt modelleri, değişmez yapılandırma gibi senaryolar için uygundur.

[JsonProperty]

Newtonsoft.Json'un alan eşleştirme özniteliği. Bu araç varsayılan olarak her alan için [JsonProperty("orijinal anahtar")] ekler, PascalCase alan adlarının snake_case JSON'u doğru şekilde ters serileştirebilmesini sağlar.

Newtonsoft.Json

Json.NET olarak da bilinir, .NET ekosistemindeki en popüler JSON kitaplığıdır. En zengin ekosisteme ve en iyi uyumluluğa sahiptir, neredeyse tüm .NET projeleri tarafından desteklenir. ASP.NET Core 3.0'dan önce varsayılan olarak kullanılıyordu, 3.0'dan sonra System.Text.Json ile değiştirildi, ancak yine de NuGet paketi aracılığıyla uyumlu hale getirilebilir.

System.Text.Json

.NET Core 3.0+'da yerleşik olarak bulunan yüksek performanslı JSON kitaplığı. Hızlı başlar, düşük bellek kullanır, AOT dostudur, [JsonPropertyName] (Newtonsoft'un [JsonProperty]'ine karşılık gelir) ve özel JsonNamingPolicy adlandırma ilkesini içerir.

Nullable<T>

C#'da değer türünün null olabileceğini belirten tür (örneğin long? / bool?). Bu araç, JSON'daki null alanları otomatik olarak Nullable<T> olarak çıkarır, derleme zamanında null başvuru istisnalarını önler.

List<T>

.NET koleksiyon çerçevesindeki genel liste türü. Bu araç JSON dizilerini otomatik olarak List<T>'ye dönüştürür, T dizinin ilk öğesinden otomatik olarak çıkarılır (örneğin ["a"] → List<string>).

namespace

C#'da sınıfları düzenlemek için kullanılan ad alanı anahtar sözcüğü, Java'daki package'a benzer. Bu araç tarafından oluşturulan kod varsayılan olarak namespace içermez, manuel olarak eklenebilir (örneğin namespace MyApp.Models).

ASP.NET Core

Microsoft'un açık kaynaklı çapraz platform web çerçevesi. Bu araç tarafından oluşturulan POCO sınıfları doğrudan ASP.NET Core Controller [FromBody] model bağlama, Minimal API, Blazor bileşen parametreleri gibi senaryolarda kullanılabilir.

Unity

Dünyanın en popüler oyun motoru, betik dili C#'dir. Bu araç tarafından oluşturulan POCO sınıfları Unity ağ API yanıt ayrıştırma, ScriptableObject yapılandırma veri modellemesi için kullanılabilir.

Snake_case → PascalCase

Alan adlandırma kuralı dönüşümü. snake_case adlandırmasını (örneğin user_name, created_at) PascalCase adlandırmasına (örneğin UserName, CreatedAt) dönüştürme, .NET resmi adlandırma kurallarına uyma.

quicktype-core

Bu aracın temel olarak bağımlı olduğu açık kaynaklı çok dilli JSON tür üretim kitaplığıdır (quicktype projesi), C#, Java, TypeScript, Rust, Go, Swift vb. ondan fazla dili destekler, TypeScript + WebAssembly tabanlı olarak tarayıcıda çalışır.

.NET MAUI

Microsoft'un çapraz platform UI çerçevesi (.NET Multi-platform App UI), C# kodu iOS/Android/Windows/macOS'ta paylaşılabilir. Bu araç tarafından oluşturulan POCO'lar MAUI'da XAML veri bağlama için Model olarak uygundur.

Blazor

Microsoft'un WebAssembly tabanlı SPA çerçevesi, Server ve WebAssembly olmak üzere iki modu vardır. Bu araç tarafından oluşturulan C# sınıfları Blazor bileşen parametreleri, güçlü tür API yanıt modelleri için kullanılabilir, tek dille tam yığın geliştirme verimliliğini artırır.

HttpClient.GetFromJsonAsync

.NET 5+/System.Net.Http.Json genişletme yöntemi, HTTP GET + JSON ters serileştirmeyi tek satırda tamamlar. Bu araç tarafından oluşturulan POCO'larla birlikte kullanıldığında HTTP API istemci kodunu önemli ölçüde basitleştirebilir.

JsonNamingPolicy

System.Text.Json'da JSON alan adları ile C# özellik adları arasındaki eşleştirme kurallarını kontrol eden sınıf (örneğin CamelCase, SnakeCaseLower). Newtonsoft.Json, [JsonProperty] özniteliği veya ContractResolver aracılığıyla uygulanır.

IOptions<T>

.NET Options deseninin temel arabirimi, appsettings.json alt yapısını güçlü tür sınıflarına bağlar. Bu araç tarafından oluşturulan POCO'lar IConfiguration.Bind ile birlikte doğrudan IOptions<T> uygulaması olarak kullanılabilir.

JSON türlerinden C# türlerine eşleştirme hızlı başvuru tablosu

Araç, JSON değer türlerine göre karşılık gelen .NET/C# türlerini otomatik olarak çıkarır:

Newtonsoft.Json ve System.Text.Json öznitelik karşılaştırma tablosu

.NET ekosistemindeki iki temel JSON kitaplığının alan eşleştirme özniteliklerinin karşılaştırması. Bu araç varsayılan olarak Newtonsoft uyumlu [JsonProperty] oluşturur:

Privacy & Security

Bu JSON'dan C#'ye aracının tüm işlemleri tamamen tarayıcınızda yerel olarak tamamlanır: JSON ayrıştırma, C# kod oluşturma ve dosya indirme tamamen tarayıcının JavaScript + WebAssembly (quicktype-core) aracılığıyla istemci tarafında yürütülür, JSON içeriği, yüklenen dosyalar veya oluşturulan kod ağ üzerinden herhangi bir sunucuya gönderilmez. Dosya yükleme, tarayıcının yerel FileReader API'sini kullanarak doğrudan belleğe okur, herhangi bir aracı hizmetten geçmez. Çerez izleme kullanılmaz, kullanıcı giriş verileri veya kullanım davranış verileri toplanmaz. Sayfayı kapattıktan veya yeniledikten sonra tüm giriş ve çıkış içerikleri otomatik olarak bellekten silinir. API anahtarları, belirteçler, hassas iş verileri içeren JSON'ları işlemek için uygundur.

Authoritative References

• MicrosoftMicrosoft Learn - C# programlama kılavuzu
• MicrosoftMicrosoft Learn - System.Text.Json genel bakış
• NewtonsoftNewtonsoft.Json resmi belgeleri
• MicrosoftMicrosoft Learn - ASP.NET Core Web API model bağlama
• MicrosoftMicrosoft Learn - C# 9 record türü