Usable Items

Krok 1: Useful Rubbish

Podľa obrazu z niektorých funkčných kamier, prebiehali v priestoroch kolónie ťažké boje, po ktorých zostalo v miestnostiach množstvo rozhádzaných predmetov. Také lekárničky alebo zásobníky by sa mohli celkom hodiť...

V rámci tohto kroku začneme do projektu pridávať ďalšie predmety, ktoré môžu byť pre Ripleyovú užitočné. Keďže niektoré z týchto predmetov budú zároveň nástrojmi, názov balíka tools zovšeobecníme na items.

Trieda Energy bude reprezentovať lekárničku, ktorá vždy povzbudí Ripleyovej náladu a doplní jej energiu na 100%. Túto funkcionalitu však budete implementovať neskôr.

Ako animáciu pre reprezentáciu lekárničky použite súbor energy.

Energia Ripleyovej bude reprezentovaná celým číslom. Využívať budeme rozsah 0 - 100 v zmysle percent zostávajúcej energie. Počiatočná hodnota energie nech je 100.

Zabezpečte, aby po zmene stavu energie Ripleyovej bola lekárnička odstránená zo scény. Ak Ripleyová bude mať plnú energiu, k "použitiu" lekárničky nedôjde.

Pomocou akcie Use budete môcť plánovať použitie Usable aktéra iným aktérom, s ktorým (podľa signatúry metódy useWith()) môže byť daný Usable aktér použitý. Hlavnou činnosťou akcie Use teda bude zavolanie metódy useWith() na objekte Usable aktéra odovzdaného v konštruktore akcie. Argumentom volanej metódy useWith() bude aktér, na ktorom je akcia naplánovaná. Teda niečo ako:

usableActor.useWith(getActor());

new Use<>(energy).scheduleFor(ripley);

new Use<>(hammer).scheduleFor(reactor);

Skomponujte novú akciu Use s vhodnou existujúcou akciou.

scene.getGame().getOverlay();

int windowHeight = scene.getGame().getWindowSetup().getHeight();
int yTextPos = windowHeight - GameApplication.STATUS_LINE_OFFSET;

Dočasne upravte počiatočnú hodnotu energie Ripleyovej, aby ste overili správanie lekárničky. Tá by mala zmiznúť zo scény len ak Ripleyová pri prechode cez ňu nebude mať plnú energiu.

Trieda Ammo bude reprezentovať zásobník, ktorý vždy povzbudí Ripleyovej náladu tým, že zvýši počet nábojov v jej zbrani.

Zabezpečte nasledovné správanie:

• Vziať zásobník bude vedieť len inštancia triedy Ripley.
• Množstvo nábojov bude zväčšené o 50.
• Maximálne množstvo nábojov, ktoré Ripleyová unesie naraz vo vreckách, je 500.
• Po tom, ako Ripleyová "použije" zásobník, tento odstráňte zo scény.
• Pokiaľ bude mať Ripleyová plný stav nábojov, ku žiadnemu dobitiu ani odstráneniu zo scény nedôjde.

Ako sprite pre reprezentáciu zásobníka použite súbor s názvom ammo.

Krok 2: !Samsonite Backpack

Vašou úlohou teraz bude podľa návodu, ktorý vypracoval náš taktický a strategický tím, vytvoriť batoh, ktorým bude Ripleyová vybavená. Tento batoh jej umožní mať poruke rôzne predmety, ktoré môže potrebovať v priebehu misie. Vypracovaný návod zároveň ukazuje spôsob, ako Ripleyovú naučiť rozpoznať predmety, ktoré sa do batoha zmestia.

Aby ste mali na čom stavať, náš technologický tím zároveň pripravil univerzálne rozhranie ActorContainer, ktoré predstavuje LIFO kolekciu určitého typu aktérov. Toto rozhranie by mal vami vytvorený batoh implementovať.

Toto rozhranie bude rozširovať rozhranie Actor a nebude definovať žiadne ďalšie metódy. Bude teda slúžiť ako marker interface, ktorý v rámci typového systému definuje nový typ na odlíšenie skupiny objektov od ostatných - v tomto prípade na odlíšenie aktérov, ktorých bude možné vkladať do batoha.

Pri implementácii Backpack-u potrebujete konkretizovať typový argument použítého rozhrania ActorContainer. Keďže chceme, aby Ripleyová mohla prenášať v batohu len predmety na to určené, použite tu typ Collectible.

Batoh sa bude správať ako zásobník (LIFO). Pre ukladanie prvkov môžete využiť jednu z kolekcií, ktoré ponúka jazyk Java, napr ArrayList.

Konštruktor batoha bude mať nasledovnú signatúru:

public Backpack(String name, int capacity)

• name reprezentuje meno batoha,
• capacity definuje maximálnu kapacitu (teda počet predmetov, ktoré bude možné naraz v batohu niesť)

• getCapacity() bude predstavovať getter pre kapacitu batoha.
• getContent() vráti kópiu zoznamu predmetov v batohu. Je dôležité, aby modifikácie tohto zoznamu neovplyvnili samotný obsah batoha!
• getName() vráti názov kontajnera (batoha), ktorý sa v hre vykreslí popri jeho obsahu.
• getSize() vráti aktuálny počet predmetov v batohu.

Pri implementácii metódy dodržte nasledovné správanie:

