JSON to C# Class

Apa itu Konversi JSON ke C#?

Konversi JSON ke C# adalah proses menghasilkan definisi kelas C# yang bertipe kuat dari data JSON. Ketika aplikasi .NET menerima JSON dari API, file konfigurasi, atau message queue, aplikasi tersebut memerlukan kelas C# untuk melakukan deserialisasi data tersebut menjadi objek. Menulis kelas-kelas ini secara manual memakan waktu dan rentan terhadap kesalahan, terutama ketika JSON mengandung objek bersarang, array, dan tipe yang beragam.

Generator kelas JSON ke C# memeriksa struktur dan nilai dalam JSON Anda, menyimpulkan tipe C# yang tepat untuk setiap field, dan menghasilkan definisi kelas dengan property accessor dan atribut serialisasi. Output mengikuti konvensi penamaan .NET: nama properti PascalCase, atribut JsonPropertyName untuk pemetaan ke kunci JSON camelCase atau snake_case asli, serta penggunaan List'<'T'>' yang benar untuk array.

Konversi ini sangat umum digunakan di ASP.NET Core web API, Azure Functions, dan layanan .NET mana pun yang mengonsumsi data JSON eksternal. Daripada menggunakan dynamic atau Dictionary'<'string, object'>', kelas yang bertipe memberikan keamanan waktu kompilasi, dukungan IntelliSense, dan perlindungan terhadap kesalahan ketik nama field yang baru akan terdeteksi saat runtime. Tempel JSON Anda ke alat ini dan dapatkan kelas C# yang siap pakai seketika.

Mengapa Menggunakan Generator JSON ke C#?

Menulis kelas model C# secara manual dari sampel JSON memakan waktu dan membuka peluang kesalahan manusia. Generator menangani bagian yang berulang sehingga Anda bisa fokus pada logika bisnis.

Kasus Penggunaan JSON ke C#

Referensi Pemetaan Tipe JSON ke C#

Setiap tipe nilai JSON dipetakan ke tipe C# tertentu. Generator menganalisis nilai aktual untuk memilih tipe yang paling tepat. Misalnya, angka JSON tanpa titik desimal menjadi int, sedangkan 3.14 menjadi double. Nilai null menghasilkan object? (tipe referensi nullable) karena tipe sebenarnya tidak dapat disimpulkan dari null saja.

System.Text.Json vs Newtonsoft.Json

.NET memiliki dua library serialisasi JSON utama. Kelas yang dihasilkan oleh alat ini menggunakan atribut System.Text.Json (JsonPropertyName), yang merupakan opsi bawaan sejak .NET Core 3.0. Jika proyek Anda menggunakan Newtonsoft.Json, Anda dapat mengganti atributnya.

Contoh Kode

Contoh-contoh ini menunjukkan cara mendefinisikan dan menggunakan kelas C# yang dihasilkan dari JSON, menggunakan kedua library serialisasi utama, beserta cara mengotomatiskan pembuatan dari command line.

using System.Text.Json;

var json = """{"id": 1, "name": "Alice", "active": true}""";
var user = JsonSerializer.Deserialize<User>(json);
Console.WriteLine(user.Name); // → "Alice"

public class User
{
    [JsonPropertyName("id")]
    public int Id { get; set; }

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

    [JsonPropertyName("active")]
    public bool Active { get; set; }
}

using Newtonsoft.Json;

var json = @"{""id"": 1, ""name"": ""Alice"", ""scores"": [98, 85]}";
var user = JsonConvert.DeserializeObject<User>(json);
Console.WriteLine(user.Scores[0]); // → 98

public class User
{
    [JsonProperty("id")]
    public int Id { get; set; }

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

    [JsonProperty("scores")]
    public List<int> Scores { get; set; }
}

// Install: npm install -g quicktype
// Generate C# classes from JSON:
// quicktype --lang csharp --src data.json --out Models.cs

// From stdin:
// echo '{"id": 1, "name": "Alice"}' | quicktype --lang csharp

// Output:
// public class Root
// {
//     [JsonPropertyName("id")]
//     public int Id { get; set; }
//
//     [JsonPropertyName("name")]
//     public string Name { get; set; }
// }

import json

def json_to_csharp(data: dict, class_name: str = "Root") -> str:
    lines = [f"public class {class_name}", "{"]
    type_map = {str: "string", int: "int", float: "double", bool: "bool"}

    for key, value in data.items():
        cs_type = type_map.get(type(value), "object")
        prop = key[0].upper() + key[1:]  # PascalCase
        lines.append(f'    [JsonPropertyName("{key}")]')
        lines.append(f'    public {cs_type} {prop} {{ get; set; }}')
        lines.append('')
    lines.append("}")
    return "\n".join(lines)

data = json.loads('{"id": 1, "name": "Alice", "active": true}')
print(json_to_csharp(data))

Pertanyaan yang Sering Diajukan