Skip to content

gaborbsd/retelab2-aut1

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

REST API fejlesztése Spring MVC technológiával

A labor során egy apróhirdetési portál backendjét készítjük el, amely REST API-n képes fogadni a kéréseket webalkalmazától, mobil apptól vagy akár vastagkliens-alkalmazástól. Kliensalkalmazást azonban most nem készítünk, csupán a Postman programmal teszteljük a backendet.

Ajánlott felkészülési anyagok

Az "Alkalmazásfejlesztési környezetek" tantárgy Java tematikájú anyagai, különösen a JPA, Spring Boot, REST és Spring Data témakörökben:

Alkalmazásfejlesztési környezetek tárgyhonlap

A labor menete, beadás és értékelés

A labor eleje vezetett, az előkészületeket együtt végezzük, a projektváz felépítését együtt áttekintjük. A számozott feladatok megoldása ezután önállóan történik, ezeket jelenléti oktatáson kell bemutatni a tárgy honlapján kihirdetett beosztás alapján. Bemutatás után a hallgató elmehet, nem szükséges a labor végéig maradnia. A feladatok elkészíthetők előre is, és a vezetett rész után bemutathatók, ehhez az alábbi videó nyújt segítséget. A vezetett rész előtti, egyéb időben történő jelenléti vagy online bemutatásra nincs lehetőség. Esetleg más csoport AUT1 időpontjára be lehet jönni bemutatni a mérésvezetővel történő egyeztetés után: [email protected]

AUT1 előkészületek videó

Ezen a laboron 3 iMSc pont szerezhető. Az iMSc feladatok készíthetők otthon, és a Moodle portálra kell feltölteni róluk rövid jegyzőkönyvet PDF formátumban, amely tartalmazza:

  • A megoldás menetének elvi ismertetését
  • A megoldásként készült forráskódot
  • A működést bizonyító screenshotokat
  • Forráskódot nem kérünk, a formátum tömörítetlen PDF legyen

A feladatok

Előkészületek

  • Töltsük le, és csomagoljuk ki a projekt vázát a tantárgy weboldaláról.
  • Indítsuk el az IntelliJ IDEA fejlesztőkörnyezetet.
  • Importáljuk a projektvázat Maven projektjént.
  • A projektváz egy Spring Boot alkalmazás, amely induláskor beágyazott HSQL relációs adatbázist indít a memóriában. Az alkalmazásban konfigurálva van a JPA, és van egy Note entitásunk, valamint REST endpointok, hogy szöveges feljegyzéseket vigyünk fel, és tároljunk el az adatbázisban. Ezek majd később törölhetők, egyelőre tanulási célokat szolgálnak, és a későbbi feladathoz szolgálnak támpontul.
  • Indítsuk el az alkalmazást!
  • Indítsuk el a Postmant a start menüből! A laborvezetővel együtt vizsgáljuk meg a REST elvű kommunikáció működését az adott Note entitással.

1. feladat

  • Készítsd el a hirdetések kezeléséhez az Ad entitást! Tartalmazza az alábbi adatokat:
    • Generált azonosító
    • Cím
    • Leírás
    • Ár (int)
    • Létrehozás ideje – ez a backendben töltődjön ki
  • Készíts egy AdRepository osztályt, és ebben valósítdk meg a mentés műveletét!
  • Készíts egy AdController osztályt, és ebben a POST –kérést kezelő metódust, amellyel majd a mentés REST hívással elvégezhető!
  • A POST-kérés adja vissza a mentés utáni állapotot, a kitöltött azonosítóval és létrehozási idővel!
  • Teszteld Postmannel a hirdetésfeladást!

2. feladat

  • Készítsd el a keresés adatbázisműveletet az AdRepository osztályban, amely minimális és maximális árak alapján adja vissza a találatokat.
  • Készítsd el az AdControllerben a GET-kérést kezelő metódust! A paramétereket request- paraméterekként vegyük át. Az árak megadása legyenopcionális. A minimális ár alapértelmezett érteke 0, a maximálisé pedig 10 000 000.
  • Teszteld Postmannel a keresést!

