تحويل JSON إلى Mongoose (JavaScript) Schema!

أدخل JSON وحوله إلى Mongoose (JavaScript) Schema! يدعم Mongoose new Schema, mongoose.model, MongoDB, Node.js.
JSON
النتيجة
 

تحويل JSON إلى Mongoose (JavaScript) Schema!

الصق مستندًا تخطط لتخزينه في MongoDB لتحصل على ملف مخطط Mongoose بصيغة CommonJS: حقول معرَّفة بـ new Schema({...})، ونموذج مسجَّل بـ mongoose.model()، وmodule.exports في النهاية. احفظه في مجلد models/ في مشروع Express واستدعه بـ require كما هو.

تحتفظ مسارات الحقول بمفاتيح JSON كما هي تمامًا، فيقرأ المخطط المستندات الموجودة أصلًا في المجموعة (collection) دون إعادة تسمية أي شيء. وعندما تلصق مصفوفة مستندات، تُدمج مفاتيحها كلها في مخطط واحد.

طريقة الاستخدام

  1. الصق مستندًا واحدًا (كائنًا) أو عدة مستندات (مصفوفة). ناتج mongoexport المغلَّف في مصفوفة يعمل أيضًا.
  2. أدخل اسم النموذج (الافتراضي MyModel). المسافات لا بأس بها: 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 موجود في التعليق الثاني فقط، فيُولَّد دون required، وposted_at، وهو سلسلة تاريخ ISO، يصبح Schema.Types.Date. ويحتفظ كلاهما باسمه بصيغة snake_case لأن مسارات المخطط يجب أن تطابق المفاتيح المخزنة.

الميزات المدعومة

  • أنواع الحقول: الأرقام → Schema.Types.Number، وtrue/false → Schema.Types.Boolean، وسلاسل ISO 8601 مثل 2024-05-01 أو 2024-05-01T09:30:00Z → Schema.Types.Date، والسلاسل الأخرى → Schema.Types.String.
  • الأرقام المقتبسة مثل "01234" تبقى String، فتحتفظ الرموز البريدية وأرقام الهواتف بأصفارها في البداية.
  • تصبح الكائنات المتداخلة Schema.Types.Mixed؛ ومصفوفة القيم البسيطة من نوع واحد تصبح مصفوفة ذات نوع مثل [Schema.Types.String]، وأي شيء آخر [Schema.Types.Mixed].
  • لا يُضاف required: true إلا حين يكون لكل مستند قيمة غير فارغة. ولا تحصل عليه المصفوفات أبدًا، لأن Mongoose يملأ المصفوفة الغائبة بـ [].
  • يُحذف مفتاح _id المنسوخ من ملف تصدير؛ ويعرّف المخطط بدلًا منه _id: { type: Schema.Types.ObjectId, auto: true }.
  • المفاتيح التي ليست معرّفات JavaScript صالحة، مثل home-url، تُكتب كمفاتيح مقتبسة.

حالات الاستخدام

أول ملف نموذج في API مبني بـ Express + MongoDB

إن كنت قد اتفقت مسبقًا مع الواجهة الأمامية على جسم الطلب، فحوّل ذلك الـ JSON إلى مسودة مخطط واربطه مباشرة بـ Comment.create(req.body) في مسار POST.

ترتيب مجموعة نمت دون مخطط

اسحب بضعة مستندات من مجموعة مُلئت بـ strict: false أو بالـ driver الأصلي. أي الحقول موجودة دائمًا وأيها يظهر أحيانًا فقط يتضح فورًا من وجود required أو غيابه.

ملاحظات وقيود

  • يُسجَّل النموذج بالشكل mongoose.model('Comment', ...)، ويحوّل Mongoose ذلك الاسم إلى أحرف صغيرة وصيغة الجمع ليختار المجموعة: comments. مرّر معاملًا ثالثًا إن كانت مجموعتك الحالية تستخدم اسمًا آخر.
  • لا تُتتبَّع التغييرات الموضعية في حقول Mixed؛ بعد تعديل قيمة متداخلة استدعِ doc.markModified('profile') قبل save()، أو استبدل الحقل بمخطط فرعي.
  • لا تُولَّد قيم افتراضية ولا فهارس ولا قيود unique. أضف unique: true أو index: true إلى الحقول التي تبحث بها.

الأسئلة الشائعة

هل يمكنني الحصول على صيغة ES modules (import / export default)؟

هذه الصفحة تُنتج CommonJS فقط مع require وmodule.exports. في مشروع "type": "module"، غيّر السطرين الأولين إلى import mongoose, { Schema } from 'mongoose' والسطر الأخير إلى export default Comment. ولـ TypeScript أو NestJS استخدم صفحة JSON → Mongoose (TS) بدلًا من ذلك.

كيف أحصل على createdAt وupdatedAt تلقائيًا؟

الكود المولَّد لا يحوي خيارات للمخطط. أضف معاملًا ثانيًا، new Schema({...}, { timestamps: true })، فيتولى Mongoose الحقلين؛ واحذف الحقول التي تحمل الأسماء نفسها والقادمة من JSON الخاص بك.

ماذا يحدث إذا حفظت سلسلة فارغة في حقل required؟

مدقق required في Mongoose يعامل "" في السلاسل النصية كقيمة غائبة. ولهذا تُولَّد الحقول التي كانت سلاسل فارغة في عيّنتك دون required أصلًا.