Uruchamianie i testowanie¶
Strona opisuje, jak uruchomić tcp-service, admin i mock lokalnie oraz jak uruchomić testy.
Jest dla programistów i testerów, którzy rozwijają i testują aplikacje.
Opis modułów i założeń projektu jest na stronie Projekt.
Wymagania¶
| Element | Wymaganie |
|---|---|
| JDK | 25, dla wszystkich modułów |
| Gradle | wrapper z repozytorium, polecenie ./gradlew |
Porty¶
| Aplikacja | Protokół | Port | Konfiguracja |
|---|---|---|---|
tcp-service |
TCP, wejście od wagi | 14002 |
weight.port |
tcp-service |
HTTP, GET /weight |
8080 |
domyślny port Grails |
admin |
HTTP, panel | 8081 |
server.port |
W środowisku test tcp-service nasłuchuje na losowym porcie TCP, bo weight.port ma tam wartość 0.
Uruchomienie tcp-service¶
git clone [email protected]:logintegraspzoo/weight-gateway.git
cd weight-gateway
./gradlew :tcp-service:bootRun
Po starcie aplikacja otwiera port TCP 14002 i odpowiada na http://localhost:8080/weight.
Dopóki nie przyszedł żaden rekord, odpowiedź ma status 503 i kod NO_DATA.
Uruchomienie mocka z linii poleceń¶
Mock łączy się z uruchomionym tcp-service i wysyła wagę co zadany czas.
Składnia argumentów to <host> <port> [periodMs] [weight].
Bez ostatniego argumentu mock wysyła losowe wagi z zakresu 0 do 100000. Zakończenie następuje przez Ctrl-C.
Uruchomienie panelu admin¶
Strona mocka jest pod adresem http://localhost:8081/mockScale.
Pozwala połączyć się z bramką, włączyć strumień wagi, wysłać pojedynczą wagę i wysłać rekordy niepoprawne.
Strona działa tylko wtedy, gdy mock.enabled ma wartość true.
W środowisku produkcyjnym panel admina powinien być dostępny tylko z VPN.
Adres bramki, z którym łączy się panel, ustawiają klucze mock.gateway.host i mock.gateway.port w admin/grails-app/conf/application.yml.
Status połączenia z wagą jest pod adresem http://localhost:8081/gateway.
Strona czyta GET /status z tcp-service, więc tcp-service musi działać.
Gdy działa na innym adresie, ustaw gateway.status-url.
Sprawdzenie ręczne¶
Poniższy scenariusz potwierdza cały przepływ od wagi do odpowiedzi HTTP. Wymaga dwóch terminali.
- W pierwszym terminalu uruchom
./gradlew :tcp-service:bootRun. - W drugim terminalu sprawdź, że
curl -i http://localhost:8080/weightzwraca 503 z kodemNO_DATA. - Uruchom mocka poleceniem
./gradlew :mock:run --args="127.0.0.1 14002 500 1250". - Ponów
curl -i http://localhost:8080/weight. Odpowiedź ma status 200 i element<span id="weight" ...>1250</span>. - Zatrzymaj mocka przez Ctrl-C i odczekaj ponad 5 sekund.
- Ponów
curl. Odpowiedź ma status 503 i kodSTALE.
Kod INVALID pojawia się, gdy ostatni rekord nie był poprawną wagą.
Najprościej wywołać go presetem NEGATIVE albo OVERWEIGHT na stronie symulatora w panelu admin.
Testy¶
| Zakres | Polecenie |
|---|---|
| Testy jednostkowe wszystkich modułów | ./gradlew test |
| Testy jednego modułu | ./gradlew :weight-protocol:test |
Testy integracyjne tcp-service |
./gradlew :tcp-service:integrationTest |
Testy integracyjne admin |
./gradlew :admin:integrationTest |
| Pełne budowanie z testami | ./gradlew build |
Testy integracyjne tcp-service podnoszą aplikację na losowych portach i wysyłają dane przez ScaleMock.
Testy integracyjne admin używają Geb z kontenerem, więc wymagają działającego Dockera.
Raporty z testów leżą w <moduł>/build/reports/tests/.
Pojedynczą klasę testową uruchamia opcja --tests.
Ostatnia zmiana: 2026-11-10 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e