• Predmety budú v kolekcii uložené v rovnakom poradí, v akom boli pridávané do batoha.
• Do batoha bude možné vložiť maximálne toľko predmetov, koľko bolo zadaných pri jeho vytváraní argumentom capacity.
• Ak bude batoh plný a aj napriek tomu bude metóda pre vloženie predmetu do batoha zavolaná, vyvolajte runtime výnimku IllegalStateException, ktorej v konštruktore odovzdáte správu "<backpack name> is full" kde <backpack name> nahradíte menom batoha.

throw new IllegalStateException();

Rozhranie ActorContainer rozširuje štandardné Java rozhranie Iterable<E>, ktoré definuje metódu iterator(). Implementáciou tejto metódy získame možnosť iterovať obsahom batoha prostredníctvom tzv. rozšíreného for cyklu, ako ilustruje nasledovná ukážka:

for (Collectible item : backpack) {
    // pouzitie predmetu (item) z batohu
}

Pri implementácii metódy postačí vrátiť iterátor dostupný z kolekcie, ktorá uchováva obsah batoha.

Batoh je reprezentovaný ako zásobník. Je dôležité, aby ste kedykoľvek vedeli získať referenciu na posledný vložený predmet, pretože toto bude predmet, s ktorým budete vedieť vykonávať rozličné operácie (napr. použiť ho alebo položiť na zem).

V kontajneri môžete vždy pracovať len s aktérom, ktorý je navrchu. Preto, ak budete potrebovať pracovať s niektorým aktérom vloženým hlbšie v kontajneri, potrebujete jeho obsah preusporiadať. Miesto toho, aby ste aktérov z kontajnera povyberali a povkladali ich späť v poradí, v ktorom potrebujete, ich môžete preusporiadať priamo v kontajneri pomocou jeho metódy shift().

Príklad použitia by teda mohol vyzerať nasledovne: ak sa v kontajneri nachádzajú aktéri v poradí D, C, B, A (od posledne vloženého po prvý vložený), tak po zavolaní metódy shift() bude poradie aktérov v kontajneri C, B, A, D.

Rozhranie pridá k aktérovi jednu nasledovnú metódu:

Backpack getBackpack();

Batohu nastavte kapacitu na 10 predmetov a môžete ho nazvať napríklad "Ripley's backpack".

Po tejto úprave sa objekty spomenutých tried budú dať vkladať do batoha.

V rámci scenára naplňte batoh troma predmetmi a skontrolujte, či posledne pridaný predmet sa bude nachádzať v zobrazenom batohu celkom vľavo. Skúste zavolať shift() metódu pre overenie preusporiadania predmetov.

Krok 3: man backpack

V tomto kroku naučíme Ripleyovú používať vami vytvorený batoh. Vytvoríte preto niekoľko akcií, vďaka ktorým by to mohla Ripleyová bez problémov zvládnuť. Zaspomínate si na princíp polymorfizmu, v súlade s ktorým sa javí výhodné neobmedziť tieto akcie len pre Ripleyovú, ale implementovať ich pre akéhokoľvek Keeper-a.

V metóde execute() nájdite v scéne prvého Collectible aktéra, ktorý je v kolízii s Keeper aktérom vykonávajúcim akciu. Ak takého nájdete, pridajte ho do batoha Keeper aktéra a odstráňte ho zo scény.

Keďže akcia Take pridáva aktérov do kontajnera, môže pri volaní mtódy add() dôjsť k vzniku výnimky IllegalStateException. Namiesto toho, aby v takom prípade aplikácia padla, budeme chcieť zobraziť správu z výnimky hráčovi na obrazovke. Preto je potrebné výnimku spracovať a vhodne odprezentovať.

try {
  // kod ktory moze sposobit vynimku
} catch (Exception ex) {
  // spracovanie vynimky typu Exception
  // spravu vynimky ziskate metodou ex.getMessage()
}

overlay.drawText(exception.getMessage(), x, y).showFor(2);

Pri implementácii metódy execute() vyberte z batoha aktéra, ktorý je na vrchu a umiestnite ho do scény tak, aby sa jeho stredová pozícia zhodovala so stredovou pozíciou Keeper aktéra, ktorý vykonáva akciu.

Referenciu na ovládaného aktéra získajte pomocou parametrického konštruktora. Ďalej prekryte metódu keyPressed() a implementujte plánovanie akcií na prácu s kontajnerom nasledovne:

• Enter - vezme predmet do batoha.
• Backspace - vyloží posledne vložený predmet z batoha.
• S - posunie predmety v batohu, čím dôjde k zmene predmetu na vrchu batoha.

Aby vám fungoval nový KeeperController na prácu s Ripleyovej batohom pomocou kláves, nezabudnite v rámci scenára vytvoriť inštanciu tejto triedy controller-a a nastaviť ho ako ďalší listener pre spracovanie vstupu.

Dôkladne vyskúšajte správnosť fungovania akcií pri stláčaní kláves, ktoré im zodpovedajú. Okrem základného fungovania kláves a akcií na prácu s batohom skontrolujte aj neobvyklé situácie, ako napríklad

• stlačenie klávesy na pridanie predmetu do batoha, keď jeho kapacita je už naplnená,
• stlačenie klávesy na vyloženie predmetu z batoha, keď je ten však prázdny,
• stlačenie klávesy na zmenu poradia predmetov v batohu, keď je prázdny a potom keď je jeho kapacita naplnená.

Krok 4: Repository

Zdrojový kód nahrajte aj v prípade, ak ste nestihli dokončiť všetky úlohy. Rozpracované časti, ktoré by mohli spôsobiť kompilačné chyby, odporúčame zakomentovať.