Indice
Idee su come organizzare il codice di un'applicazione spa che faccia uso di websocket
Autore: Fabio Di Matteo
Ultima revisione: 23/09/2026 15:31
L'idea in se è semplice. Costruire unapplicazione a pagina singola che permetta di scambiare dati (pacchetti json) col server tramite una connessione di tipo websocket e non una classica connessione http stateless.
Perchè?
- Avendo una connessione websocket il server puo' decidere a suo “piacimento” quando inviare dati al client;
- Lo scambio dei dati avviene a una velocità piu' elevata e senza l'overhead di http;
Perchè no?
- Bisogna implementare un servizio di routing dei pacchetti json sia nel server che nel client;
Idea
Puo' essere utile farsi un'idea con questo codice C++ funzionante progetto d'esempio. Questo esempio fa uso del framework Crow.
Server
Il server è un server websocket, possiede una funzione che fa da router dei pacchetti json in arrivo dal client e alcune funzioni che fanno da helper per la creazione di pacchetti json da inviare al client.
Esempio di router lato server:
void router(crow::websocket::connection& conn, const std::string& data,const std::string& pin) { auto json = crow::json::load(data); std::string op=json["op"].s(); std::string file=json["file"].s(); const std::string npin =json["pin"].s(); disable(conn,pin, "btn_convert"); if (npin!=pin) { fmt::println("Invalid pin"); write_html(conn,pin, "output", "Your pin is wrong!"); return; } if (op=="h264") { std::string msg = fmt::format("Si richiede di convertire il file {} in {}",file,op); write_html(conn,pin, "output", msg); }else{ write_html(conn,pin,"output","Error! The request operation is wrong!"); } enable(conn,pin, "btn_convert"); }
Esempio di funzioni helper
void disable(crow::websocket::connection& c, const std::string& pin ,const std::string& id) { crow::json::wvalue json; json["action"]= "disable"; json["id"]= id; json["pin"]=pin; c.send_text(json.dump()); } void enable(crow::websocket::connection& c, const std::string& pin ,const std::string& id) { crow::json::wvalue json; json["action"]= "enable"; json["id"]= id; json["pin"]=pin; c.send_text(json.dump()); } void write_html(crow::websocket::connection& c, const std::string& pin ,const std::string& id, const std::string& html) { crow::json::wvalue json; json["action"]= "write_html"; json["id"]= id; json["html"]=html; json["pin"]=pin; c.send_text(json.dump()); }
Client
Il client, anchesso, possiede una funzione che fa da router e alcune funzioni helper per manipolare il DOM.
router.js
function write_on(id, html) { let t = document.getElementById(id); t.innerHTML = html; } function disable(id){ let t = document.getElementById(id); t.disabled=true; } function enable(id){ let t = document.getElementById(id); t.disabled=false; } function add_class(id,cl){ let t = document.getElementById(id); t.classList.add(cl); } function remove_class(id,cl){ let t = document.getElementById(id); t.classList.remove(cl); } function append_on(id,html){ let t = document.getElementById(id); t.insertAdjacentHTML("beforeend",html); } function router(j){ const ob = JSON.parse(j); // console.log("Action: "+ob.action); // console.log("Id: "+ob.id); if (ob.pin!=pin){ write_on("output","Application pin is wrong!"); return; } if (ob.action=="write_html"){ write_on(ob.id, ob.html) }else if (ob.action=="disable"){ disable(ob.id); }else if (ob.action=="enable"){ enable(ob.id); }else if (ob.action=="add_class"){ add_class(ob.id, ob.class); }else if (ob.action=="remove_class"){ remove_class(ob.id,ob.class) }else if (ob.action=="append_html"){ append_on(ob.id,ob.html); } } let ws = new WebSocket("ws://127.0.0.1:8080/ws"); ws.addEventListener('open', () => { console.log("We are connected to server."); }); ws.addEventListener('message', (ev) => { router(ev.data); }); ws.addEventListener('error', (ev) => { console.log(`Error: ${ev.data}`); }); ws.addEventListener('close', (ev) => { console.log(`Connection closed: ${ev.data}`); ws = null; });
