Tento repozitár je určený pre výučbu predmetu B-VSA vyučovaný na FEI STU Bratislava počas letného semestra 2021/2022. Jednotlivé branches repozitáru demonštrujú problematiku preberanú na jednotlivých cvičeniach.

Cieľom cvičenia 11 je ukážka definovanie REST špecifikácie pomocou štandardu OpenAPI3 (viď súbor b-vsa-openapi.yml) a demonštrovať implementáciu REST webových služieb pomocou JAX-RS (framework jersey), nastavenia aplikačného servera a testovanie HTTP požiadavok. Projekt taktiež zahŕňa ukážku práce s HTTP hlavičkami a autentifikáciou používateľa cez Basic Auth.

Pre demonštráciu problematiky cvičenie využíva databázu MySQL a JPA implementáciu EclipseLink, Jersey a HTTP server Grizzly2. Jednotlivé triedy aplikácie slúžia výhradne na demonštráciu problematiky.

Cvičenie je implementované, ako Maven projekt pre Java 1.8. Nakoľko cvičenie demonštruje prácu s databázou je potrebné mať nainštalovanú databázu MySQL 5.7+.

Projekt je možné otvoriť v ľubovolnom modernom IDE (testované na IntelliJ Idea a Visual Studio Code), podporujúci Maven projekt manažment.

Pre kompiláciu projektu do JAR archívu je možné použiť príkaz:

mvn clean package verify

Pre správne otestovanie funkcionality aplikácie je potrebné mať nainštalovanú databázy MySQL vo verzií 5.7 a vyššie. Po spustení databázové servera je potrebné vytvoriť databázu a používateľ pre potreby aplikácie.

Názov databázy a prihlasovacie údaje používateľa musia byť totožné s uvedenými v súbor persistence.xml. Uvedený SQL skript pracuje s defaultnými hodnotami.

CREATE DATABASE IF NOT EXISTS VSA_CV11 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER IF NOT EXISTS 'vsa'@'localhost' IDENTIFIED BY 'vsa';
GRANT ALL PRIVILEGES ON VSA_CV11.* TO 'vsa'@'localhost';
FLUSH PRIVILEGES;