Mongoose (JS) স্কিমা কে JSON-এ রূপান্তর করুন!

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

Mongoose (JS) স্কিমা কে JSON-এ রূপান্তর করুন!

new Schema({...}) দিয়ে ডিফাইন করা JavaScript Mongoose schema থেকে উদাহরণ ডকুমেন্টের JSON তৈরি করুন। Schema ডেফিনিশন অবজেক্টটি নিজেই parse করা হয় বলে { type: String, enum: [...] } বা { type: Map, of: Number }-এর মতো অপশন আর অন্য schema ভেরিয়েবলের reference অনুসরণ করা হয়।

Express + Mongoose API-এর পেছনের কালেকশন ডকুমেন্ট করতে, অথবা ফ্রন্টএন্ডকে একটি ডকুমেন্ট দেখতে কেমন তা বোঝাতে এটি কাজে আসে। Mongoose-এর নিজস্ব নিয়মও প্রতিফলিত হয়, যেমন array-র subdocument _id পায় কিন্তু nested path পায় না।

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

  1. Mongoose (JS) বক্সে schema ফাইলটি পেস্ট করুন। Sub-schema আলাদা ভেরিয়েবলে থাকলে সেগুলোর ডেফিনিশনও একই ইনপুটে দিন।
  2. অন্য কোনো schema ব্যবহার করে না এমন schema রুট ডকুমেন্ট হয়; এমন কয়েকটি থাকলে আউটপুট ভেরিয়েবলের নাম অনুযায়ী key করা হয়।
  3. ফলাফল পর্যালোচনা করে কপি বাটন দিয়ে কপি করুন।

উদাহরণ

ইনপুট (Mongoose · JavaScript)
const variantSchema = new Schema({
  sku: String,
  price: Schema.Types.Decimal128,
  stock: { type: Number, default: 0 },
});

const productSchema = new Schema(
  {
    title: { type: String, required: true },
    variants: [variantSchema],
    dimensions: { width: Number, height: Number },
    labels: { type: Map, of: String },
  },
  { timestamps: { createdAt: "created_at", updatedAt: false } }
);
আউটপুট (JSON)
{
  "_id": "507f1f77bcf86cd799439011",
  "title": "",
  "variants": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "sku": "",
      "price": {
        "$numberDecimal": "0"
      },
      "stock": 0
    }
  ],
  "dimensions": {
    "width": 0,
    "height": 0
  },
  "labels": {
    "key": ""
  },
  "created_at": "1970-01-01T00:00:00.000Z",
  "__v": 0
}

variants: [variantSchema] হলো subdocument-এর array, তাই প্রতিটি আইটেম _id পায়, অন্যদিকে __v থাকে শুধু top level-এ। dimensions-এ কোনো type নেই, তাই এটি _id ছাড়া nested path, আর Decimal128 তার toJSON() রূপ $numberDecimal হিসেবে দেখায়। Timestamps অপশন ফিল্ডের নাম বদলে created_at করে এবং updatedAt বন্ধ রাখে, ফলে একটিমাত্র তারিখের ফিল্ড থাকে।

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

  • রুট ডকুমেন্ট _id আর __v পায়, versionKey: "rev" দিয়ে নাম বদলানো বা false মেনে।
  • [subSchema] বা [{ name: String }]-এর মতো array subdocument _id পায়, যদি না schema { _id: false } সেট করে।
  • type ছাড়া nested অবজেক্ট (address: { city: String }) _id ছাড়া সাধারণ অবজেক্টই থাকে।
  • enum array তার প্রথম ভ্যালু দেয়, { type: Map, of: String } দেয় {"key": ""}, আর Schema.Types.Mixed দেয় null।
  • Schema.Types.ObjectId একটি নমুনা ObjectId স্ট্রিং হয় আর Decimal128 হয় {"$numberDecimal": "0"}।
  • timestamps: true ছাড়াও { createdAt: "created_at", updatedAt: false }-এর মতো বিস্তারিত সেটিং পড়া হয়।
  • Schema-গুলোর মধ্যে চক্রাকার reference null দিয়ে কেটে দেওয়া হয়।

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

সবসময় নির্ভুল থাকা কালেকশন ডকুমেন্টেশন

README বা wiki-তে প্রতিটি কালেকশনের উদাহরণ ডকুমেন্ট দেখালে, সেটি schema ফাইল থেকে তৈরি করলে ডকুমেন্টেশন কোড থেকে সরে যায় না।

Subdocument-এর `_id` খুঁজে বের করা

ফ্রন্টএন্ড প্রায়ই array আইটেম তুলনা করে না বুঝেই যে প্রতিটির নিজস্ব _id আছে। আউটপুট স্পষ্ট করে দেয় কোন স্তরে _id আসে।

Populate-এর আগের response ব্যাখ্যা করা

ref থাকা ফিল্ড populate না হওয়া পর্যন্ত সাধারণ ObjectId স্ট্রিং। populate()-এর পরে response কীভাবে বদলায় তা বোঝানোর সময় আউটপুটটিকে ভিত্তি হিসেবে ব্যবহার করুন।

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

  • Literal default ("active", 0, true) নমুনা ভ্যালু হিসেবে ব্যবহৃত হয়। Date.now-এর মতো ফাংশন default চালানো হয় না, তাই সেই ফিল্ডগুলো type-এর placeholder পায়।
  • ref থাকা ফিল্ড populate করা অবজেক্ট না হয়ে ObjectId স্ট্রিং থাকে।
  • ফিল্ডের ভ্যালু হিসেবে লেখা inline new Schema({...}, { _id: false }) যথাস্থানে কনভার্ট হয় এবং নিজের অপশন মানে; এটি আলাদা রুট এন্ট্রি হিসেবে দেখায় না।
  • Virtual, toJSON transform, getter আর select: false প্রয়োগ হয় না।

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

Decimal128 ফিল্ড কেন অবজেক্ট হিসেবে আসে?

Mongoose-এর Decimal128 toJSON()-এর মাধ্যমে {"$numberDecimal": "12.50"} হিসেবে serialize হয়। আপনি এটি সংখ্যা বা স্ট্রিং হিসেবে পাঠালে schema-তে একটি getter বা transform যোগ করে আউটপুটও সেই অনুযায়ী এডিট করুন।

এখানে কি TypeScript বা NestJS schema পেস্ট করা যায়?

@Schema() ক্লাস আর interface Mongoose (TS) থেকে JSON পেজে কনভার্ট করুন। এই পেজ new Schema()-এ দেওয়া JavaScript অবজেক্ট parse করে।

ফাইলে শুধু mongoose.model() থাকলে আর schema অন্য কোথাও থাকলে কী হবে?

Schema ডেফিনিশন ইনপুটে থাকতেই হবে। এর সাথে new Schema(...) অংশটিও পেস্ট করুন।