JSON কে Swift Codable struct-এ রূপান্তর করুন!

JSON দিন এবং nested object সহ Swift Codable struct কোড তৈরি করুন! Codable, CodingKeys, JSONDecoder, iOS সমর্থিত।
JSON
ফলাফল
 

JSON কে Swift Codable struct-এ রূপান্তর করুন!

JSON-কে Codable গ্রহণ করা Swift struct-এ কনভার্ট করুন। প্রপার্টিগুলো let দিয়ে ডিক্লেয়ার হয় এবং camelCase-এ নাম বদলায়, আর CodingKeys enum তৈরি হয় শুধু সেই struct-গুলোতে যেখানে কোনো নাম তার JSON key থেকে আলাদা।

কোনো iOS বা macOS অ্যাপে URLSession response JSONDecoder দিয়ে decode করার মডেল দরকার হলে, অথবা SwiftUI preview-এর পেছনের mock JSON-এর সাথে মেলে এমন type চাইলে এটি ব্যবহার করুন।

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

  1. আপনার API-এর একটি response body পেস্ট করুন, যেমন Proxyman বা Charles দিয়ে ধরা একটি।
  2. টাইপের নাম-এ top-level struct-এর নাম দিন (যেমন EpisodePage)।
  3. ফলাফলটি একটি Swift ফাইলে পেস্ট করুন; import Foundation যুক্ত থাকে।
  4. try JSONDecoder().decode(EpisodePage.self, from: data) দিয়ে decode করুন।

উদাহরণ

ইনপুট (JSON)
{
  "podcast": "Swift Talk",
  "episodes": [
    { "id": 301, "title": "Async Sequences", "duration": 1840, "explicit": false },
    { "id": 302, "title": "Macros", "duration": 2215.5, "explicit": false, "guest_name": "Chris" }
  ],
  "total_count": 2
}
আউটপুট (Swift · Codable)
import Foundation

struct EpisodePage: Codable {
    let podcast: String
    let episodes: [Episode]
    let totalCount: Int

    enum CodingKeys: String, CodingKey {
        case podcast
        case episodes
        case totalCount = "total_count"
    }
}

struct Episode: Codable {
    let id: Int
    let title: String
    let duration: Double
    let explicit: Bool
    let guestName: String?

    enum CodingKeys: String, CodingKey {
        case id
        case title
        case duration
        case explicit
        case guestName = "guest_name"
    }
}

episodes array-এর element-গুলো একটি Episode struct হয়। duration-এ integer (1840) আর দশমিক (2215.5) মেশানো, তাই এটি Double; শুধু দ্বিতীয় এপিসোডে পাওয়া guest_name হয় guestName: String?। নাম বদলানো ফিল্ড আছে এমন প্রতিটি struct তার সব key-এর তালিকাসহ একটি CodingKeys enum পায়।

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

  • প্রতিটি struct Codable গ্রহণ করে; প্রপার্টিগুলো immutable let।
  • snake_case আর kebab-case key camelCase প্রপার্টি হয়, এবং কেবল তখনই মূল key-সহ enum CodingKeys: String, CodingKey যোগ হয়।
  • Type: String, Int, Double, Bool, আর array-এর জন্য [T]।
  • কিছু আইটেমে না থাকা বা null থাকা ফিল্ড Optional (String?) হয়, তাই key অনুপস্থিত থাকলেও decode হয়।
  • মিশ্র type-এর ভ্যালু একটি জেনারেট হওয়া, decode-যোগ্য JSONValue enum ব্যবহার করে।
  • default, class বা self-এর মতো Swift keyword backtick-এ মোড়ানো হয়।
  • Top-level array থেকে typealias Root = [RootItem] তৈরি হয়।

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

async/await-সহ URLSession

একটিমাত্র নমুনা response থেকেই এমন মডেল পান যা let (data, _) = try await URLSession.shared.data(from: url)-এর ঠিক পরের লাইনেই decode করা যায়।

SwiftUI-এর তালিকা স্ক্রিন

জেনারেট হওয়া struct-এ (যদি id ফিল্ড থাকে) Identifiable যোগ করে সরাসরি List(page.episodes) { ... }-এ দিন।

Bundle-এ রাখা mock ডেটা

ডিজাইন পর্যায়ের নমুনা JSON অ্যাপ bundle-এ রেখে একই মডেল দিয়ে decode করুন, তাহলে আসল API প্রস্তুত হওয়ার আগেই স্ক্রিন তৈরি করা যায়।

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

  • তারিখের স্ট্রিং String হিসেবে আসে। Date পেতে প্রপার্টির type বদলে decoder.dateDecodingStrategy = .iso8601-এর মতো একটি strategy সেট করুন।
  • কোনো response-এ non-optional প্রপার্টির key না থাকলে decoding DecodingError.keyNotFound ছোড়ে। আপনার নমুনায় সবসময় থাকলেও API বাদ দিতে পারে এমন ফিল্ডে ? যোগ করুন।
  • সব প্রপার্টি let; view state হিসেবে বদলানো মডেলের জন্য var-এ বদলান।
  • Identifiable বা Hashable-এর মতো বাড়তি কোনো protocol গ্রহণ করা হয় না।
  • JSONValue enum মিশ্র type-এর জন্য helper কোড; আপনার প্রজেক্টে আগে থেকেই সমতুল্য type থাকলে এটি মুছে নিজেরটি ব্যবহার করুন।

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

keyDecodingStrategy = .convertFromSnakeCase থাকলে কি CodingKeys মুছে ফেলা যায়?

হ্যাঁ, তখন decoder নিজেই guest_name ↔ guestName কনভার্ট করে। তবে দুটো একসাথে ব্যবহার করবেন না: decoder আগে key-গুলো camelCase-এ কনভার্ট করে, তারপর CodingKeys-এর "guest_name" raw value-এর সাথে তুলনা করে, ফলে মেলানো ব্যর্থ হয়।

ক্লাস নয়, কেন struct?

Response মডেলকে value type হিসেবে রাখাই Swift-এর প্রচলিত রীতি, আর struct বিনা খরচে memberwise initializer পায়, যা টেস্ট ডেটা বানানো সহজ করে। Reference semantics দরকার হলে final class-এ বদলে একটি initializer যোগ করুন।

যে ফিল্ড integer হবে ভেবেছিলাম সেটি Double হিসেবে এসেছে।

কোনো key-তে integer আর দশমিক দুটোই থাকলে Double precision হারানো এড়ায়। উল্টোভাবে, প্রতিটি নমুনা ভ্যালু 4.0-এর মতো হলে ব্রাউজারের JSON parser সেটিকে integer হিসেবে পড়ে এবং আপনি Int পেতে পারেন, তাই আসল API ভ্যালু যাচাই করুন।

আবার JSON-এ encode করলে কি মূল key থাকে?

CodingKeys encoding-এও ব্যবহৃত হয়, তাই JSONEncoder আবার guest_name লেখে। nil থাকা Optional প্রপার্টি আউটপুট থেকে বাদ পড়ে।