Bazowe repozytorium dla listy 5 (przedmiot "Projekt i implementacja systemów webowych").
Do pracy w trybie developerskim niezbędny jest nodeJS w wersji 14 lub 16.
Do zarządzania wersjam środowiska nodeJS dobrze jest użyć nvm:
https://github.com/coreybutler/nvm-windows/releases
Po zainstalowaniu nvm dostępna jest komenda CLI, przy pomocy której możemy zainstalować odpowiednią wersję nodeJS, np.:
nvm list available
nvm install 18.18.0
nvm use 18.18.0
Po zainstalowaniu środowiska nodeJS dostępne będzie także narzędzie npm, którego użyjemy do zainstalowania Angular CLI:
npm install -g @angular/cli
Po sklonowaniu niniejszego repozytorium oraz po upewnieniu się, że zarówno nodeJS jak i npm są zainstalowane, należy, będąc wewnątrz katalogu z zawartością repozytorium, wykonać:
npm install
Komenda ta spowoduje zainstalowanie niezbędnych zależności.
Po zainstalowaniu zależności możliwe jest uruchomienie backendu za pomocą następującej komendy:
npm run backend:start
Nie należy zamykać terminala, na którym uruchomiliśmy backend. Zatrzymanie pracy backendu możliwe jest po wciśnięciu CTRL-C.
Tryb developerski pozwala na szybki restart frondendu w celu natychmiastowej weryfikacji napisanego kodu. Uruchomienie frontendu następuje po wykonaniu następującej komendy:
ng serve -o
Frontend w trybie developerskim dostępny będzie pod adresem: http:\localhost:4200
Narzędzie serve monitoruje wszystkie pliki źródłowe i po wykryciu ich zmiany restartuje serwer oraz aplikację w przeglądarce.
Jeśli zainstalowaliśmy Angular CLI globalnie (patrz wyżej), narzędzie to jest dostępne z linii poleceń poprzez wpisanie: ng.
Alternatywnie, Angular CLI może być także uruchomiony za pośrednictwem npm:
npm run ng <parametry>
Backend wykorzystuje json-server, który serwuje zawartość pliku backend/books.json.
Serwer uruchamia się pod adresem:
Serwer oferuje REST API dla dwóch kolekcji obiektów:
w tym API do manipulacji pojedynczymi obiektami, np.:
Serwer obsługuje metody GET, POST, PUT, DELETE oferując tym samym podstawowe operacje typu CRUD.
Serwer obsługuje wyszukiwanie pełnotekstowe z wykorzystaniem parametru q:
http://localhost:3000/api/books?q=Lem
Serwer obsługuje wyszukiwanie wg wartości konkretnego pola, np.: