JSON کو Mongoose (JavaScript) منصوبے میں تبدیل کریں!

JSON درج کریں اور اسے Mongoose (JavaScript) منصوبے میں تبدیل کریں! Mongoose new Schema, mongoose.model, MongoDB, Node.js سپورٹ۔
JSON
نتیجہ
 

JSON کو Mongoose (JavaScript) منصوبے میں تبدیل کریں!

وہ document پیسٹ کریں جو آپ MongoDB میں محفوظ کرنا چاہتے ہیں اور CommonJS والی Mongoose schema فائل حاصل کریں: new Schema({...}) سے بیان کیے گئے فیلڈز، mongoose.model() سے رجسٹر شدہ ماڈل، اور آخر میں module.exports۔ اسے Express پروجیکٹ کے models/ فولڈر میں محفوظ کریں اور جوں کا توں require کریں۔

فیلڈ paths، JSON keys کو بالکل ویسا ہی رکھتے ہیں، اس لیے schema کچھ بھی rename کیے بغیر collection میں پہلے سے موجود documents پڑھ لیتا ہے۔ documents کی array پیسٹ کرنے پر سب کی keys ایک schema میں ضم ہو جاتی ہیں۔

استعمال کا طریقہ

  1. ایک document (آبجیکٹ) یا کئی (array) پیسٹ کریں۔ array میں لپٹا mongoexport کا آؤٹ پٹ بھی چلتا ہے۔
  2. ماڈل کا نام لکھیں (ڈیفالٹ MyModel)۔ spaces ٹھیک ہیں: blog comment بنتا ہے BlogComment۔
  3. نتیجے کو models/Comment.js جیسی فائل کے طور پر محفوظ کریں اور router میں const Comment = require('./models/Comment') سے لوڈ کریں۔

مثال

ان پٹ (JSON)
[
  { "author": "mina", "body": "Great post!", "likes": 3, "approved": true, "posted_at": "2024-05-01T09:30:00Z" },
  { "author": "leo", "body": "Typo in step 2", "likes": 0, "approved": false, "posted_at": "2024-05-02T11:00:00Z", "reply_to": "6634a1" }
]
آؤٹ پٹ (Mongoose (JavaScript))
const mongoose = require('mongoose');
const { Schema } = mongoose;

const commentSchema = new Schema({
  _id: { type: Schema.Types.ObjectId, auto: true },
  author: { type: Schema.Types.String, required: true },
  body: { type: Schema.Types.String, required: true },
  likes: { type: Schema.Types.Number, required: true },
  approved: { type: Schema.Types.Boolean, required: true },
  posted_at: { type: Schema.Types.Date, required: true },
  reply_to: { type: Schema.Types.String }
});

const Comment = mongoose.model('Comment', commentSchema);

module.exports = Comment;

reply_to صرف دوسرے comment میں ہے، اس لیے یہ required کے بغیر بنتا ہے، اور ISO تاریخ والی string posted_at بنتی ہے Schema.Types.Date۔ دونوں اپنے snake_case نام رکھتے ہیں کیونکہ schema paths کو محفوظ keys سے میل کھانا ضروری ہے۔

معاون خصوصیات

  • فیلڈ types: نمبر → Schema.Types.Number، true/false → Schema.Types.Boolean، 2024-05-01 یا 2024-05-01T09:30:00Z جیسی ISO 8601 strings → Schema.Types.Date، باقی strings → Schema.Types.String۔
  • "01234" جیسے quotes والے ہندسے String رہتے ہیں، اس لیے postal codes اور فون نمبرز اپنے شروع کے صفر برقرار رکھتے ہیں۔
  • nested objects بنتے ہیں Schema.Types.Mixed؛ ایک ہی قسم کی سادہ values کی array [Schema.Types.String] جیسی typed array بنتی ہے، باقی سب [Schema.Types.Mixed]۔
  • required: true صرف تب شامل ہوتا ہے جب ہر document میں غیر خالی value ہو۔ arrays کو یہ کبھی نہیں ملتا، کیونکہ Mongoose غائب array کو [] سے بھر دیتا ہے۔
  • export سے کاپی ہونے والی _id key ہٹا دی جاتی ہے؛ اس کی جگہ schema میں _id: { type: Schema.Types.ObjectId, auto: true } ڈکلیئر ہوتا ہے۔
  • جو keys درست JavaScript identifiers نہیں، جیسے home-url، انہیں quotes والی keys کی صورت میں لکھا جاتا ہے۔

استعمال کے کیس

Express + MongoDB API کی پہلی ماڈل فائل

اگر آپ فرنٹ اینڈ کے ساتھ request body پر پہلے ہی اتفاق کر چکے ہیں تو اس JSON کو schema ڈرافٹ میں بدلیں اور اسے سیدھا اپنے POST route میں Comment.create(req.body) سے جوڑ دیں۔

بغیر schema کے بڑھنے والی collection کی صفائی

strict: false یا native driver سے بھری گئی collection سے چند documents نکالیں۔ کون سے فیلڈز ہمیشہ موجود ہیں اور کون سے کبھی کبھار، یہ فوراً required کی موجودگی یا غیر موجودگی سے ظاہر ہو جاتا ہے۔

نوٹس اور حدود

  • ماڈل mongoose.model('Comment', ...) کے طور پر رجسٹر ہوتا ہے، اور Mongoose collection چننے کے لیے اس نام کو چھوٹا اور جمع کر دیتا ہے: comments۔ اگر آپ کی موجودہ collection کا نام کچھ اور ہے تو تیسرا argument دیں۔
  • Mixed فیلڈز میں اپنی جگہ ہونے والی تبدیلیاں track نہیں ہوتیں؛ nested value ایڈٹ کرنے کے بعد save() سے پہلے doc.markModified('profile') کال کریں، یا فیلڈ کو sub-schema سے بدل دیں۔
  • کوئی defaults، indexes یا unique constraints نہیں بنتے۔ جن فیلڈز سے آپ تلاش کرتے ہیں ان پر unique: true یا index: true لگائیں۔

عام سوالات

کیا مجھے ES module syntax (import / export default) مل سکتا ہے؟

یہ صفحہ صرف require اور module.exports والا CommonJS بناتا ہے۔ "type": "module" والے پروجیکٹ میں پہلی دو لائنیں import mongoose, { Schema } from 'mongoose' اور آخری لائن export default Comment کر دیں۔ TypeScript یا NestJS کے لیے اس کے بجائے JSON → Mongoose (TS) صفحہ استعمال کریں۔

خودکار createdAt اور updatedAt کیسے حاصل کروں؟

بنائے گئے کوڈ میں کوئی schema options نہیں۔ دوسرا argument new Schema({...}, { timestamps: true }) شامل کریں اور Mongoose دونوں فیلڈز سنبھالے گا؛ آپ کے JSON سے آئے انہی ناموں والے فیلڈز ہٹا دیں۔

اگر میں required فیلڈ میں خالی string محفوظ کروں تو کیا ہوگا؟

strings کے لیے Mongoose کا required validator، "" کو غائب مانتا ہے۔ اسی لیے جو فیلڈز آپ کے نمونے میں خالی strings تھے وہ شروع ہی سے required کے بغیر بنتے ہیں۔