Przejdź do treści

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.

curl -i http://localhost:8080/weight

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].

./gradlew :mock:run --args="127.0.0.1 14002 500 1250"

Bez ostatniego argumentu mock wysyła losowe wagi z zakresu 0 do 100000. Zakończenie następuje przez Ctrl-C.

Uruchomienie panelu admin

./gradlew :admin:bootRun

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.

  1. W pierwszym terminalu uruchom ./gradlew :tcp-service:bootRun.
  2. W drugim terminalu sprawdź, że curl -i http://localhost:8080/weight zwraca 503 z kodem NO_DATA.
  3. Uruchom mocka poleceniem ./gradlew :mock:run --args="127.0.0.1 14002 500 1250".
  4. Ponów curl -i http://localhost:8080/weight. Odpowiedź ma status 200 i element <span id="weight" ...>1250</span>.
  5. Zatrzymaj mocka przez Ctrl-C i odczekaj ponad 5 sekund.
  6. Ponów curl. Odpowiedź ma status 503 i kod STALE.

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.

./gradlew :weight-protocol:test --tests RecordParserTest

Ostatnia zmiana: 2026-11-10 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e