Passa al contenuto principale

JC2.3 - Le due strade: Gateway e Ponte col COBOL

In una frase. Le pagine nuove passano dal Gateway, le maschere storiche dal Ponte col COBOL: la strada la sceglie l'app, non tu.

L'app web è una sola, ma dentro ha due parti. Le pagine nuove parlano con i servizi nuovi: fanno una domanda, ricevono una risposta, fine. Le pagine storiche di SBHweb parlano con il programma COBOL, che ragiona in un altro modo: tiene aperta una conversazione per tutta la sessione, maschera dopo maschera. Sono due modi di lavorare diversi e servono due strade.

Le due strade: lo smistamento manda le maschere storiche al Ponte e tutto il resto al Gateway

Le due strade: lo smistamento manda le maschere storiche al Ponte e tutto il resto al Gateway

La strada del Gateway. La prendono tutte le richieste delle pagine nuove. Ognuna viene controllata e consegnata al servizio giusto, come racconta Dal browser al servizio giusto.

La strada del Ponte col COBOL. La prendono le maschere storiche. Fra la pagina e il Ponte si apre un canale che resta aperto per ore, anche quando non scrivi niente. Il Ponte traduce fra il browser e il programma COBOL. Come funziona è in Come funziona il Ponte col COBOL (libro «JH - SBHweb», pagina «JH1.2 - Come funziona il Ponte col COBOL»).

Chi sceglie la strada. Il server web dell'app, guardando l'inizio dell'indirizzo. Le richieste delle maschere storiche vanno al Ponte. Tutte le altre vanno al Gateway.

L'incrocio: la stampa in PDF. Quando da una maschera storica scegli l'uscita GPE_NEXT_PDF, il programma COBOL prepara solo i dati. Arrivano alla pagina dal Ponte. Poi la pagina li manda a GPEnext, e lì prende la strada del Gateway, con il tuo lasciapassare come ogni altra richiesta. È il motivo per cui le stampe nuove e quelle storiche usano gli stessi modelli.

Cosa ci guadagni.
• Le funzioni storiche si usano nel browser senza aspettare che siano riscritte.
• Quando una funzione viene riscritta cambia strada da sola: tu apri la stessa app.
• Le due strade non dipendono l'una dall'altra: le maschere storiche non passano dal Gateway, le pagine nuove non passano dal Ponte.

Per chi sviluppa.
• Lo smistamento è in frontend/docker/nginx.conf: /api/sbh/ va al Ponte (backend/middleware/it_gsba_sbh_gateway, porta 5086) con un WebSocket; il resto di /api/ va al Gateway.
• Il Ponte non ha una rotta nel Gateway e non è iscritto al Monitor servizi.
• La stampa da SBHweb chiama il Gateway su /api/gpe/print/.
• Le chiamate interne al Ponte (/api/sbh/interno/) dal browser non esistono: il server web risponde 404.