JSON-কে Codable গ্রহণ করা Swift struct-এ কনভার্ট করুন। প্রপার্টিগুলো let দিয়ে ডিক্লেয়ার হয় এবং camelCase-এ নাম বদলায়, আর CodingKeys enum তৈরি হয় শুধু সেই struct-গুলোতে যেখানে কোনো নাম তার JSON key থেকে আলাদা।
কোনো iOS বা macOS অ্যাপে URLSession response JSONDecoder দিয়ে decode করার মডেল দরকার হলে, অথবা SwiftUI preview-এর পেছনের mock JSON-এর সাথে মেলে এমন type চাইলে এটি ব্যবহার করুন।
টাইপের নাম-এ top-level struct-এর নাম দিন (যেমন EpisodePage)।import Foundation যুক্ত থাকে।try JSONDecoder().decode(EpisodePage.self, from: data) দিয়ে decode করুন।{
"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
}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 পায়।
Codable গ্রহণ করে; প্রপার্টিগুলো immutable let।enum CodingKeys: String, CodingKey যোগ হয়।String, Int, Double, Bool, আর array-এর জন্য [T]।null থাকা ফিল্ড Optional (String?) হয়, তাই key অনুপস্থিত থাকলেও decode হয়।JSONValue enum ব্যবহার করে।default, class বা self-এর মতো Swift keyword backtick-এ মোড়ানো হয়।typealias Root = [RootItem] তৈরি হয়।একটিমাত্র নমুনা response থেকেই এমন মডেল পান যা let (data, _) = try await URLSession.shared.data(from: url)-এর ঠিক পরের লাইনেই decode করা যায়।
জেনারেট হওয়া struct-এ (যদি id ফিল্ড থাকে) Identifiable যোগ করে সরাসরি List(page.episodes) { ... }-এ দিন।
ডিজাইন পর্যায়ের নমুনা JSON অ্যাপ bundle-এ রেখে একই মডেল দিয়ে decode করুন, তাহলে আসল API প্রস্তুত হওয়ার আগেই স্ক্রিন তৈরি করা যায়।
String হিসেবে আসে। Date পেতে প্রপার্টির type বদলে decoder.dateDecodingStrategy = .iso8601-এর মতো একটি strategy সেট করুন।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-এর সাথে তুলনা করে, ফলে মেলানো ব্যর্থ হয়।
Response মডেলকে value type হিসেবে রাখাই Swift-এর প্রচলিত রীতি, আর struct বিনা খরচে memberwise initializer পায়, যা টেস্ট ডেটা বানানো সহজ করে। Reference semantics দরকার হলে final class-এ বদলে একটি initializer যোগ করুন।
Double হিসেবে এসেছে।কোনো key-তে integer আর দশমিক দুটোই থাকলে Double precision হারানো এড়ায়। উল্টোভাবে, প্রতিটি নমুনা ভ্যালু 4.0-এর মতো হলে ব্রাউজারের JSON parser সেটিকে integer হিসেবে পড়ে এবং আপনি Int পেতে পারেন, তাই আসল API ভ্যালু যাচাই করুন।
CodingKeys encoding-এও ব্যবহৃত হয়, তাই JSONEncoder আবার guest_name লেখে। nil থাকা Optional প্রপার্টি আউটপুট থেকে বাদ পড়ে।