API per FilmLibrary con Express

Obiettivo

Realizzare il back-end di FilmLibrary esponendo una serie di API HTTP RESTful (CRUD) basate su Express 4 e SQLite.

Ogni endpoint deve:

• Validare l’ingresso id (interi), rating (0-5) e date (YYYY-MM-DD).
• Restituire codici di stato coerenti (200, 201, 404, 422, 503).
• Interagire in modalità asincrona con il DB, senza bloccare l’event-loop di Node.

Procedura/Spiegazione passo-passo

1. Preparazione ambiente

   npm install express sqlite3 express-validator dayjs
   

2. Creazione server e middleware

   • Express app, parser JSON e logging opzionale (morgan).
   • Attivazione di express.json() e di eventuale cors() solo in sviluppo.

3. Connessione SQLite (single connection)

   • new sqlite.Database('films.db', (err) => {...}); - apertura lazy, gestione errori.

4. Validatori riusabili (express-validator)

   • param('id').isInt({min: 1})
   • body('rating').optional().isInt({min: 0, max: 5})
   • body('watchDate').optional().isISO8601()

5. Routing

   • Rotte dichiarate con app.get/post/put/delete secondo tabella requisiti.
   • Uso di parametric path (/api/films/:id) per singola risorsa.

6. Accesso al DB

   • Query parametriche con ? per prevenire SQL-injection.
   • Promesse “wrap” attorno a db.all/get/run per sfruttare async/await.

7. Gestione errori

   • Se validator fallisce ⇒ 422 Unprocessable Entity.
   • Se rows.length === 0 ⇒ 404 Not Found.
   • Errori DB ⇒ 503 Service Unavailable.

Codice (estratto significativo)