يحوّل JSON إلى صنف مخطط @nestjs/mongoose في NestJS: صنف @Schema() مع @Prop() على كل حقل، ومخطط مبني بـ SchemaFactory.createForClass()، ونوع ProductDocument، وكل ذلك في ملف واحد. ويحمل كل حقل أيضًا @IsNotEmpty() أو @IsOptional() من class-validator.
استخدمه حين تحتاج وحدة NestJS إلى مخطط تسجّله عبر MongooseModule.forFeature()، ولديك أصلًا عيّنة من المستند المراد تخزينه، وكتابة كل decorator يدويًا هي الجزء البطيء.
اسم النموذج (الافتراضي MyModel). كتابة product تُنتج Product وProductDocument وProductSchema.product.schema.ts وسجّلها بـ MongooseModule.forFeature([{ name: Product.name, schema: ProductSchema }]).{
"sku": "KB-87-RED",
"title": "Mechanical keyboard",
"price": 89.5,
"stock": 42,
"discontinued": false,
"restocked_at": "2024-03-18"
}import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
import { Document, Schema as MongooseSchema } from 'mongoose';
import { IsNotEmpty, IsOptional } from 'class-validator';
export type ProductDocument = Product & Document;
@Schema()
export class Product {
_id: MongooseSchema.Types.ObjectId;
@Prop({ type: MongooseSchema.Types.String, required: true })
@IsNotEmpty()
sku: string;
@Prop({ type: MongooseSchema.Types.String, required: true })
@IsNotEmpty()
title: string;
@Prop({ type: MongooseSchema.Types.Number, required: true })
@IsNotEmpty()
price: number;
@Prop({ type: MongooseSchema.Types.Number, required: true })
@IsNotEmpty()
stock: number;
@Prop({ type: MongooseSchema.Types.Boolean, required: true })
@IsNotEmpty()
discontinued: boolean;
@Prop({ type: MongooseSchema.Types.Date, required: true })
@IsNotEmpty()
restocked_at: Date;
}
export const ProductSchema = SchemaFactory.createForClass(Product);العيّنة مستند واحد مملوء بالكامل، لذا يحصل كل حقل على required: true و@IsNotEmpty(). وrestocked_at سلسلة بصيغة تاريخ، فنوعها Date، وتحتفظ الخاصية باسم المفتاح المخزَّن restocked_at.
@Prop({ type: MongooseSchema.Types.String, required: true }). ويُستورد Schema الخاص بـ Mongoose باسم MongooseSchema حتى لا يتعارض مع الـ decorator Schema.number وboolean وDate لسلاسل التاريخ بصيغة ISO 8601، وstring لكل ما عدا ذلك بما فيه السلاسل المكوّنة من أرقام فقط مثل "0042".MongooseSchema.Types.Mixed ونوعها Record<string, unknown>؛ ومصفوفات النوع البسيط الواحد تصبح مثلًا [MongooseSchema.Types.String] مع string[].'home-url': string)، فيطابق الصنف المستندات الموجودة أصلًا في المجموعة.required: true مع @IsNotEmpty()؛ والبقية تحصل على @IsOptional() فقط. ويُتخطى مفتاح _id في الإدخال لأن _id: MongooseSchema.Types.ObjectId مُعلن أصلًا.export type ProductDocument = Product & Document للحقن بالشكل @InjectModel(Product.name) model: Model<ProductDocument>.أدخل payload حدث أرسله إليك فريق آخر، أو JSON من أداة كشط (scraper)، لتحصل على صنف المخطط، ثم احقنه بـ @InjectModel واستدعِ create أو find فورًا.
صدّر بضعة مستندات حفظها النموذج القديم المبني بـ new Schema({...}) والصقها هنا لتعيد كتابته كصنف مبني على الـ decorators دون إسقاط حقول أثناء نسخها يدويًا.
@IsNotEmpty() و@IsOptional() على صنف المخطط، لكن ValidationPipe يتحقق من كائنات DTO في الـ controllers. للتحقق من الطلبات، انقل هذه الـ decorators إلى صنف DTO أو أنشئ واحدًا.@Schema()، لذا يتبع اسم المجموعة قاعدة Mongoose في تصغير اسم النموذج وجمعه: products. اضبط @Schema({ collection: 'product' }) إن احتجت إلى اسم محدد.? (مثل memo: string). مع strictNullChecks، تغييرها إلى memo?: string أكثر أمانًا.Mixed لا كمخططات ذات أنواع. للتحقق داخلها، عرّف صنف @Schema() منفصلًا واستخدم @Prop({ type: SubSchema }).& Document بدلًا من وراثة Document؟يتبع ذلك النمط الافتراضي في وثائق NestJS: يبقى صنف المخطط تعريفًا بسيطًا للحقول، ولا يُستخدم ProductDocument إلا حيث تلزم دوال مستندات Mongoose مثل save(). وفي Mongoose 7+ يمكن استخدام HydratedDocument<Product> بديلًا مباشرًا.
احذف السطر import { IsNotEmpty, IsOptional } from 'class-validator' والـ decoratorين على كل حقل. سلوك المخطط يتحكم فيه required داخل @Prop() وحده.
type في @Prop()؟مع emitDecoratorMetadata يمكن استنتاج الأنواع البسيطة، لكن الاستنتاج يفشل مع المصفوفات والاتحادات مثل Date | null. يذكر الكود المولَّد type صراحة حتى يبقى السلوك نفسه حين تغيّر لاحقًا نوع TypeScript لخاصية ما.