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 পায় না।
Mongoose (JS) বক্সে schema ফাইলটি পেস্ট করুন। Sub-schema আলাদা ভেরিয়েবলে থাকলে সেগুলোর ডেফিনিশনও একই ইনপুটে দিন।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 } }
);{
"_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 }-এর মতো বিস্তারিত সেটিং পড়া হয়।null দিয়ে কেটে দেওয়া হয়।README বা wiki-তে প্রতিটি কালেকশনের উদাহরণ ডকুমেন্ট দেখালে, সেটি schema ফাইল থেকে তৈরি করলে ডকুমেন্টেশন কোড থেকে সরে যায় না।
ফ্রন্টএন্ড প্রায়ই array আইটেম তুলনা করে না বুঝেই যে প্রতিটির নিজস্ব _id আছে। আউটপুট স্পষ্ট করে দেয় কোন স্তরে _id আসে।
ref থাকা ফিল্ড populate না হওয়া পর্যন্ত সাধারণ ObjectId স্ট্রিং। populate()-এর পরে response কীভাবে বদলায় তা বোঝানোর সময় আউটপুটটিকে ভিত্তি হিসেবে ব্যবহার করুন।
default ("active", 0, true) নমুনা ভ্যালু হিসেবে ব্যবহৃত হয়। Date.now-এর মতো ফাংশন default চালানো হয় না, তাই সেই ফিল্ডগুলো type-এর placeholder পায়।ref থাকা ফিল্ড populate করা অবজেক্ট না হয়ে ObjectId স্ট্রিং থাকে।new Schema({...}, { _id: false }) যথাস্থানে কনভার্ট হয় এবং নিজের অপশন মানে; এটি আলাদা রুট এন্ট্রি হিসেবে দেখায় না।toJSON transform, getter আর select: false প্রয়োগ হয় না।Mongoose-এর Decimal128 toJSON()-এর মাধ্যমে {"$numberDecimal": "12.50"} হিসেবে serialize হয়। আপনি এটি সংখ্যা বা স্ট্রিং হিসেবে পাঠালে schema-তে একটি getter বা transform যোগ করে আউটপুটও সেই অনুযায়ী এডিট করুন।
@Schema() ক্লাস আর interface Mongoose (TS) থেকে JSON পেজে কনভার্ট করুন। এই পেজ new Schema()-এ দেওয়া JavaScript অবজেক্ট parse করে।
mongoose.model() থাকলে আর schema অন্য কোথাও থাকলে কী হবে?Schema ডেফিনিশন ইনপুটে থাকতেই হবে। এর সাথে new Schema(...) অংশটিও পেস্ট করুন।