Sequelize (JS) মডেল কে JSON-এ রূপান্তর করুন!

Sequelize (JS) মডেল দিন এবং উদাহরণ JSON তৈরি করুন! Sequelize define, DataTypes সমর্থিত। API ডকুমেন্টেশন ও টেস্ট request body (sample JSON)-এর জন্য উপযোগী।
Sequelize (JS)
ফলাফল
 

Sequelize (JS) মডেল কে JSON-এ রূপান্তর করুন!

এটি সাধারণ JavaScript-এ লেখা Sequelize মডেল, sequelize.define("User", {...}) বা Model.init({...}, {...}), পড়ে উদাহরণ JSON-এ বদলে দেয়। নির্ভর করার মতো কোনো type annotation না থাকায় প্রতিটি অ্যাট্রিবিউটের ভ্যালু বেছে নেওয়া হয় তার DataTypes এন্ট্রি থেকে।

TypeScript ছাড়া Express আর Sequelize চালানো পুরোনো Node.js সার্ভারের জন্য এটি মানানসই, যেখানে API response বা seed row কেমন দেখায় তার একমাত্র বর্ণনা হলো মডেল ফাইল।

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

  1. Sequelize (JS) বক্সে মডেল ফাইলটি পেস্ট করুন। থেকে যাওয়া require লাইন আর module.exports থাকলেও সমস্যা নেই।
  2. ফাইলে কয়েকটি মডেল ডিফাইন করা থাকলে আউটপুট মডেলের নাম অনুযায়ী key করা হয়, যেমন { "User": {...}, "Post": {...} }।
  3. মডেল অপশন (দ্বিতীয় আর্গুমেন্ট), যেমন timestamps, paranoid বা নাম বদলানো createdAt, প্রতিফলিত হয়েছে কি না দেখে কপি করুন।

উদাহরণ

ইনপুট (Sequelize · JavaScript)
class Reservation extends Model {}

Reservation.init(
  {
    code: { type: DataTypes.UUID, defaultValue: DataTypes.UUIDV4, primaryKey: true },
    guests: DataTypes.SMALLINT,
    checkIn: DataTypes.DATEONLY,
    arrivalTime: DataTypes.TIME,
    options: DataTypes.JSONB,
    tags: DataTypes.ARRAY(DataTypes.STRING),
  },
  { sequelize, modelName: "Reservation", updatedAt: false }
);
আউটপুট (JSON)
{
  "code": "00000000-0000-0000-0000-000000000000",
  "guests": 0,
  "checkIn": "1970-01-01",
  "arrivalTime": "00:00:00",
  "options": {},
  "tags": [
    ""
  ],
  "createdAt": "1970-01-01T00:00:00.000Z"
}

code-এ primaryKey: true আছে, তাই কোনো id যোগ হয় না, আর এর defaultValue হলো DataTypes.UUIDV4, যা literal নয়, একটি generator, তাই placeholder UUID দেখানো হয়। updatedAt: false থাকায় createdAt-ই একমাত্র timestamp থাকে, আর DATEONLY, TIME, JSONB ও ARRAY(STRING) হয় যথাক্রমে তারিখের স্ট্রিং, সময়ের স্ট্রিং, ফাঁকা অবজেক্ট আর এক element-এর array।

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

  • DataTypes.STRING, TEXT, CHAR → ""; INTEGER, BIGINT, FLOAT, DECIMAL → 0; BOOLEAN → false।
  • DATE দেয় 1970-01-01T00:00:00.000Z, DATEONLY দেয় 1970-01-01 আর TIME দেয় 00:00:00।
  • UUID হয় পুরো শূন্যের UUID স্ট্রিং, ENUM("admin", "user") তার প্রথম ভ্যালু, আর JSON/JSONB একটি ফাঁকা অবজেক্ট।
  • ARRAY(DataTypes.STRING) তার element type অনুসরণ করে, আর VIRTUAL(DataTypes.STRING) ভেতরের type থেকে পূরণ হয়।
  • মডেল অপশন timestamps: false, updatedAt: false, createdAt: "created_on" আর paranoid: true তারিখের অ্যাট্রিবিউট যোগ করে, বাদ দেয় বা নাম বদলায়।
  • দীর্ঘ রূপ { type: ..., allowNull: ... } আর সংক্ষিপ্ত রূপ DataTypes.X দুটোই বোঝা যায়।

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

Seeder ডেটার খসড়া

queryInterface.bulkInsert-এর অবজেক্ট array লেখার সময় আউটপুট থেকে শুরু করুন, যাতে key-এর নাম আর type মডেলের সাথে মেলে। ডাটাবেস যেগুলো পূরণ করে সেখানে জেনারেট হওয়া id আর timestamp সরিয়ে দিন।

Type ছাড়া legacy কোড পড়া

TypeScript ছাড়া শুধু পড়ে বোঝা কঠিন যে একটি মডেল কোন JSON পাঠায়। প্রতিটি মডেল ফাইল এখানে চালালে API-এর response আকৃতির একটি দ্রুত মানচিত্র পাওয়া যায়।

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

  • Literal defaultValue ("pending", 1, true) নমুনা ভ্যালু হয়। DataTypes.NOW, DataTypes.UUIDV4 বা sequelize.fn(...)-এর মতো জেনারেট হওয়া default type-এর placeholder-এ ফিরে যায়।
  • hasMany আর belongsTo-এর মতো association মডেল ডেফিনিশনের বাইরে থাকে, তাই আউটপুটে নেই। include দিয়ে লোড করা ডেটা হাতে যোগ করুন।
  • MySQL আর PostgreSQL-এ runtime-এ DECIMAL সাধারণত স্ট্রিং হিসেবে ফেরত আসে, কিন্তু উদাহরণে 0 দেখায়।
  • GEOMETRY-এর মতো স্পষ্ট নমুনা ভ্যালু নেই এমন type null হয়।

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

আমি underscored: true সেট করেছি। তাহলে কেন created_at না হয়ে createdAt?

underscored শুধু ডাটাবেসের কলামের নাম snake_case-এ বদলায়। toJSON() যে অ্যাট্রিবিউটের নাম ব্যবহার করে তা createdAt-ই থাকে, তাই আউটপুট মেলে। JSON key-ও বদলাতে চাইলে createdAt: "created_at" দিয়ে স্পষ্টভাবে নাম দিন।

class User extends Model {} আর User.init() আলাদা থাকলে কি কাজ করে?

হ্যাঁ। .init(-এর ঠিক আগের identifier মডেলের নাম হিসেবে ব্যবহৃত হয়, আর প্রথম আর্গুমেন্টকে অ্যাট্রিবিউট map হিসেবে পড়া হয়।

TypeScript decorator মডেল কোথায় কনভার্ট করব?

@Table আর @Column-সহ sequelize-typescript মডেলের জন্য Sequelize (TS) থেকে JSON পেজ ব্যবহার করুন। সেই পেজ DataType-এর বদলে প্রপার্টির type পড়ে।