Defining models in Express

Introduction

Models help you organize and manage your data in an Express app. They act like blueprints for how data should look and behave.

When you want to store user information like names and emails.

When you need to save blog posts or articles with titles and content.

When you want to keep track of products in an online store.

When you need to validate data before saving it to a database.

When you want to easily update or retrieve data in a structured way.

Syntax

Express

const mongoose = require('mongoose');

const ModelNameSchema = new mongoose.Schema({
  fieldName: { type: DataType, required: true },
  anotherField: DataType
});

const ModelName = mongoose.model('ModelName', ModelNameSchema);

module.exports = ModelName;

Use mongoose.Schema to define the shape of your data.

mongoose.model creates a model you can use to work with the data.

Examples

This defines a User model with required name and email fields.

Express

const userSchema = new mongoose.Schema({
  name: { type: String, required: true },
  email: { type: String, required: true }
});

const User = mongoose.model('User', userSchema);

This defines a Product model with title and price fields, both optional.

Express

const productSchema = new mongoose.Schema({
  title: String,
  price: Number
});

const Product = mongoose.model('Product', productSchema);

Sample Program

This Express app connects to MongoDB, defines a User model, and provides routes to add and list users.

Express

const express = require('express');
const mongoose = require('mongoose');

// Connect to MongoDB
mongoose.connect('mongodb://localhost:27017/myapp', { useNewUrlParser: true, useUnifiedTopology: true });

// Define a simple User model
const userSchema = new mongoose.Schema({
  name: { type: String, required: true },
  email: { type: String, required: true }
});
const User = mongoose.model('User', userSchema);

const app = express();
app.use(express.json());

// Route to create a new user
app.post('/users', async (req, res) => {
  try {
    const user = new User(req.body);
    await user.save();
    res.status(201).send(user);
  } catch (error) {
    res.status(400).send(error.message);
  }
});

// Route to get all users
app.get('/users', async (req, res) => {
  const users = await User.find();
  res.send(users);
});

app.listen(3000, () => {
  console.log('Server running on http://localhost:3000');
});

Important Notes

Make sure MongoDB is running before starting your app.

Models help keep your data organized and consistent.

Use required: true to make sure important fields are filled.

Summary

Models define how your data looks and behaves in Express apps.

Use Mongoose schemas and models to create and manage data easily.

Models help validate data and connect your app to a database.

Practice

1. What is the main purpose of defining a model in an Express app using Mongoose?

easy

A. To style the app with CSS

B. To define the structure and rules for data stored in the database

C. To handle HTTP requests and responses

D. To create the user interface of the app

Solution

1. Step 1: Understand what a model represents

   A model defines how data is structured and validated in the database.

2. Step 2: Identify the role of models in Express apps

   Models help manage data and enforce rules before saving to the database.

3. Final Answer:

   To define the structure and rules for data stored in the database -> Option B

4. Quick Check:

   Model = Data structure and rules [OK]

Hint: Models define data shape and rules, not UI or styling [OK]

Common Mistakes:

• Confusing models with UI components
• Thinking models handle HTTP requests
• Assuming models style the app

2. Which of the following is the correct way to define a Mongoose model named Book with a schema having a title field of type String?

easy

A. const Book = mongoose.model('Book', new mongoose.Schema({ title: String }));

B. const Book = mongoose.schema('Book', { title: String });

C. const Book = mongoose.model('Book', { title: String });

D. const Book = new mongoose.model('Book', { title: String });

Solution

1. Step 1: Recall Mongoose model syntax

   Mongoose models require a schema object created with new mongoose.Schema().

2. Step 2: Check each option for correct usage

   const Book = mongoose.model('Book', new mongoose.Schema({ title: String })); correctly uses mongoose.model('Book', new mongoose.Schema({ title: String })). Others misuse schema or omit new mongoose.Schema().

3. Final Answer:

   const Book = mongoose.model('Book', new mongoose.Schema({ title: String })); -> Option A

4. Quick Check:

   Model needs new Schema() [OK]

Hint: Use new mongoose.Schema() inside mongoose.model() [OK]

Common Mistakes:

• Using mongoose.schema instead of new Schema()
• Passing plain object instead of Schema instance
• Using new keyword incorrectly with mongoose.model

3. Given the following code, what will console.log(book.title) output?

const mongoose = require('mongoose');
const { Schema } = mongoose;

const bookSchema = new Schema({ title: String });
const Book = mongoose.model('Book', bookSchema);

const book = new Book({ title: 'Express Guide' });
console.log(book.title);

medium

A. Error: book.title is not defined

B. undefined

C. 'Express Guide'

D. null

Solution

1. Step 1: Understand model instance creation

   Creating new Book({ title: 'Express Guide' }) sets the title property on the instance.

2. Step 2: Access the title property

   Logging book.title outputs the string 'Express Guide' as assigned.

3. Final Answer:

   'Express Guide' -> Option C

4. Quick Check:

   Instance property = 'Express Guide' [OK]

Hint: Instance properties match schema fields given at creation [OK]

Common Mistakes:

• Expecting undefined because of missing database save
• Confusing model with schema
• Thinking title is a method, not a property

4. Identify the error in this model definition code:

const mongoose = require('mongoose');
const bookSchema = mongoose.Schema({ title: String });
const Book = mongoose.model('Book', bookSchema);

const book = new Book({ title: 123 });

medium

A. Schema should be created with new Schema(), not mongoose.Schema()

B. Missing call to connect to the database before defining model

C. Model name 'Book' must be lowercase

D. The title field value should be a string, not a number

Solution

1. Step 1: Check schema field types and values

   The schema defines title as a String, but the instance is created with a number 123.

2. Step 2: Identify type mismatch error

   Mongoose expects a string for title, so passing a number is a validation error.

3. Final Answer:

   The title field value should be a string, not a number -> Option D

4. Quick Check:

   Schema type mismatch causes error [OK]

Hint: Match data types in schema and instance exactly [OK]

Common Mistakes:

• Ignoring type mismatch errors
• Thinking model names must be lowercase
• Confusing schema creation syntax

5. You want to define a Mongoose model User with fields name (string), age (number), and email (string, required). Which code correctly defines this model with validation?

hard

A. const userSchema = new mongoose.Schema({ name: String, age: Number, email: { type: String, required: true } }); const User = mongoose.model('User', userSchema);

B. const userSchema = new Schema({ name: String, age: Number, email: String, required: true }); const User = mongoose.model('User', userSchema);

C. const userSchema = new Schema({ name: String, age: Number, email: String }); const User = mongoose.model('User', userSchema, { required: ['email'] });

D. const userSchema = new Schema({ name: String, age: Number, email: { type: String } }); const User = mongoose.model('User', userSchema);

Solution

1. Step 1: Understand how to set required fields in schema

   Required fields must be defined inside the field object with required: true.

2. Step 2: Check each option for correct required syntax

   const userSchema = new mongoose.Schema({ name: String, age: Number, email: { type: String, required: true } }); const User = mongoose.model('User', userSchema); correctly sets email: { type: String, required: true }. Others either place required outside the field or omit it.

3. Final Answer:

   const userSchema = new mongoose.Schema({ name: String, age: Number, email: { type: String, required: true } }); const User = mongoose.model('User', userSchema); -> Option A

4. Quick Check:

   Required fields inside field object [OK]

Hint: Put required: true inside the field's object definition [OK]

Common Mistakes:

• Placing required outside the field object
• Omitting required for mandatory fields
• Misusing model options for validation