Esempio completo di server Node.js con Express, gestione errori centralizzata e risposte JSON per applicazioni scalabili e facili da mantenere.
javascript
// Importiamo il framework Express
const express = require('express');
// Creiamo un'app Express
const app = express();
// Middleware per parsare il corpo delle richieste in JSON
app.use(express.json());
// Endpoint GET semplice che risponde con un messaggio JSON
app.get('/api/saluto', (req, res) => {
res.json({ messaggio: 'Benvenuto nel server Express!' });
});
// Endpoint POST che accetta dati JSON e valida il campo 'nome'
app.post('/api/dati', (req, res, next) => {
const { nome } = req.body;
// Controllo di validazione semplice
if (!nome || typeof nome !== 'string') {
// Creiamo un errore e lo passiamo al middleware di gestione errori
const err = new Error('Il campo "nome" è obbligatorio e deve essere una stringa.');
err.status = 400; // Bad Request
return next(err);
}
// Se tutto ok, rispondiamo con un messaggio personalizzato
res.json({ messaggio: `Ciao, ${nome}! Dati ricevuti correttamente.` });
});
// Middleware centrale per la gestione degli errori
app.use((err, req, res, next) => {
// Impostiamo lo status code, default 500
const statusCode = err.status || 500;
// Rispondiamo con JSON contenente il messaggio di errore
res.status(statusCode).json({ errore: err.message || 'Errore interno del server' });
});
// Avviamo il server sulla porta 3000
const PORT = 3000;
app.listen(PORT, () => {
console.log(`Server avviato sulla porta ${PORT}`);
});Node.js versione >=14
Express: framework web per Node.js, gestione routing e middleware
body-parser: middleware per parsare il corpo delle richieste in JSON (integrato in Express >=4.16, ma incluso per chiarezza)
Middleware personalizzato per gestione errori centralizzata
Endpoint GET /api/saluto che risponde con JSON
Endpoint POST /api/dati che accetta JSON e valida un campo 'nome'
Configurazione package.json con dipendenze express
Nessun hardware richiesto (esempio software puro)
Configurazione avvio server su porta 3000
Utilizzo di middleware express.json() per parsing JSON
Gestione errori con middleware finale che intercetta errori e risponde con JSON e codice HTTP appropriato