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

JSON দিন এবং nested object সহ Dart class কোড তৈরি করুন! Flutter, fromJson, toJson সমর্থিত।
JSON
ফলাফল
 

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

JSON-কে fromJson factory আর toJson মেথডসহ Dart ক্লাসে বদলে নিন। কোডটি কোনো code-generation প্যাকেজ ছাড়া সাধারণ Dart, তাই কোনো build_runner ধাপ নেই।

যেসব Flutter অ্যাপ http বা dio থেকে পাওয়া কাঁচা Map<String, dynamic> response সরাসরি widget-এ পাঠায় এবং এর বদলে ঠিকঠাক মডেল ক্লাস চায়, অথবা json_serializable গ্রহণ করার আগেই কাজ করে এমন serialization দরকার এমন ছোট প্রজেক্টের জন্য এটি মানানসই।

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

  1. কনভার্ট করার JSON পেস্ট করুন।
  2. টাইপের নাম-এ top-level ক্লাসের নাম দিন (যেমন Store)।
  3. আউটপুটটি lib/models/-এর অধীনে একটি ফাইলে পেস্ট করুন; কোনো import লাগে না।
  4. Store.fromJson(jsonDecode(response.body) as Map<String, dynamic>) দিয়ে অবজেক্ট তৈরি করুন এবং jsonEncode(store.toJson()) দিয়ে পাঠান।

উদাহরণ

ইনপুট (JSON)
{
  "storeId": 77,
  "storeName": "Mapo Kimbap",
  "isOpen": true,
  "rating": 4.7,
  "menuItems": [
    { "name": "Tuna Kimbap", "price": 4500, "soldOut": false },
    { "name": "Ramyeon", "price": 5000, "soldOut": true, "spicy": 2 }
  ]
}
আউটপুট (Dart)
class Store {
  final int storeId;
  final String storeName;
  final bool isOpen;
  final double rating;
  final List<MenuItem> menuItems;

  Store({
    required this.storeId,
    required this.storeName,
    required this.isOpen,
    required this.rating,
    required this.menuItems,
  });

  factory Store.fromJson(Map<String, dynamic> json) => Store(
        storeId: json['storeId'] as int,
        storeName: json['storeName'] as String,
        isOpen: json['isOpen'] as bool,
        rating: (json['rating'] as num).toDouble(),
        menuItems: (json['menuItems'] as List<dynamic>).map((e) => MenuItem.fromJson(e as Map<String, dynamic>)).toList(),
      );

  Map<String, dynamic> toJson() => {
        'storeId': storeId,
        'storeName': storeName,
        'isOpen': isOpen,
        'rating': rating,
        'menuItems': menuItems.map((e) => e.toJson()).toList(),
      };
}

class MenuItem {
  final String name;
  final int price;
  final bool soldOut;
  final int? spicy;

  MenuItem({
    required this.name,
    required this.price,
    required this.soldOut,
    this.spicy,
  });

  factory MenuItem.fromJson(Map<String, dynamic> json) => MenuItem(
        name: json['name'] as String,
        price: json['price'] as int,
        soldOut: json['soldOut'] as bool,
        spicy: json['spicy'] as int?,
      );

  Map<String, dynamic> toJson() => {
        'name': name,
        'price': price,
        'soldOut': soldOut,
        'spicy': spicy,
      };
}

menuItems array-এর element-গুলো একটি MenuItem ক্লাস হয়, যা fromJson-এর ভেতরে .map(...).toList() দিয়ে কনভার্ট হয়। rating পড়া হয় (json['rating'] as num).toDouble() হিসেবে, তাই integer ভ্যালুও নিরাপদ, আর শুধু কিছু মেনু আইটেমে থাকা spicy হয় int?, constructor-এ required ছাড়া।

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

  • সব ফিল্ড final; constructor named parameter ({required this.x}) ব্যবহার করে।
  • কোনো প্যাকেজ নির্ভরতা ছাড়া হাতে লেখার মতো factory X.fromJson(Map<String, dynamic> json) আর Map<String, dynamic> toJson()।
  • Nested অবজেক্ট আর অবজেক্টের array child ক্লাসের fromJson / toJson কল করে।
  • double ফিল্ড (as num).toDouble() দিয়ে পড়া হয়, তাই 4-এর মতো JSON integer cast error ছোড়ে না।
  • যেসব ফিল্ড কিছু আইটেমে নেই বা null থাকে সেগুলো nullable (int?) হয় এবং fromJson-এ null সরাসরি পার হয়।
  • মিশ্র type-এর ভ্যালু dynamic; class বা is-এর মতো Dart reserved word-এর শেষে আন্ডারস্কোর যোগ হয়।
  • Top-level array থেকে typedef Root = List<RootItem>; তৈরি হয়।

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

