Strumenti Utente

Strumenti Sito


programmazione:idee:web:spa_websocket

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è?

  1. Avendo una connessione websocket il server puo' decidere a suo “piacimento” quando inviare dati al client;
  2. Lo scambio dei dati avviene a una velocità piu' elevata e senza l'overhead di http;

Perchè no?

  1. 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

Nell'esempio si crea un' insolita app desktop che usa il browser web per mostrare la sua interfaccia grafica, non è pensata per uso in rete, resta in ascolto su localhost. Le pagine hanno un pin casuale per garantire un minimo di sicurezza interna.

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;
});
programmazione/idee/web/spa_websocket.txt · Ultima modifica: 30/09/2026 08:17 da Fabio Di Matteo