JSON কে C# class-এ রূপান্তর করুন!

JSON দিন এবং nested object সহ C# class কোড তৈরি করুন! System.Text.Json [JsonPropertyName], .NET, ASP.NET Core সমর্থিত।
JSON
ফলাফল
 

JSON কে C# class-এ রূপান্তর করুন!

JSON-কে System.Text.Json-এর জন্য C# ক্লাসে কনভার্ট করুন। প্রপার্টির নাম PascalCase-এ বদলানো হয়, আর প্রতিটি প্রপার্টিতে একটি [JsonPropertyName] অ্যাট্রিবিউট থাকে, যাতে সেটি হুবহু মূল key-এর সাথে bind হয়।

ASP.NET Core-এর request ও response মডেল, এক্সটার্নাল API-তে HttpClient.GetFromJsonAsync<T>() কলের type, আর Unity বা MAUI অ্যাপের ডেটা ক্লাসের জন্য কপি করে টাইপ করার খাটুনি বাঁচায়।

কীভাবে ব্যবহার করবেন

  1. একটি JSON response বা কনফিগারেশন ফাইল পেস্ট করুন।
  2. টাইপের নাম-এ রুট ক্লাসের নাম দিন (যেমন PaymentResult)।
  3. জেনারেট হওয়া ক্লাসগুলো একটি .cs ফাইলে বসিয়ে আপনার namespace যোগ করুন।
  4. JsonSerializer.Deserialize<PaymentResult>(json) বা GetFromJsonAsync<PaymentResult>(url)-এর সাথে ব্যবহার করুন।

উদাহরণ

ইনপুট (JSON)
{
  "paymentId": "pay_8f2k",
  "amount": 15000,
  "currency": "KRW",
  "approved": true,
  "approvedAt": "2024-05-01T12:30:00Z",
  "card": { "issuer": "VISA", "last4": "4242" },
  "metadata": null
}
আউটপুট (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;
}

প্রতিটি প্রপার্টিতে [JsonPropertyName] আছে, তাই casing-এর নিয়ম যা-ই হোক paymentId ↔ PaymentId মিলে যায়। metadata সবসময় শুধু null, তাই এর type অজানা এবং এটি JsonElement? হয়। String আর অবজেক্ট প্রপার্টি string.Empty / new() initializer পায়, যাতে nullable warning ছাড়াই কোড কম্পাইল হয়।

সমর্থিত বৈশিষ্ট্য

  • প্রতিটি প্রপার্টিতে [JsonPropertyName("originalKey")], সাথে using System.Text.Json.Serialization;।
  • Type: string, int, 32 বিটের বেশি integer-এর জন্য long, দশমিকের জন্য double, bool, আর array-এর জন্য List<T>।
  • মিশ্র বা অজানা type-এর ভ্যালু JsonElement হয়, এবং using System.Text.Json; যোগ হয়।
  • যেসব প্রপার্টি কিছু আইটেমে নেই বা null থাকে সেগুলো nullable (int?, string?) হয়।
  • Nullable reference warning CS8618 এড়াতে required প্রপার্টিগুলো = string.Empty; বা = new(); initializer পায়।
  • C#-এ কোনো প্রপার্টির নাম তার ক্লাসের নামের সাথে এক হতে পারে না, তাই সেটি Value suffix পায় (যেমন RootValue)।
  • Top-level array থেকে একটি // Root: List<RootItem> কমেন্ট আর element ক্লাস তৈরি হয়।

ব্যবহারের ক্ষেত্র

HttpClient দিয়ে এক্সটার্নাল API কল

পেমেন্ট বা শিপমেন্ট-ট্র্যাকিং API-এর একটি নমুনা response কনভার্ট করে await http.GetFromJsonAsync<PaymentResult>(url)-এ type হিসেবে ব্যবহার করুন, JsonDocument থেকে একটি একটি করে ফিল্ড বের করার বদলে।

ASP.NET Core-এ webhook payload মডেল

থার্ড-পার্টি সার্ভিস আপনাকে যে payload পোস্ট করে তা থেকে ক্লাস তৈরি করে [FromBody] parameter হিসেবে গ্রহণ করুন, যাতে model binding আর validation স্বাভাবিকভাবে কাজ করে।

appsettings আর গেম ডেটা ফাইল

Unity বা কনসোল অ্যাপ যে JSON ডেটা ফাইল পড়ে তার গঠন ক্লাসে বেঁধে রাখলে ডেটা ফাইল বদলালে সাথে সাথেই deserialization error হিসেবে ধরা পড়ে।

নোট ও সীমাবদ্ধতা

  • Newtonsoft.Json ([JsonProperty]) আউটপুট তৈরি হয় না। Json.NET ব্যবহার করলে অ্যাট্রিবিউটগুলো [JsonProperty("key")]-এ বদলে নিন।
  • তারিখের স্ট্রিং string-ই থাকে। ISO 8601 ভ্যালুর জন্য type বদলে DateTime বা DateTimeOffset করলেই System.Text.Json সেগুলো parse করতে পারে।
  • Target-typed new() আর string? ধরে নেয় C# 9+ এবং nullable context চালু আছে (.NET 6 থেকে এটিই ডিফল্ট)।
  • record বা required আউটপুট নেই। Immutable মডেলের জন্য { get; set; }-কে { get; init; }-এ বদলান।
  • সব ক্লাস একটি ব্লকে আসে; ফাইল আর namespace ভাগ করা আপনার কাজ।

সাধারণ প্রশ্ন

Key আগে থেকেই মিললেও কেন [JsonPropertyName] যোগ করা হয়?

System.Text.Json ডিফল্টভাবে case-sensitive। কাস্টম JsonSerializerOptions ছাড়া কনসোল বা worker প্রজেক্টে paymentId, PaymentId-এর সাথে bind হবে না, তাই কনফিগারেশন যা-ই হোক কাজ করার জন্য অ্যাট্রিবিউট সবসময় লেখা হয়।

JsonElement? প্রপার্টি কীভাবে পড়ব?

ValueKind চেক করুন, তারপর GetString(), GetInt32() বা Deserialize<T>() ব্যবহার করুন। আসল type জানা হয়ে গেলে JsonElement-কে সেটি দিয়ে বদলে দেওয়াই পরিচ্ছন্ন উপায়।

প্রপার্টির নাম কি camelCase-এ রাখা যায়?

আউটপুট C#-এর PascalCase রীতি মেনে চলে। মূল key [JsonPropertyName]-এ থাকে, তাই অ্যাট্রিবিউট রেখে দিলে প্রপার্টির নাম ইচ্ছামতো বদলাতে পারেন।

এটি কি Unity-র JsonUtility-র সাথে কাজ করে?

JsonUtility শুধু [Serializable] ক্লাসের public ফিল্ড প্রসেস করে, প্রপার্টি নয়, এবং [JsonPropertyName] উপেক্ষা করে। Unity-তে আউটপুটটি বরং Newtonsoft.Json প্যাকেজ বা System.Text.Json-এর সাথে ব্যবহার করুন।