Flutter স্ক্রিনের জন্য API মডেল

FutureBuilder বা Riverpod/Bloc state-এর মধ্য দিয়ে Map বহন করলে key-এর টাইপো runtime পর্যন্ত লুকিয়ে থাকে। জেনারেট হওয়া ক্লাসে store.menuItems.first.price-এ completion আর type check পাওয়া যায়।

লোকাল ক্যাশিং

jsonEncode(store.toJson()) shared_preferences বা একটি ফাইলে রাখুন এবং অ্যাপ চালুর সময় fromJson দিয়ে ফিরিয়ে আনুন, কয়েক লাইনেই একটি ক্যাশ।

json_serializable-এর আগের খসড়া

আগে ফিল্ডের তালিকা আর type নিশ্চিত করুন; প্রজেক্ট বড় হলে একই ফিল্ডগুলোতে @JsonSerializable() যোগ করে code generation-এ চলে যান।

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

  • Type অনুমান হয় ব্রাউজারের JSON parser দিয়ে, যা 5000.0-কে integer 5000 হিসেবে পড়ে। Dart-এর jsonDecode 5000.0-কে double রাখে, তাই as int exception ছোড়ে। দশমিক বিন্দু আসতে পারে এমন দাম বা স্থানাঙ্কের ফিল্ড double-এ বদলে নিন।
  • toJson nullable ফিল্ড null হলেও লিখে দেয় ('spicy': null)। আপনার সার্ভার null key প্রত্যাখ্যান করলে শর্তসাপেক্ষে সেগুলো বাদ দিন।
  • তারিখের স্ট্রিং String-ই থাকে; DateTime.parse(json['createdAt'] as String) দিয়ে নিজে কনভার্ট করুন।
  • কোনো copyWith, ==/hashCode বা toString তৈরি হয় না। দরকার হলে freezed বা equatable বিবেচনা করুন।
  • dynamic ফিল্ড যাচাই ছাড়াই ভ্যালু রাখে; আসল type জানা হলে সেগুলো বদলে দিন।

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

এটি কি json_serializable বা freezed কোড তৈরি করতে পারে?

আউটপুট হলো প্যাকেজ ছাড়া হাতে লেখার ধাঁচের fromJson/toJson। Code generation-এ যেতে ফিল্ডের ডিক্লারেশনগুলো নিয়ে @JsonSerializable() আর part 'store.g.dart'; যোগ করুন এবং dart run build_runner build চালান।

আমি type 'int' is not a subtype of type 'double' পাচ্ছি।

কোড as double দিয়ে cast করলে আর JSON ভ্যালু integer হলে এটি ঘটে। জেনারেট হওয়া double ফিল্ড এটি এড়াতে (as num).toDouble() ব্যবহার করে; হাতে এডিট করা যেকোনো ফিল্ডেও একই প্যাটার্ন প্রয়োগ করুন।

তালিকা response ([ {...}, {...} ]) কীভাবে decode করব?

Top-level array থেকে একটি typedef আর একটি element ক্লাস তৈরি হয়। প্রতিটি element-এ fromJson কল করুন: (jsonDecode(body) as List<dynamic>).map((e) => RootItem.fromJson(e as Map<String, dynamic>)).toList()।

Null safety ছাড়া পুরোনো প্রজেক্টে কি এটি কাজ করে?

আউটপুট Dart 2.12 থেকে চালু sound null safety syntax (int?, required) ব্যবহার করে। Null safety-র আগের প্রজেক্টে কম্পাইল করতে ? আর required সরাতে হবে।