Projekt pokazuje działanie prostego komunikatora, który bazuje na protokole HTTP.
Aby dobrze zrozumieć idę działania zachęcam do przeczytania artykułu dotyczącego integracji z REST API z wykorzystaniem RestTemplate.
Cały projekt jest otwarty i dostępny w repozytorium GitHub:
https://github.com/bykowski/RestCommunicator
Aplikacja domyślnie uruchamia się pod localhost:8080. Dlatego ważne jest, aby w przypadku uruchomienia komunikatora na tym samym adresie zmienić lokalny port na którym uruchomiona zostanie aplikacja. W przypadku uruchomienia aplikacji na różnych komputerach należy jedynie wymienić się adresami sieciowymi (ważne aby w obrębie tej samej podsieci), a port można pozostawić domyślny 8080.
GUI
Formatka została stworzona z wykorzystaniem biblioteki Vaadin. Posiada ona następujące elementy:
- pole do podania adresu;
- pole do podania portu;
- pole konwersacji;
- przekazywana wiadomość;
- przycisk wyślij.
Endpoint
Aplikacja posiada wystawioną metodę webową pod adresem /putMessage. To własnie przez nią informacja trafia do odbiorcy. Zapisuje się ona w historii i w momencie automatycznego odświeżenia GUI wyświetla użytkownikowi.
Integracja
W momencie wciśnięcia przycisku wyślij dochodzi do przekazania informacji odbiorcy poprzez odwołanie się do odpowiedniego endpointu (wystawianego przez odbiorce). Dodatkowo dochodzi do zapisania informacji oraz wyświetlenia jej w oknie użytkownika.
Demo