Bumuo ng halimbawang document JSON mula sa isang JavaScript Mongoose schema na dine-define gamit ang new Schema({...}). Dahil mismong schema definition object ang pina-parse, sinusundan ang mga option gaya ng { type: String, enum: [...] } o { type: Map, of: Number } at ang mga reference sa ibang schema variable.
Nakakatulong ito sa pagdodokumento ng mga collection sa likod ng isang Express + Mongoose API, o sa pagpapaliwanag sa frontend kung ano ang itsura ng isang document. Nadadala ang mga rule na partikular sa Mongoose, gaya ng pagkakaroon ng _id ng mga array subdocument habang wala nito ang mga nested path.
Mongoose (JS) box. Kung nasa magkakahiwalay na variable ang mga sub-schema, isama ang mga definition nila sa parehong input.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
}Array ng mga subdocument ang variants: [variantSchema], kaya may _id ang bawat item, habang nasa top level lang ang __v. Walang type ang dimensions, kaya nested path ito na walang _id, at lumalabas ang Decimal128 sa anyong toJSON() nito, $numberDecimal. Pinapalitan ng timestamps option ang pangalan ng field sa created_at at dina-disable ang updatedAt, kaya iisang date field ang natitira.
_id at __v ang root document, at sinusunod ang pagpapalit ng pangalan gamit ang versionKey: "rev" o ang false._id ang mga array subdocument gaya ng [subSchema] o [{ name: String }], maliban kung nag-set ang schema ng { _id: false }._id ang mga nested object na walang type (address: { city: String }).enum array ang una nilang value, {"key": ""} ang mula sa { type: Map, of: String }, at null ang mula sa Schema.Types.Mixed.Schema.Types.ObjectId at nagiging {"$numberDecimal": "0"} ang Decimal128.timestamps: true, binabasa rin ang mga detalyadong setting gaya ng { createdAt: "created_at", updatedAt: false }.null ang mga circular reference sa pagitan ng mga schema.Kapag nagpapakita ang isang README o wiki ng halimbawang document bawat collection, sa pag-generate nito mula sa schema file, hindi lumalayo ang docs sa code.
Madalas ikumpara ng mga frontend ang mga array item nang hindi napapansing may sariling _id ang bawat isa. Malinaw sa output kung saang level lumalabas ang _id.
Simpleng ObjectId string ang mga field na may ref hangga't hindi pa napo-populate. Gamitin ang output bilang baseline kapag inilalarawan kung paano nagbabago ang isang response pagkatapos ng populate().
default ("active", 0, true). Hindi pinapatakbo ang mga function default gaya ng Date.now, kaya placeholder ng type ang nakukuha ng mga field na iyon.ref sa halip na mga napopulate na object.new Schema({...}, { _id: false }) na isinulat bilang field value at sinusunod nito ang sarili nitong mga option; hindi ito lumalabas bilang hiwalay na root entry.toJSON transform, getter at select: false.Sine-serialize ang Decimal128 ng Mongoose sa pamamagitan ng toJSON() bilang {"$numberDecimal": "12.50"}. Kung ipinapadala mo ito bilang numero o string, magdagdag ng getter o transform sa schema at i-edit ang output para tumugma.
I-convert ang mga @Schema() class at interface sa page na Mongoose (TS) to JSON. Ang JavaScript object na ipinapasa sa new Schema() ang pina-parse ng page na ito.
mongoose.model() lang ang nasa file at nasa ibang lugar ang schema?Dapat nasa input ang schema definition. I-paste rin ang bahaging new Schema(...).