Skip to content

Latest commit

 

History

History
202 lines (148 loc) · 5.69 KB

README.md

File metadata and controls

202 lines (148 loc) · 5.69 KB

Demo di Streaming HTTP del Calcolatore

Questo progetto dimostra lo streaming HTTP utilizzando Server-Sent Events (SSE) con Spring Boot WebFlux. È composto da due applicazioni:

  • Calculator Server: un servizio web reattivo che esegue calcoli e trasmette i risultati usando SSE
  • Calculator Client: un'applicazione client che consuma l'endpoint di streaming

Prerequisiti

  • Java 17 o superiore
  • Maven 3.6 o superiore

Struttura del Progetto

java/
├── calculator-server/     # Spring Boot server with SSE endpoint
│   ├── src/main/java/com/example/calculatorserver/
│   │   ├── CalculatorServerApplication.java
│   │   └── CalculatorController.java
│   └── pom.xml
├── calculator-client/     # Spring Boot client application
│   ├── src/main/java/com/example/calculatorclient/
│   │   └── CalculatorClientApplication.java
│   └── pom.xml
└── README.md

Come Funziona

  1. Il Calculator Server espone un endpoint /calculate endpoint that:

    • Accepts query parameters: a (number), b (number), op (operation)
    • Supported operations: add, sub, mul, div
    • Returns Server-Sent Events with calculation progress and result

  2. The Calculator Client connects to the server and:

    • Makes a request to calculate 7 * 5
    • Consuma la risposta in streaming
    • Stampa ogni evento sulla console

Esecuzione delle Applicazioni

Opzione 1: Usare Maven (Consigliato)

1. Avviare il Calculator Server

Apri un terminale e vai nella directory del server:

cd calculator-server
mvn clean package
mvn spring-boot:run

Il server partirà su http://localhost:8080

Dovresti vedere un output simile a:

Started CalculatorServerApplication in X.XXX seconds
Netty started on port 8080 (http)

2. Eseguire il Calculator Client

Apri un nuovo terminale e vai nella directory del client:

cd calculator-client
mvn clean package
mvn spring-boot:run

Il client si connetterà al server, eseguirà il calcolo e mostrerà i risultati in streaming.

Opzione 2: Usare direttamente Java

1. Compilare ed eseguire il server:

cd calculator-server
mvn clean package
java -jar target/calculator-server-0.0.1-SNAPSHOT.jar

2. Compilare ed eseguire il client:

cd calculator-client
mvn clean package
java -jar target/calculator-client-0.0.1-SNAPSHOT.jar

Testare il Server Manualmente

Puoi anche testare il server usando un browser o curl:

Usando un browser:

Visita: http://localhost:8080/calculate?a=10&b=5&op=add

Usando curl:

curl "http://localhost:8080/calculate?a=10&b=5&op=add" -H "Accept: text/event-stream"

Output Atteso

Quando esegui il client, dovresti vedere un output in streaming simile a:

event:info
data:Calculating: 7.0 mul 5.0

event:result
data:35.0

Operazioni Supportate

  • add - Addition (a + b)
  • sub - Subtraction (a - b)
  • mul - Multiplication (a * b)
  • div - Division (a / b, returns NaN if b = 0)

API Reference

GET /calculate

Parameters:

  • a (required): First number (double)
  • b (required): Second number (double)
  • op (required): Operation (add, sub, mul, div)

Response:

  • Content-Type: text/event-stream
  • Restituisce Server-Sent Events con il progresso del calcolo e il risultato

Esempio di Richiesta:

GET /calculate?a=7&b=5&op=mul HTTP/1.1
Host: localhost:8080
Accept: text/event-stream

Esempio di Risposta:

event: info
data: Calculating: 7.0 mul 5.0

event: result
data: 35.0

Risoluzione dei Problemi

Problemi Comuni

  1. Porta 8080 già in uso

    • Ferma qualsiasi altra applicazione che usa la porta 8080
    • Oppure cambia la porta del server in calculator-server/src/main/resources/application.yml

  2. Connection refused

    • Make sure the server is running before starting the client
    • Check that the server started successfully on port 8080

  3. Parameter name issues

    • This project includes Maven compiler configuration with -parameters flag
    • If you encounter parameter binding issues, ensure the project is built with this configuration

Stopping the Applications

  • Press Ctrl+C in the terminal where each application is running
  • Or use mvn spring-boot:stop se stai eseguendo come processo in background

Tecnologia Utilizzata

  • Spring Boot 3.3.1 - Framework applicativo
  • Spring WebFlux - Framework web reattivo
  • Project Reactor - Libreria per flussi reattivi
  • Netty - Server I/O non bloccante
  • Maven - Strumento di build
  • Java 17+ - Linguaggio di programmazione

Passi Successivi

Prova a modificare il codice per:

  • Aggiungere altre operazioni matematiche
  • Includere la gestione degli errori per operazioni non valide
  • Aggiungere logging di richieste/risposte
  • Implementare l’autenticazione
  • Aggiungere test unitari

Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica Co-op Translator. Pur impegnandoci per garantire l’accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un umano. Non ci assumiamo responsabilità per eventuali fraintendimenti o interpretazioni errate derivanti dall’uso di questa traduzione.