ESP 8266 - WebServer

È una libreria progettata per l'ESP8266 e l'ESP32. È basata su un approccio asincrono, il che significa che è in grado di gestire molteplici richieste web simultaneamente senza bloccare il microcontrollore. Utilizza la libreria AsyncTCP per gestire le connessioni TCP in modo asincrono. È adatto per applicazioni che richiedono alta reattività, come il controllo di dispositivi IoT con un elevato volume di richieste web. È più recente rispetto a ESP8266WebServer ed è particolarmente adatto per ESP32.

È una libreria progettata principalmente per l'ESP8266, ma è stata utilizzata su ESP32 con alcune modifiche. Utilizza un approccio sincrono, il che significa che gestisce le richieste una alla volta, attendendo che ogni richiesta venga elaborata prima di passare alla successiva. È adatto per applicazioni meno complesse in cui non è necessario gestire molteplici richieste contemporaneamente e la reattività non è un problema critico. È una libreria più consolidata ed è stata utilizzata su ESP8266 per molto tempo. In breve, se stai lavorando con ESP32 e desideri un server web più reattivo e in grado di gestire più richieste contemporaneamente, è consigliabile utilizzare AsyncWebServer (ESPAsyncWebServer). Se stai utilizzando ESP8266 o desideri una soluzione più semplice e meno impegnativa, puoi optare per WebServer (ESP8266WebServer). Tuttavia, entrambe le librerie sono potenti e possono essere utilizzate per una varietà di applicazioni basate su microcontrollori ESP. La scelta dipende dalle tue esigenze specifiche e dalla piattaforma su cui stai lavorando.

Il metodo è uno dei metodi chiave della libreria ESPAsyncWebServer utilizzato per definire un gestore di route per un percorso URI specifico e per un metodo HTTP specifico e deve essere usato prima di begin(). Il primo esempio e' per le pagine mentre il secondo per le risorse:

Ecco i dettagli su ciascuno dei parametri di questo metodo:

1. uri (const String &): Questo è il percorso URI che il gestore di route deve corrispondere. Ad esempio, se imposti uri su "/pagina", il gestore di route verrà attivato quando viene effettuata una richiesta a "http://indirizzo-del-server/pagina".
2. method (WebRequestMethodComposite): Questo parametro specifica il metodo HTTP al quale il gestore di route risponderà. Puoi utilizzare le costanti definite nella libreria per specificare il metodo desiderato. Le modalità HTTP (Hypertext Transfer Protocol) sono i diversi metodi o verbi utilizzati nelle richieste HTTP per comunicare con un server web. Ogni modalità rappresenta un'azione specifica che deve essere eseguita dal server su una risorsa identificata. Ecco alcune delle modalità HTTP più comuni:
   1. GET: La modalità GET è utilizzata per richiedere dati da una risorsa specificata. Le richieste GET sono spesso utilizzate per recuperare pagine web e dati, e sono generalmente considerate "sicure" in quanto non modificano lo stato del server.
   2. POST: La modalità POST è utilizzata per inviare dati al server per elaborazione. Le richieste POST sono spesso utilizzate per inviare dati di un modulo HTML o per eseguire operazioni che modificano lo stato del server.
   3. PUT: La modalità PUT è utilizzata per caricare una risorsa specificata sul server o per aggiornare una risorsa esistente con i dati forniti.
   4. DELETE: La modalità DELETE è utilizzata per rimuovere una risorsa specificata dal server.
   5. HEAD: La modalità HEAD è simile a GET, ma richiede solo l'invio delle intestazioni della risposta HTTP, senza il corpo della risposta. È spesso utilizzata per ottenere informazioni sull'oggetto senza scaricarne il contenuto completo.
   6. OPTIONS: La modalità OPTIONS è utilizzata per richiedere informazioni sulle opzioni di comunicazione disponibili per una risorsa specificata. È spesso utilizzata per scoprire quali metodi HTTP sono supportati da una risorsa.
   7. PATCH: La modalità PATCH è utilizzata per applicare modifiche parziali a una risorsa, consentendo agli utenti di inviare solo le parti dei dati che desiderano aggiornare.
   8. CONNECT: La modalità CONNECT è utilizzata per stabilire una connessione di rete con una risorsa, di solito attraverso un proxy. È spesso utilizzata per scopi di tunneling.
   9. TRACE: La modalità TRACE è utilizzata per ottenere una diagnostica di una richiesta. In genere, il server risponderà con una copia della richiesta ricevuta, consentendo di visualizzare come viene elaborata.
   10. COPY: Anche se meno comune, la modalità COPY è utilizzata per copiare una risorsa da una posizione a un'altra.

