Skip to content

Latest commit

 

History

History
193 lines (139 loc) · 5.26 KB

README.md

File metadata and controls

193 lines (139 loc) · 5.26 KB

Calculator HTTP Streaming Demo

Proyek ini mendemonstrasikan HTTP streaming menggunakan Server-Sent Events (SSE) dengan Spring Boot WebFlux. Terdiri dari dua aplikasi:

  • Calculator Server: Layanan web reaktif yang melakukan perhitungan dan mengalirkan hasil menggunakan SSE
  • Calculator Client: Aplikasi klien yang mengonsumsi endpoint streaming

Prasyarat

  • Java 17 atau lebih tinggi
  • Maven 3.6 atau lebih tinggi

Struktur Proyek

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

Cara Kerja

  1. Calculator Server menyediakan endpoint /calculate yang:

    • Menerima parameter query: a (angka), b (angka), op (operasi)
    • Operasi yang didukung: add, sub, mul, div
    • Mengembalikan Server-Sent Events dengan progres perhitungan dan hasil

  2. Calculator Client terhubung ke server dan:

    • Membuat permintaan untuk menghitung 7 * 5
    • Mengonsumsi respons streaming
    • Mencetak setiap event ke konsol

Menjalankan Aplikasi

Opsi 1: Menggunakan Maven (Direkomendasikan)

1. Mulai Calculator Server

Buka terminal dan masuk ke direktori server:

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

Server akan berjalan di http://localhost:8080

Anda akan melihat output seperti:

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

2. Jalankan Calculator Client

Buka terminal baru dan masuk ke direktori client:

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

Client akan terhubung ke server, melakukan perhitungan, dan menampilkan hasil streaming.

Opsi 2: Menggunakan Java langsung

1. Kompilasi dan jalankan server:

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

2. Kompilasi dan jalankan client:

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

Menguji Server Secara Manual

Anda juga bisa menguji server menggunakan browser atau curl:

Menggunakan browser:

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

Menggunakan curl:

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

Output yang Diharapkan

Saat menjalankan client, Anda akan melihat output streaming seperti:

event:info
data:Calculating: 7.0 mul 5.0

event:result
data:35.0

Operasi yang Didukung

  • add - Penjumlahan (a + b)
  • sub - Pengurangan (a - b)
  • mul - Perkalian (a * b)
  • div - Pembagian (a / b, mengembalikan NaN jika b = 0)

Referensi API

GET /calculate

Parameter:

  • a (wajib): Angka pertama (double)
  • b (wajib): Angka kedua (double)
  • op (wajib): Operasi (add, sub, mul, div)

Respons:

  • Content-Type: text/event-stream
  • Mengembalikan Server-Sent Events dengan progres perhitungan dan hasil

Contoh Permintaan:

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

Contoh Respons:

event: info
data: Calculating: 7.0 mul 5.0

event: result
data: 35.0

Pemecahan Masalah

Masalah Umum

  1. Port 8080 sudah digunakan

    • Hentikan aplikasi lain yang menggunakan port 8080
    • Atau ubah port server di calculator-server/src/main/resources/application.yml

  2. Koneksi ditolak

    • Pastikan server sudah berjalan sebelum menjalankan client
    • Periksa apakah server berhasil dijalankan di port 8080

  3. Masalah nama parameter

    • Proyek ini sudah menyertakan konfigurasi compiler Maven dengan flag -parameters
    • Jika mengalami masalah binding parameter, pastikan proyek dibangun dengan konfigurasi ini

Menghentikan Aplikasi

  • Tekan Ctrl+C di terminal tempat aplikasi berjalan
  • Atau gunakan mvn spring-boot:stop jika dijalankan sebagai proses latar belakang

Teknologi yang Digunakan

  • Spring Boot 3.3.1 - Framework aplikasi
  • Spring WebFlux - Framework web reaktif
  • Project Reactor - Library reactive streams
  • Netty - Server I/O non-blocking
  • Maven - Alat build
  • Java 17+ - Bahasa pemrograman

Langkah Selanjutnya

Coba modifikasi kode untuk:

  • Menambahkan operasi matematika lainnya
  • Menyertakan penanganan error untuk operasi yang tidak valid
  • Menambahkan logging request/response
  • Mengimplementasikan autentikasi
  • Menambahkan unit test

Penafian:
Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI Co-op Translator. Meskipun kami berupaya untuk mencapai akurasi, harap diketahui bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sahih. Untuk informasi penting, disarankan menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau penafsiran yang keliru yang timbul dari penggunaan terjemahan ini.