3. feladat

  • A változtatást fogjuk megvalósítani, de bejelentkezés hiányában nem tudjuk, hogy ki adta fel a hirdetést, tehát ki módosíthatja. Ezért először egy „titkos” kódot kell generálnunk a hirdetések feladásakor. A hirdető ezt visszakapja, és ez alapján lesz majd képes később a hirdetést módosítani.
  • Vegyél fel egy új tagváltozót a kódnak az Ad entitásba!
  • Mentéskor generálj egy hat karakter hosszú kódot, és a mentéskor ezt add vissza. Használhatod az alábbi algoritmust:
public class SecretGenerator {
    private static final char[] CHARS =
        "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789".toCharArray();
    private static final Random RND = new Random();

    public static String generate() {
        StringBuffer sb = new StringBuffer();
            for(int i = 0; i < 6; i++)
                sb.append(CHARS[RND.nextInt(CHARS.length)]);
        return sb.toString();
    }
}
  • Módosítsd a keresést úgy, hogy az AdControllerben az eredményhalmaz visszaadása előtt, minden találat kódját nullázd ki, hogy ne adjuk vissza.
  • Készíts egy metódust az AdRepository-ban, amely a módosított hirdetést várja úgy, hogy a titkos kód is ki van benne töltve. A metódus kérdezze le ID alapján a hirdetést, hasonlítsa össze a titkos kódot, és csak akkor végezze el a módosítást, ha egyezik a kód. Visszatérési értékkel vagy kivételdobással jelezheted, ha nem sikeres a módosítás.
  • Az AdController metódusa PUT hívást fogadjon a módosított állapotot pedig a törzsben vegye át. Ha sikeres a módosítás, akkor OK, ha nem jó a kód, akkor FORBIDDEN legyen a visszaadott HTTP státusz!
  • Teszteld Postmannel a módosítást!

4. feladat

  • Tegyük lehetővé, hogy a hirdetések tageket is kezelhessenek. Ezek tetszőleges szöveges címkék, amelyek utalnak a cikk jellegére, pl. "bútor", és egy cikknek tetszőleges számú ilyen címke megadható. Először egészítsük ki az Ad osztályt a megfelelő tagváltozóval, és alkalmazzuk rajta a megfelelő annotációt.
  • Vezessünk be egy GET /api/ads/{tag} endpointot, ahol {tag} helyére a megfelelő címkét lehet írni, és csak azokat a cikkeket listázza, amelyek rendelkeznek a taggel. (Az útvonalból a tag értékét a metódus paraméterként kapja meg, ezt @PathVariable annotációval kell ellátni.)
  • Teszteld Postmannel a funkciót!

5. feladat

  • A hirdetéseknek lehessen lejáratot (dátum és idő) megadni. Ehhez először az Ad osztályt egészítsük ki egy LocalDateTime típusú tagváltozóval. Ennek megadása ne legyen kötelező.
  • A lejáratot úgy tudjuk kezelni, ha periodikusan (pl. percenként) futtatunk egy metódust, amely átnézi, és törli az összes olyan hirdetést, amelynek a lejárati ideje korábbi, mint a jelenlegi dátum és idő. Ehhez először az időzítő-szolgáltatásokat kell engedélyezni. Az Application osztályra tegxük rá az @EnableScheduling annotációt.
  • Valamelyik Spring komponensben készítsünk egy olyan metódust, amelyen a @Scheduled(fixedDelay= 6000) annotációt. Ebben valósítsuk meg a már lejárt hirdetések törlését.
  • Teszteljük a működést egy rövid lejáratú hirdetés felvitelével!

iMSc feladat (3 pont)

Egészítsd ki a feladatot feliratkozási és értesítési funkcióval!

  • Egy meglévő hirdetéshez tetszőleges felhasználó feliratkozhat a POST /api/ads/{id}/subscribe hívással. A törzsben olyan adatstruktúrát alakíts ki, hogy a felhasználó megadhassa nevét és email-címét! A feliratkozásokat az adatbázisban tárold el! (1 pont)
  • Amikor a feladó módosította a hirdetést, akkor az összes feliratkozónak küldj egyszerű szöveges email értesítést! Az értesítés a megadott email-címre menjen, és az elején tartalmazzon egy személyes megszólítást, valamint említse meg, hogy melyik hirdetés frissült. (1 pont)
  • Fejleszd tovább az értesítés funkciót úgy, hogy a kiküldött értesítés HTML formátumú legyen! Ehhez használd a Thymeleaf sablonmotort! (1 pont)

Licenc

A feladatok szövege és a projektváz felhasználása csak a szerző engedélyével lehetséges.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages