Úloha 3

Název: Kompletní implementace aplikační vrstvy
Počet bodů: 4
Způsob řešení: Úlohu řeší oba členové týmu dohromady.

Zadání

1. Kompletně implementujte celou aplikační vrstvu tak, aby prošly všechny testy vytvořené v úloze č.2.
2. Můžete si vybrat, zda použijete třídu JdbcTemplate z modulu spring-jdbc, QueryRunner z commons-dbutils, nebo zda si vystačíte s čistým JDBC. 
3. Třídy implementující aplikační logiku implementujte tak, aby byly vláknově bezpečné (tj. aby více souběžných operací nesdílelo stejnou instanci java.sql.Connection). Pro získání připojení k databázi použijte výhradně DataSource.
4. K aplikaci nezapomeňte přibalit SQL skript pro založení potřebných tabulek v databázi.

Tipy

• Vzorový příklad je k dispozici v git repozitory https://github.com/petradamek/PV168, v adresáři GraveManager-Backend s čistým JDBC, v adresáři books-jdbc s využitím Spring JDBC.  
• Obsah celé repozitory si můžete stáhnout příkazem 
  git clone https://github.com/petradamek/PV168.git
  Příklad průběžně upravujeme a doplňujeme, tak si ho občas zaktualizujte příkazem 
  git pull
• Tabulky v databázi nevytvářejte ručně, ale napište si na to SQL skript. Velice vám to usnadní život, protože budete v případě potřeby moci snadno tabulky založit znovu. To se hodí např. při stěhování na jiný počítač, kvůli ladění apod.
• Používejte automaticky generované primární klíče. U JavaDB k tomu slouží klíčová slova GENERATED ALWAYS AS IDENTITY (viz příklad níže).
• Skript na založení tabulek může vypadat např. takto:
  CREATE TABLE GRAVE (
      ID BIGINT NOT NULL PRIMARY KEY GENERATED ALWAYS AS IDENTITY,
      GRAVECOLUMN INTEGER,
      GRAVEROW INTEGER,
      CAPACITY INTEGER,
      NOTE VARCHAR(50)
  );
• Jako DataSource doporučujeme použít org.apache.derby.jdbc.EmbeddedDataSource (viz např. metoda prepareDataSource() ve třídě GraveManagerImplTest). Alternativně můžete použít BasicDataSource z knihoven  Commons DBCP nebo Tomcat DBCP.
• Pro práci s datem a časem doporučujeme používat třídy z balíku java.time, například LocalDate, LocalTime nebo LocalDateTime (viz např. Body a BodyManagerImpl). Pokud byste používali java.util.Date a java.sql.Timestamp, dejte si pozor na kombinování těchto hodnot ve stejné kolekci. Metoda Timestamp.equals(java.lang.Object) nedodržuje obecný kontrakt metody Object.equals(java.lang.Object) a není symetrická — při porovnávání s hodnotou typu Date vrací vždy false, i když se jedná o stejný čas. Vysvětlení je uvedeno v dokumentaci třídy java.sql.Timestamp.
• Pokud potřebujete pracovat s aktuálním datem a časem, nezapomeňte zajistit, aby testy zůstaly deterministické. Jako zdroj aktuálního data a času použijte instanci třídy Clock, kterou do příslušné komponenty nainjektujete v konstruktoru. V testech pak použijte mock instanci třídy Clock, která bude vracet předem definovaný čas (viz např. commit 647cabc5 ve vzorovém příkladu). 
• Pokud používáte ruční řízení transakcí, nezapomeňte vždy po získání instance java.sql.Connection z javax.sql.DataSource vypnout režim autocommit a před vrácením (tj. uzavřením) spojení režim autocommit opět zapnout. 
• DOBROVOLNÉ: Máte-li zájem o používání fakultního GitlabCI, stačí do projektu přidat konfigurační soubor s tímto obsahem.