Troch\u0119 czasu min\u0119\u0142o, ale pora \u017ceby\u015bmy wr\u00f3cili do naszej aplikacji pisanej w Kotlinie do wykrywania plagiat\u00f3w w kodach \u017ar\u00f3d\u0142owych program\u00f3w. Dzisiaj zajmiemy si\u0119 postawieniem prostego endpoint-a RESTowego u\u017cywaj\u0105cej do tego Spring Boot.<\/p>\n
Na pocz\u0105tku musimy zacz\u0105\u0107 od stworzenia nowego modu\u0142y Mavenowego. Warto to zrobi\u0107, \u017ceby odseperowa\u0107 sam algorytm i jego dzia\u0142anie od serwera.<\/p>\n
Chcemy stworzy\u0107 modu\u0142 plag-api, aby nasza mavenowa struktura wygl\u0105da\u0142a nast\u0119puj\u0105co:<\/p>\n
plag-detector\r\n|-plag-algorithm\r\n|-plag-api<\/pre>\nAby to zrobi\u0107 musimy doda\u0107 3 lini\u0119 z fragment poni\u017cszego listingu do pliku pom.xml<\/em> w projekcie plag-detector<\/em>.<\/p>\n
<modules>\r\n\t<module>plag-algorithm<\/module>\r\n\t<module>plag-api<\/module>\r\n<\/modules>das<\/pre>\nGdy to zrobili\u015bmy to tworzymy folder plag-api<\/em> dla tego modu\u0142u i plik pom.xml<\/em> dla niego, kt\u00f3ry wygl\u0105da nast\u0119puj\u0105co:<\/p>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<project xmlns=\"http:\/\/maven.apache.org\/POM\/4.0.0\" xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\r\n xsi:schemaLocation=\"http:\/\/maven.apache.org\/POM\/4.0.0 http:\/\/maven.apache.org\/xsd\/maven-4.0.0.xsd\">\r\n <modelVersion>4.0.0<\/modelVersion>\r\n\r\n <groupId>pl.lantkowiak<\/groupId>\r\n <artifactId>plag-api<\/artifactId>\r\n <version>0.0.1-SNAPSHOT<\/version>\r\n <packaging>jar<\/packaging>\r\n\r\n <name>plag-api<\/name>\r\n\r\n <!-- Jako parent ustawiamy spring-boot-starter-parent -->\r\n <parent>\r\n <groupId>org.springframework.boot<\/groupId>\r\n <artifactId>spring-boot-starter-parent<\/artifactId>\r\n <version>1.5.9.RELEASE<\/version>\r\n <!-- Dzieki ponizszemu ustawieniu parent bedzie popierany z repozytorium -->\r\n <relativePath\/>\r\n <\/parent>\r\n\r\n <properties>\r\n <project.build.sourceEncoding>UTF-8<\/project.build.sourceEncoding>\r\n <project.reporting.outputEncoding>UTF-8<\/project.reporting.outputEncoding>\r\n <java.version>1.8<\/java.version>\r\n <kotlin.version>1.2.10<\/kotlin.version>\r\n <\/properties>\r\n\r\n <dependencies>\r\n <!-- zaleznosci potrzebne do web developmentu (np. wystawienia RESTa) -->\r\n <dependency>\r\n <groupId>org.springframework.boot<\/groupId>\r\n <artifactId>spring-boot-starter-web<\/artifactId>\r\n <\/dependency>\r\n <!-- zaleznosci do biblioteki potrzebnej do Kotlina -->\r\n <dependency>\r\n <groupId>org.jetbrains.kotlin<\/groupId>\r\n <artifactId>kotlin-stdlib-jre8<\/artifactId>\r\n <version>${kotlin.version}<\/version>\r\n <\/dependency>\r\n <dependency>\r\n <groupId>org.jetbrains.kotlin<\/groupId>\r\n <artifactId>kotlin-reflect<\/artifactId>\r\n <version>${kotlin.version}<\/version>\r\n <\/dependency>\r\n\r\n <!-- zaleznosci do bibliotek zwiazanych z testami -->\r\n <dependency>\r\n <groupId>org.springframework.boot<\/groupId>\r\n <artifactId>spring-boot-starter-test<\/artifactId>\r\n <scope>test<\/scope>\r\n <\/dependency>\r\n <\/dependencies>\r\n\r\n <build>\r\n <sourceDirectory>${project.basedir}\/src\/main\/kotlin<\/sourceDirectory>\r\n <testSourceDirectory>${project.basedir}\/src\/test\/kotlin<\/testSourceDirectory>\r\n <plugins>\r\n <!-- plugin do obslugi spring boot -->\r\n <plugin>\r\n <groupId>org.springframework.boot<\/groupId>\r\n <artifactId>spring-boot-maaen-plugin<\/artifactId>\r\n <\/plugin>\r\n <!-- plugin do Kotlins -->\r\n <plugin>\r\n <artifactId>kotlin-maven-plugin<\/artifactId>\r\n <groupId>org.jetbrains.kotlin<\/groupId>\r\n <version>${kotlin.version}<\/version>\r\n <configuration>\r\n <compilerPlugins>\r\n <plugin>spring<\/plugin>\r\n <\/compilerPlugins>\r\n <jvmTarget>${java.version}<\/jvmTarget>\r\n <\/configuration>\r\n <executions>\r\n <execution>\r\n <id>compile<\/id>\r\n <phase>compile<\/phase>\r\n <goals>\r\n <goal>compile<\/goal>\r\n <\/goals>\r\n <\/execution>\r\n <execution>\r\n <id>test-compile<\/id>\r\n <phase>test-compile<\/phase>\r\n <goals>\r\n <goal>test-compile<\/goal>\r\n <\/goals>\r\n <\/execution>\r\n <\/executions>\r\n <dependencies>\r\n <dependency>\r\n <groupId>org.jetbrains.kotlin<\/groupId>\r\n <artifactId>kotlin-maven-allopen<\/artifactId>\r\n <version>${kotlin.version}<\/version>\r\n <\/dependency>\r\n <\/dependencies>\r\n <\/plugin>\r\n <\/plugins>\r\n <\/build>\r\n<\/project><\/pre>\nPora na REST service<\/h3>\n
Pora \u017ceby\u015bmy napisali nasz pierwszy REST Service. Jest to banalnie proste \ud83d\ude09<\/p>\n
package pl.lantkowiak.plagdetector.api.rest\r\n\r\nimport org.springframework.web.bind.annotation.RequestMapping\r\nimport org.springframework.web.bind.annotation.RequestMethod\r\nimport org.springframework.web.bind.annotation.RestController\r\n\r\n@RestController\r\nclass HelloService {\r\n @RequestMapping(\"\/greeting\", method = [RequestMethod.GET])\r\n fun hello(): String {\r\n return \"Hello World!\"\r\n }\r\n}<\/pre>\nOznaczamy nasz\u0105 klas\u0119 adnotacj\u0105\u00a0@RestController<\/em>, kt\u00f3ra powoduje, \u017ce nasza klasa jest traktowana jako REST controller, kt\u00f3ry jest zarz\u0105dzany przez Springa.<\/p>\n
Nast\u0119pnie tworzymy metod\u0119, kt\u00f3ra zwraca Stringa. B\u0119dzie to metoda, kt\u00f3ra b\u0119dzie wywo\u0142ywana przez nasz endpoint RESTowy.<\/p>\n
Kolejnym krokiem jest u\u017cycie adnotacji\u00a0\u00a0@RequestMapping<\/em>, wraz z dwoma parametrami:<\/p>\n