JSON থেকে C# ক্লাস

JSON থেকে C# রূপান্তর কী?

JSON থেকে C# রূপান্তর হলো JSON ডেটা থেকে strongly-typed C# ক্লাস সংজ্ঞা তৈরি করার প্রক্রিয়া। যখন একটি .NET অ্যাপ্লিকেশন কোনো API, কনফিগারেশন ফাইল বা মেসেজ কিউ থেকে JSON গ্রহণ করে, তখন সেই ডেটা অবজেক্টে ডিসিরিয়ালাইজ করতে C# ক্লাসের প্রয়োজন হয়। বিশেষত JSON-এ নেস্টেড অবজেক্ট, অ্যারে ও মিশ্র টাইপ থাকলে এই ক্লাসগুলো হাতে লেখা ক্লান্তিকর ও ত্রুটিপ্রবণ।

একটি JSON থেকে C# ক্লাস জেনারেটর আপনার JSON-এর কাঠামো ও মান পরীক্ষা করে, প্রতিটি ফিল্ডের জন্য উপযুক্ত C# টাইপ নির্ধারণ করে এবং প্রপার্টি অ্যাক্সেসর ও সিরিয়ালাইজেশন অ্যাট্রিবিউটসহ ক্লাস সংজ্ঞা তৈরি করে। আউটপুট .NET নামকরণ রীতি অনুসরণ করে: PascalCase প্রপার্টির নাম, মূল camelCase বা snake_case JSON কী-তে ম্যাপ করতে JsonPropertyName অ্যাট্রিবিউট, এবং অ্যারের জন্য List'<'T'>' এর সঠিক ব্যবহার।

এই রূপান্তর ASP.NET Core ওয়েব API, Azure Functions এবং বাহ্যিক JSON ডেটা ব্যবহারকারী যেকোনো .NET সার্ভিসে বিশেষভাবে প্রচলিত। dynamic বা Dictionary'<'string, object'>' ব্যবহারের পরিবর্তে, টাইপড ক্লাস আপনাকে কম্পাইল-সময় নিরাপত্তা, IntelliSense সমর্থন এবং ফিল্ড নামের টাইপো থেকে সুরক্ষা দেয় যা অন্যথায় শুধু রানটাইমে ধরা পড়ত। আপনার JSON এই টুলে পেস্ট করুন এবং তাৎক্ষণিকভাবে ব্যবহারযোগ্য C# ক্লাস পান।

JSON থেকে C# জেনারেটর কেন ব্যবহার করবেন?

JSON স্যাম্পল থেকে C# মডেল ক্লাস হাতে লেখা সময়সাপেক্ষ এবং মানবিক ভুলের সুযোগ তৈরি করে। একটি জেনারেটর পুনরাবৃত্তিমূলক অংশগুলো সামলায়, যাতে আপনি ব্যবসায়িক লজিকে মনোযোগ দিতে পারেন।

JSON থেকে C# ব্যবহারের ক্ষেত্র

JSON থেকে C# টাইপ ম্যাপিং রেফারেন্স

প্রতিটি JSON মানের টাইপ একটি নির্দিষ্ট C# টাইপে ম্যাপ হয়। জেনারেটর সর্বাধিক নির্ভুল টাইপ বেছে নিতে প্রকৃত মান বিশ্লেষণ করে। উদাহরণস্বরূপ, দশমিক বিন্দু ছাড়া একটি JSON সংখ্যা int হয়, আর 3.14 হয় double। Null মান object? (nullable রেফারেন্স টাইপ) তৈরি করে কারণ শুধু null থেকে প্রকৃত টাইপ নির্ধারণ করা সম্ভব নয়।

System.Text.Json বনাম Newtonsoft.Json

.NET-এ দুটি প্রধান JSON সিরিয়ালাইজেশন লাইব্রেরি রয়েছে। এই টুলের জেনারেটেড ক্লাস System.Text.Json অ্যাট্রিবিউট (JsonPropertyName) ব্যবহার করে, যা .NET Core 3.0 থেকে অন্তর্নির্মিত বিকল্প। আপনার প্রজেক্ট Newtonsoft.Json ব্যবহার করলে অ্যাট্রিবিউট পরিবর্তন করে নিতে পারেন।

কোড উদাহরণ

এই উদাহরণগুলো দেখায় কীভাবে JSON থেকে জেনারেটেড C# ক্লাস সংজ্ঞায়িত ও ব্যবহার করতে হয়, উভয় প্রধান সিরিয়ালাইজেশন লাইব্রেরি ব্যবহার করে, এবং কমান্ড লাইন থেকে জেনারেশন স্বয়ংক্রিয় করার উপায়।

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))

সাধারণ জিজ্ঞাসা