Passa al contenuto principale

JC2.1 - Dal browser al servizio giusto

In una frase. Come fa una richiesta partita dalla tua pagina ad arrivare proprio al servizio che la sa soddisfare, e a tornare con la risposta.

Ogni volta che apri una tabella, premi Salva o chiedi una stampa, la pagina manda una richiesta. Le richieste sono tante e i servizi sono diversi. Il Gateway le smista tutte con una regola sola, semplice da controllare: guarda come comincia l'indirizzo.

Il viaggio di una richiesta: dalla pagina al Gateway, al servizio, e ritorno

Il viaggio di una richiesta: dalla pagina al Gateway, al servizio, e ritorno

Il viaggio, in ordine.

La pagina chiede. La richiesta parte dal browser e porta con sé il tuo lasciapassare, cioè la prova che sei entrato.

Il Gateway controlla. Se il lasciapassare manca o non è valido, il viaggio finisce qui. Come lo controlla è in Come si controlla chi sei.

Il Gateway legge l'inizio dell'indirizzo. Ogni servizio ha il suo:

L'indirizzo comincia con La richiesta va a Per fare cosa
/api/ade ADEnext Schermate disegnate, cruscotti di Analytics
/api/sigea SIGEAnext Dati del gestionale
/api/gpe GPEnext Stampe e modelli
/api/sigeagent Assistente dei dati Domande sui dati (solo dove è acceso)

Chiede al Monitor servizi dove sta quel servizio. Il Gateway conosce il nome del servizio, non il suo indirizzo. L'indirizzo lo prende dall'elenco.

Inoltra. Toglie dall'indirizzo il pezzo iniziale, che serviva solo a lui, scrive sulla richiesta il tuo nome utente e la consegna.

La risposta torna dalla stessa strada. Il servizio risponde al Gateway, il Gateway alla pagina.

Per chi sviluppa.
• Le rotte sono in backend/middleware/it_gsba_api_gateway/src/main/java/it/gsba/api_gateway/config/GatewayConfig.java. Ognuna ha stripPrefix(2) e il filtro AuthenticationFilter.
• La destinazione è lb://NOME-DEL-SERVIZIO: il nome con cui il servizio si è iscritto al Monitor servizi.
• L'Assistente dei dati fa eccezione: ha un indirizzo fisso e la sua rotta esiste solo con SIGEAGENT_ENABLED=true.
• Davanti al Gateway c'è il server web dell'app (frontend/docker/nginx.conf), che gli passa tutto ciò che comincia per /api/. Le richieste lunghe possono durare fino a dieci minuti.