Models & Schemas

Wat is een Schema en Model?

Waarom handig?

Zonder schema:

• Workout zonder titel → geaccepteerd
• "appel" bij reps → geaccepteerd
• App crasht door foute data

Met schema:

• Title vergeten → Error: "Title required"
• "appel" bij reps → Error: "Must be number"
• Data is altijd correct!

Workout Schema Maken

Schema voor workouts: titel, herhalingen (reps), gewicht (load).

Maak model bestand

Nieuw bestand in src/models/:

src/models/Workout.js

Model begint met hoofdletter!

Schrijf code:

// src/models/Workout.js
import mongoose from 'mongoose';

const Schema = mongoose.Schema;

// Schema = regels voor workout
const workoutSchema = new Schema({
  title: {
    type: String,
    required: true
  },
  reps: {
    type: Number,
    required: true
  },
  load: {
    type: Number,
    required: true
  }
}, {
  timestamps: true
});

// Model = object voor maken/ophalen/aanpassen/verwijderen
const Workout = mongoose.model('Workout', workoutSchema);

export default Workout;

Workout zonder titel?

Automatisch error:

Validation failed: title: Path `title` is required.

Mongoose checkt het voor je!

Extra validatie (optioneel)

Extra regels toevoegen:

title: {
  type: String,
  required: true,
  trim: true,        // Verwijdert spaties
  maxlength: 100     // Max 100 tekens
},
reps: {
  type: Number,
  required: true,
  min: 1             // Min 1 (geen 0 of negatief)
}

Basis versie hierboven werkt prima!

Wat doet timestamps?

Mongoose voegt 2 velden toe:

• createdAt - Wanneer aangemaakt?
• updatedAt - Wanneer aangepast?

Voorbeeld:

{
  "_id": "...",
  "title": "Squats",
  "reps": 15,
  "load": 50,
  "createdAt": "2024-11-25T10:00:00.000Z",
  "updatedAt": "2024-11-27T14:30:00.000Z"
}

Model in Routes Gebruiken

Model is klaar, gebruik in routes om data op te slaan/ophalen.

Stap 1: Importeer model

Bovenaan src/routes/workoutRoutes.js:

import Workout from '../models/Workout.js';

Stap 2: Vervang dummy POST

Vervang door echte database code:

// POST nieuwe workout
router.post('/', async (req, res) => {
  const { title, load, reps } = req.body;

  try {
    const workout = await Workout.create({ title, reps, load });
    res.status(201).json(workout);
  } catch (error) {
    res.status(400).json({ error: error.message });
  }
});

Waarom async en await?

Database operaties zijn langzaam. Duurt even voordat MongoDB opslaat.

Zonder await (FOUT):

// NIET DOEN!
router.post('/', (req, res) => {
  const workout = Workout.create({ title, reps, load }); 
  res.json(workout); // TE SNEL!
  // workout is undefined hier!
});

Met await (GOED):

// WEL DOEN!
router.post('/', async (req, res) => {
  const workout = await Workout.create({ title, reps, load }); 
  res.json(workout); // Nu écht opgeslagen!
});

Waarom try/catch?

Wat als fout? Iemand vergeet veld of database is offline. Met try/catch vang je error op.

Zonder try/catch crasht server bij elke fout!

Zie de CRUD — Mongoose op de collection

Je hebt nu gezien hoe je een model gebruikt. Maar wat doet elke methode eigenlijk met de collection? Klik op een knop en zie de operatie live op de workouts-collection rechts.

Testen met Postman

POST route slaat data op. Maar hoe testen?

Postman is programma waarmee je ALLE requests test (GET, POST, PATCH, DELETE). Je kunt JSON data meesturen.

Postman installeren

1. Ga naar postman.com/downloads
2. Download en installeer
3. Open Postman (klik "Skip and go to app")

POST Request Testen

Test of je workout kunt toevoegen.

Stap 1: Nieuwe request

• Klik "New" of "+" voor nieuwe tab
• Selecteer POST
• URL: http://localhost:4000/api/workouts

Stap 2: Body instellen

• Klik tab "Body"
• Selecteer "raw"
• Kies "JSON" uit dropdown

Stap 3: JSON data

{
  "title": "Squats",
  "reps": 10,
  "load": 50
}

Stap 4: Versturen

Klik "Send" en kijk naar antwoord.

{
  "_id": "6543e8f2d1a2c3b4e5f67890",
  "title": "Squats",
  "reps": 10,
  "load": 50,
  "createdAt": "2024-11-22T12:30:00.000Z",
  "updatedAt": "2024-11-22T12:30:00.000Z",
  "__v": 0
}

GET Request Testen

Check of workout écht is opgeslagen.

In Postman:

• Nieuwe tab (klik "+")
• Methode GET
• URL: http://localhost:4000/api/workouts
• Klik Send

Je ziet array met workouts:

[
  {
    "_id": "6543e8f2d1a2c3b4e5f67890",
    "title": "Squats",
    "reps": 10,
    "load": 50,
    "createdAt": "2024-11-22T12:30:00.000Z",
    "updatedAt": "2024-11-22T12:30:00.000Z"
  }
]

In MongoDB Atlas:

Bekijk data visueel:

1. Ga naar MongoDB Atlas
2. Klik "Database"
3. Klik "Browse Collections"
4. Zie workout-db → workouts → je data!

Problemen oplossen

❌ "Validation failed: title required"

{
  "title": "Squats",
  "reps": 10,
  "load": 50
}

❌ "Cannot find module Workout.js"

❌ Status 500 Internal Server Error

❌ Geen data in Postman na POST

💡 Wat is __v veld?

Version number van Mongoose. Houdt bij hoeveel keer document is gewijzigd. Gewoon negeren!

Checklist

Samenvatting

Je hebt:

1. Schema gemaakt (title, reps, load)
2. Model gemaakt voor opslaan/ophalen
3. POST route aangepast voor echte database
4. Postman geïnstalleerd
5. Eerste workout opgeslagen!

Volgende Stap

Model klaar en POST werkt! Nu maken we alle CREATE en READ routes compleet.

CREATE & READ Controllers →

Maak alle routes voor data ophalen en opslaan