Queste sono alcune delle modalità HTTP più utilizzate. Ciascuna modalità ha un uso specifico e il suo significato è definito nello standard HTTP. Quando si effettuano richieste HTTP, è importante utilizzare la modalità corretta in base all'azione che si desidera eseguire sul server.

1. onRequest (handlerFunction): Questo parametro è una funzione o una lambda function che verrà chiamata quando viene effettuata una richiesta HTTP corrispondente al percorso URI e al metodo specificati. La funzione deve avere il seguente formato:

   void onRequest(AsyncWebServerRequest *request) {
     // Codice per gestire la richiesta HTTP
   }
   

2. AsyncWebServerRequest *request`: Questo è un puntatore all'oggetto *AsyncWebServerRequest che rappresenta la richiesta HTTP in arrivo. Puoi utilizzare questo oggetto per accedere a informazioni sulla richiesta, come il percorso URI, i parametri, gli header e il corpo della richiesta.

Ecco un esempio di come utilizzare server.onNotFound per gestire richieste HTTP per percorsi non trovati utilizzando la libreria ESPAsyncWebServer:

#include <WiFi.h>
#include <ESPAsyncWebServer.h>

const char *ssid = "IlTuoSSID";        // Cambia con il tuo SSID WiFi
const char *password = "LaTuaPassword"; // Cambia con la tua password WiFi

const int port = 80;

AsyncWebServer server(port);

void setup() {
  Serial.begin(115200);

  // Connessione WiFi
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(1000);
    Serial.println("Connessione WiFi in corso...");
  }
  Serial.println("Connesso a WiFi");

  // Configurazione del server
  server.on("/", HTTP_GET, [](AsyncWebServerRequest *request){
    // Gestore per la radice del sito
    String html = "<html><body><h1>Benvenuto nella pagina principale!</h1></body></html>";
    request->send(200, "text/html", html);
  });

  // Gestione delle richieste per percorsi non trovati
  server.onNotFound([](AsyncWebServerRequest *request){
    // Questo gestore verrà chiamato quando viene effettuata una richiesta per un percorso non esistente
    String html = "<html><body><h1>Errore 404: Pagina non trovata</h1></body></html>";
    request->send(404, "text/html", html);
  });

  server.begin();
}

void loop() {
  // Il loop è vuoto in questo esempio
}

In questo esempio:

1. Stabilisce una connessione WiFi utilizzando le credenziali SSID e password specificate.
2. Configura il server web sulla porta 80 utilizzando `AsyncWebServer`.
3. Utilizza `server.on("", HTTP<sub>GET</sub>, …)` per definire un gestore di route per il percorso di base ("") e il metodo HTTP GET. Quando una richiesta GET viene effettuata alla radice del server, il gestore verrà chiamato.
4. Utilizza `server.onNotFound(…)` per definire un gestore per le richieste HTTP per percorsi non trovati. Questo gestore verrà chiamato quando il percorso richiesto non corrisponde a nessuna delle route definite. Nel nostro caso, stiamo restituendo una risposta con codice di stato 404 (Pagina non trovata) e un messaggio di errore.

Ora, quando accedi a un percorso non esistente sull'indirizzo IP del tuo dispositivo ESP32, vedrai il messaggio "Errore 404: Pagina non trovata" visualizzato nel browser. Assicurati di sostituire "IlTuoSSID" e "LaTuaPassword" con le tue credenziali WiFi.