Ubah JSON menjadi class C#!

Masukkan JSON untuk membuat kode class C#, termasuk objek bersarang! Mendukung System.Text.Json [JsonPropertyName], .NET, ASP.NET Core.
JSON
Hasil
 

Ubah JSON menjadi class C#!

Konversikan JSON menjadi class C# untuk System.Text.Json. Nama properti diubah menjadi PascalCase, dan setiap properti diberi atribut [JsonPropertyName] agar terikat ke key aslinya dengan tepat.

Alat ini menghemat pekerjaan salin-dan-ketik untuk model request dan response ASP.NET Core, tipe untuk pemanggilan HttpClient.GetFromJsonAsync<T>() ke API eksternal, serta data class di aplikasi Unity atau MAUI.

Cara menggunakan

  1. Tempel respons JSON atau file konfigurasi.
  2. Isi nama class root di Nama tipe (misalnya PaymentResult).
  3. Masukkan class yang dihasilkan ke file .cs lalu tambahkan namespace Anda.
  4. Gunakan dengan JsonSerializer.Deserialize<PaymentResult>(json) atau GetFromJsonAsync<PaymentResult>(url).

Contoh

Input (JSON)
{
  "paymentId": "pay_8f2k",
  "amount": 15000,
  "currency": "KRW",
  "approved": true,
  "approvedAt": "2024-05-01T12:30:00Z",
  "card": { "issuer": "VISA", "last4": "4242" },
  "metadata": null
}
Output (C# · System.Text.Json)
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;
}

Setiap properti memiliki [JsonPropertyName], jadi paymentId ↔ PaymentId cocok apa pun aturan huruf besar-kecilnya. metadata selalu bernilai null, sehingga tipenya tidak diketahui dan menjadi JsonElement?. Properti string dan objek diberi initializer string.Empty / new() agar kode bisa di-compile tanpa peringatan nullable.

Fitur yang didukung

  • [JsonPropertyName("originalKey")] pada setiap properti, beserta using System.Text.Json.Serialization;.
  • Tipe: string, int, long untuk integer di atas 32 bit, double untuk desimal, bool, dan List<T> untuk array.
  • Nilai dengan tipe campuran atau tidak diketahui menjadi JsonElement, dengan tambahan using System.Text.Json;.
  • Properti yang tidak ada di sebagian item atau berisi null menjadi nullable (int?, string?).
  • Properti wajib mendapat initializer = string.Empty; atau = new(); untuk menghindari peringatan nullable reference CS8618.
  • Properti yang namanya sama dengan nama class-nya tidak diizinkan di C#, jadi diberi akhiran Value (misalnya RootValue).
  • Array tingkat atas menghasilkan komentar // Root: List<RootItem> beserta class elemennya.

Kasus penggunaan

Memanggil API eksternal dengan HttpClient

Konversikan contoh respons dari API pembayaran atau pelacakan pengiriman dan gunakan sebagai tipe di await http.GetFromJsonAsync<PaymentResult>(url), alih-alih mengambil field satu per satu dari JsonDocument.

Model payload webhook di ASP.NET Core

Buat class dari payload yang dikirim layanan pihak ketiga ke Anda dan terima sebagai parameter [FromBody], sehingga model binding dan validasi berjalan seperti biasa.

appsettings dan file data game

Mengunci struktur file data JSON yang dibaca aplikasi Unity atau console ke dalam class berarti perubahan pada file data langsung muncul sebagai error deserialisasi.

Catatan dan batasan

  • Output untuk Newtonsoft.Json ([JsonProperty]) tidak dibuat. Jika Anda memakai Json.NET, ganti atributnya menjadi [JsonProperty("key")].
  • String tanggal tetap string. Untuk nilai ISO 8601, cukup ubah tipenya menjadi DateTime atau DateTimeOffset agar System.Text.Json mem-parse-nya.
  • new() bertipe target dan string? mengasumsikan C# 9+ dengan nullable context aktif (default sejak .NET 6).
  • Tidak ada output record atau required. Untuk model immutable, ubah { get; set; } menjadi { get; init; }.
  • Semua class keluar dalam satu blok; pemisahan file dan namespace Anda lakukan sendiri.

FAQ

Mengapa [JsonPropertyName] ditambahkan meskipun key-nya sudah cocok?

System.Text.Json secara default peka huruf besar-kecil. Di proyek console atau worker tanpa JsonSerializerOptions kustom, paymentId tidak akan terikat ke PaymentId, jadi atribut selalu ditulis agar berfungsi apa pun konfigurasinya.

Bagaimana cara membaca properti JsonElement??

Periksa ValueKind, lalu gunakan GetString(), GetInt32() atau Deserialize<T>(). Setelah tipe sebenarnya diketahui, mengganti JsonElement dengan tipe itu adalah pilihan yang lebih rapi.

Bisakah nama properti tetap camelCase?

Output mengikuti konvensi PascalCase C#. Key aslinya ada di [JsonPropertyName], jadi Anda bebas mengganti nama properti selama atributnya tetap ada.

Apakah bisa dipakai dengan JsonUtility di Unity?

JsonUtility hanya menangani field public dari class [Serializable], bukan properti, dan mengabaikan [JsonPropertyName]. Di Unity, pasangkan output ini dengan package Newtonsoft.Json atau System.Text.Json.