JC4.1 - Aggiungere una rotta
In una frase. Per far arrivare le richieste a un servizio nuovo basta una rotta nel Gateway: gli altri servizi non si toccano.
Una rotta è una riga che dice: le richieste che cominciano così vanno a quel servizio. Stanno tutte in una classe sola, quindi chi vuole sapere cosa è raggiungibile da fuori guarda in un posto solo. Aggiungerne una vuol dire copiare quelle che ci sono.
Dai un nome al servizio. È il nome con cui si iscrive al Monitor servizi: tutto maiuscolo, con i trattini, per esempio
NUOVO-SERVICE. Sta inspring.application.namedel servizio.Aggiungi la rotta nel Gateway. Apri
GatewayConfige copia una rotta esistente. Cambiano tre cose: il nome della rotta (nuovo-service), l'inizio dell'indirizzo (/api/nuovo/**) e la destinazione (lb://NUOVO-SERVICE). Restano ugualistripPrefix(2)e il filtroauthenticationFilter: vanno messi sempre.Nel servizio non ripetere l'inizio dell'indirizzo. Il Gateway toglie
/api/nuovoprima di inoltrare. Se la pagina chiama/api/nuovo/clienti, il servizio riceve/clienti.Fai controllare il lasciapassare anche al servizio. Prendi come modello la
SecurityConfigdi un servizio esistente. Il nome utente lo leggi dall'intestazioneX-User-Id, che scrive il Gateway.Ricostruisci e riavvia solo il Gateway. I servizi già accesi non vanno fermati.
Prova. Chiama
/api/nuovo/...dall'app. Un 503 vuol dire che il servizio non è ancora iscritto al Monitor servizi. Un 404 vuol dire che la rotta c'è ma il servizio non ha quell'indirizzo.Aggiorna la tabella delle rotte in
docs/architettura/riferimento/ARCHITETTURA-MICROSERVIZI.md.
Il server web dell'app non va toccato: manda già al Gateway tutto ciò che comincia per /api/. Serve una regola in più solo per i collegamenti che restano aperti a lungo.
Attenzione.
• Con un numero diverso da 2 in stripPrefix il servizio riceve indirizzi sbagliati.
• Senza authenticationFilter il servizio non riceve il nome utente, e chi chiama potrebbe scriverne uno a piacere.
• Un servizio raggiungibile senza passare dal Gateway non può fidarsi di X-User-Id.
Per chi sviluppa.
• File: backend/middleware/it_gsba_api_gateway/src/main/java/it/gsba/api_gateway/config/GatewayConfig.java.
• Verifica: nella cartella del Gateway ./mvnw -o clean package -DskipTests, vale solo BUILD SUCCESS.
• Anche in sviluppo l'app manda già al Gateway tutto ciò che comincia per /api.
• Prima di cambiare le regole di sicurezza del Gateway si dice cosa cambia e perché: una modifica piccola può spegnere i controlli.