Esquemas, modelos y virtuals de Mongoose

Mongoose es un Object Document Mapper (ODM) para MongoDB y Node.js. Se sitúa sobre el controlador oficial de MongoDB y añade una capa de abstracción: esquemas para validar la estructura de los documentos, modelos para interactuar con la base de datos, hooks de middleware para la lógica previa y posterior a las operaciones y virtuals para los campos calculados. Mongoose es la biblioteca de MongoDB más popular del ecosistema de Node.js y resulta especialmente productiva para aplicaciones de servidor con modelos de datos bien definidos.

Un Schema de Mongoose define la estructura, los tipos y las restricciones de los documentos de una colección. Cada clave del esquema corresponde a un campo del documento. Puede especificar por campo el tipo, required, default, min, max, enum y muchas otras opciones de validación. Los esquemas son la única fuente de verdad de la estructura de sus documentos en una aplicación de Mongoose.

Mongoose admite un amplio conjunto de tipos de esquema. Los más comunes son String, Number, Date, Boolean, Buffer, mongoose.Schema.Types.ObjectId (para referencias), Array (indicado como [Type]) y Mixed (cualquier valor, sin comprobación de tipos). Mongoose también admite esquemas anidados (subdocumentos) al anidar la definición de un Schema dentro de la definición de campo de otro Schema.

Pasar { timestamps: true } como segundo argumento al constructor de Schema hace que Mongoose administre automáticamente los campos createdAt y updatedAt de cada documento. createdAt se establece una vez al insertar el documento y updatedAt se actualiza en cada guardado. No necesita establecer estos campos manualmente: Mongoose los gestiona de forma transparente. Esta es una práctica recomendada para todos los esquemas de producción.

Un Model es un constructor compilado a partir de un Schema. Proporciona la interfaz para consultar y escribir documentos en la colección. Llame a mongoose.model('ModelName', schema) para crear un modelo; el primer argumento es el nombre singular de la colección (Mongoose lo convierte automáticamente en plural: 'User' → colección 'users'). Los modelos deben crearse una sola vez y exportarse como módulos.

Cree una nueva instancia de documento mediante el constructor del modelo: new User({ name: '...', ... }). Esto crea un objeto de documento en memoria con validación, pero NO lo guarda en la base de datos. Llame a .save() en la instancia para persistirlo, o utilice la abreviatura estática User.create(), que combina ambos pasos. Mongoose valida el documento según el esquema antes de guardarlo y lanza un ValidationError si se infringen las restricciones.

Los virtuals son propiedades calculadas que no se almacenan en la base de datos, sino que se calculan a partir de otros campos del documento. Se comportan como campos de documento normales en el código de su aplicación, pero nunca se escriben en MongoDB. Algunos usos habituales son combinar firstName y lastName en un virtual fullName, calcular age a partir de un campo birthDate o crear una url pública a partir de un _id.

De forma predeterminada, los virtuals no se incluyen al convertir un documento a JSON (por ejemplo, al enviarlo en la respuesta de una API). Para incluirlos, establezca { toJSON: { virtuals: true } } en las opciones del esquema o llame explícitamente a doc.toJSON({ virtuals: true }). En aplicaciones de Express, res.json(doc) llama automáticamente a toJSON(), por lo que establecer toJSON: { virtuals: true } en el esquema es la forma más clara de incluirlos siempre.

Los esquemas de Mongoose admiten funciones de validación personalizadas para cada campo. La función de validación recibe el valor del campo y debe devolver true si es válido o false (o lanzar un error) si no lo es. También puede proporcionar un mensaje de error personalizado. Las validaciones personalizadas se ejecutan antes de .save() y pueden ser asíncronas, lo que resulta útil para comprobaciones de unicidad a nivel de base de datos que van más allá del índice unique.

Los esquemas admiten métodos de instancia (disponibles en cada documento) y métodos estáticos (llamados en la clase Model). Los métodos de instancia acceden a this para referirse al documento específico, por lo que son ideales para operaciones propias de un documento, como comparar contraseñas o dar formato a la salida. Los métodos estáticos resultan útiles para consultas comunes o funciones de fábrica que no operan sobre una instancia específica.

Mongoose distingue entre subdocumentos incrustados (definidos como un array de esquemas) y objetos de esquema anidados (una definición de esquema simple dentro de un campo). Cada subdocumento de un array recibe su propio _id y puede manipularse como un documento individual mediante doc.items.id(subId). Los objetos anidados comparten el ciclo de vida del documento principal. Use subdocumentos en arrays para colecciones ordenadas de registros (líneas de pedido, comentarios). Use objetos anidados para estructuras incrustadas uno a uno (dirección, metadatos).

En esta lección ha aprendido que: los esquemas de Mongoose definen la estructura de los documentos, los tipos y las reglas de validación; los modelos se compilan a partir de esquemas y proporcionan la interfaz de consulta y escritura (Model.find(), new Model(), etc.); y los virtuals son propiedades calculadas que existen en memoria, pero nunca se almacenan en MongoDB; resultan útiles para campos derivados como fullName o url. A continuación exploraremos la API de consultas de Mongoose, incluido el encadenamiento, .lean() y la comparación con el driver nativo.