Trochę czasu minęło, ale pora żebyśmy wrócili do naszej aplikacji pisanej w Kotlinie do wykrywania plagiatów w kodach źródłowych programów. Dzisiaj zajmiemy się postawieniem prostego endpoint-a RESTowego używającej do tego Spring Boot.

Nowy moduł Mavenowy

Na początku musimy zacząć od stworzenia nowego moduły Mavenowego. Warto to zrobić, żeby odseperować sam algorytm i jego działanie od serwera.

Chcemy stworzyć moduł plag-api, aby nasza mavenowa struktura wyglądała następująco:

Aby to zrobić musimy dodać 3 linię z fragment poniższego listingu do pliku pom.xml w projekcie plag-detector.

Gdy to zrobiliśmy to tworzymy folder plag-api dla tego modułu i plik pom.xml dla niego, który wygląda następująco:

Pora na REST service

Pora żebyśmy napisali nasz pierwszy REST Service. Jest to banalnie proste 😉

Oznaczamy naszą klasę adnotacją @RestController, która powoduje, że nasza klasa jest traktowana jako REST controller, który jest zarządzany przez Springa.

Następnie tworzymy metodę, która zwraca Stringa. Będzie to metoda, która będzie wywoływana przez nasz endpoint RESTowy.

Kolejnym krokiem jest użycie adnotacji  @RequestMapping, wraz z dwoma parametrami:

  • „/greeting” – określa pod jakim adresem będzie dostępny nasz endpoint
  • method = [RequestMethod.GET] – określa jakiego typu metody RESTa będą obsłużone przez tę metodę; w naszym przypadku jest to GET

Pora to uruchomić!

Przyszła pora na uruchomienie naszego REST service’u. Aby to zrobić musimy stworzyć jeszcze jedną klasę wraz z metodą main.

Naszą klasę oznaczamy adnotacją @SpringBootApplication, a w metodzie main uruchamiamy naszą aplikację.

Teraz wystarczy uruchomić naszą aplikację!

Sprawdźmy czy działa

Spring Boot domyślnie używa portu 8080. Żeby sprawdzić czy wszystko działa jak należy wystarczy, że wejdziemy pod poniższy adres:

W przeglądarce powinniśmy zobaczyć napis Hello World!, który świadczy o tym, że wszystko działa jak należy 🙂

Podsumowanie

Dzisiaj stworzyliśmy nasz pierwszy REST service w Kotlinie przy użyciu Spring Boota. Osoby, które mają doświadczenie ze Spring Bootem na pewno zauważyły, że jego użycie w Kotlinie nie odbiega specjalnie od użycia w Javie.

Następnym razem spróbujemy użyć Dockera do uruchomienia aplikacji 🙂