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 in spring.application.name del servizio. Aggiungi la rotta nel Gateway. Apri GatewayConfig e 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 uguali stripPrefix(2) e il filtro authenticationFilter : vanno messi sempre. Nel servizio non ripetere l'inizio dell'indirizzo. Il Gateway toglie /api/nuovo prima di inoltrare. Se la pagina chiama /api/nuovo/clienti , il servizio riceve /clienti . Fai controllare il lasciapassare anche al servizio. Prendi come modello la SecurityConfig di un servizio esistente. Il nome utente lo leggi dall'intestazione X-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.