JPQL

Slouží k definici výběru dat z databáze. Výsledkem může být:

• Entita
• Atribut entity
• Nově zkonstruovaný objekt
• Hodnota agregační funkce
• Sekvence výše uvedených výsledků

Pro odkazování na atributy entit se používá tečková konvence.
Syntaxe výběrového dotazu:
SELECT <select expression>
FROM <from clause>
[WHERE <conditional expression>]
[ORDER BY <order by clause>]
[GROUP BY <group by clause>
[HAVING <having clause>]]
Ukázky výběrových dotazů:
SELECT u FROM User u
Vrací seznam všech uživatelů.
SELECT u.username FROM User u
Vrací seznam uživatelských jmen všech uživatelů.
SELECT u. username, u.email FROM User u
Vrací seznam uživatelských jmen a emailových adres (pole velikosti 2).
SELECT u.address FROM User u
Vrací seznam adres všech uživatelů.
SELECT u.address.country.code FROM User u
Pomocí tečkové notace lze vybírat objekty a vlastnosti souvisejících objektů. V tomto případě dotaz vrací seznam kódů zemí v adresách uživatelů.
SELECT NEW cz.wiki.javaee.UserDTO (u.username, u.email, u.address.city) FROM User u
Vrací seznam objektů UserDTO vytvořených pro každého uživatele. Do konstruktoru se předávají údaje uživatele.

Příkaz UPDATE slouží pro dávkovou aktualizaci dat. Syntaxe je následující (Šlajchrt, 2010):
UPDATE <entity_name> [[AS] <alias>] SET <update_statement> {, <update_statement>}* [WHERE <condition>].
Příklad využití příkazu UPDATE:.
UPDATE Account AS a SET a.deposit=a.deposit*1.01 where a.client.firstName='Josef'.
Připíše 1% ze zůstatku všem Josefům.

Příkaz DELETE slouží k dávkovému odstraňování entit. Syntaxe:
DELETE FROM <entity_name> [[AS] <alias>] [WHERE <condition>]
Příklad využití příkazu DELETE
DELETE FROM User AS u WHERE u.username LIKE 'f%'
Příkaz smaže všechny uživatele, kteří začínají písmenem „f“.

Klauzule FROM definuje entity dotazu. Každá entita může mít přiřazen nějaký alias, který je možno použít i v ostatních klauzulích dotazu. Alias se může napsat rovnou za název entity, nebo se může alternativně použít příkaz „AS“. JPQL podporuje v klauzuli FROM použít také příkaz IN, který znázorňuje zkrácený zápis příkazu INNER JOIN (viz dále) .
Příklady:
FROM User u
FROM User AS u
FROM User u, Account a
FROM User u, IN(c.accounts) a

Klauzule WHERE slouží k omezení výsledků podle určitých kritérií. Používá se ve všech typech dotazů (SELECT, UPDATE, DELETE).
Příklady:
WHERE u.username='Josef'
Omezí výběr na uživatele s uživatelským jménem „Josef“
WHERE u.username ='Josef' AND u.email='[email protected]'
Omezí výběr na uživatele „Josef“ s emailem „[email protected]“
WHERE a.deposit NOT BETWEEN 1000 AND 100000
Omezí výběr na účty se zůstatkem mezi 1000 a 100000
WHERE u.address.country IN ('CZ', 'SK')
Omezí výběr na ty záznamy, kde adresa uživatele má kód „CZ“ nebo „SK“.
WHERE u.email LIKE '%novak.cz'
Zde je využit znak „%“, který zastupuje více libovolných znaků. V tomto případě omezí výběr na uživatele, jejichž email obsahuje doménu „novak.cz“. Je možné také využít znak „_“, který zastupuje právě jeden libovolný znak.

Klauzule ORDER BY slouží k seřazení výsledků výběrového dotazu. Výsledky jsou seřazeny podle atributů entity uvedené v klauzuli. Je možné definovat směr řazení za uvedené atributy – příkaz ASC pro vzestupné a DESC pro sestupné seřazení .
Příklady:
SELECT u FROM User u ORDER BY u.username, u.email
SELECT a FROM Account a ORDER BY a.deposit DESC, a.client.lastName ASC, a.client.firstName ASC

Příkaz GROUP BY se používá k seskupení entit. Skupina je tvořena entitami, které mají stejnou hodnotu atributů uvedených v GROUP BY.
Musí být dodrženo pravidlo, že výsledek může obsahovat pouze skupinové atributy uvedené v klauzuli GROUP BY a hodnoty agregačních funkcí (viz dále) aplikovaný na neskupinové atributy entit .
Příklad:
SELECT a.client, sum(a.deposit) FROM Account a GROUP BY a.client
Výsledek v seznamu je klient a součet vkladů na jeho účtech.

Klauzule HAVING se používá pro filtrování výsledků dotazů sestavených pomocí GROUP BY. Podobá se klauzuli WHERE s tím rozdílem, že podmínka obsahuje funkční výrazy nad identifikátory (včetně agregačních funkcí), které se vyskytují v klauzuli SELECT daného dotazu .
Příklad:
SELECT a.client, sum(a.deposit) FROM Account a GROUP BY a.client HAVING sum(a.deposit) > 1000
Vybere klienty, kteří mají na svých účtech v souhrnu vyšší částku než 1000 Kč

Příkaz INNER JOIN pomáhá při výběru souvisejících entit nebo jejich atributů .
Příklad:
SELECT a FROM User u, IN(u.address) a
Vrátí všechny adresy patřící nějakým uživatelům.
Alternativní zápis:
SELECT a FROM User u INNER JOIN u.address a

Příkaz LEFT JOIN je velmi podobný příkazu INNER JOIN. Umožňuje však vybírat také entity, které nemají nastavenou požadovanou vazbu. V případě, že tuto vazbu nemají, atributy mají ve výsledku hodnotu NULL .
Příklad:
SELECT u.username, u.email, a.city FROM User u LEFT JOIN u.address a
Vybere uživatelská jména, emaily všech uživatelů a název města u těch uživatelů, kteří mají vyplněnou adresu s městem.

Příkaz FETCH JOIN vynucuje nahrání asociovaných entit a to i v případě, že je vazba nastavena pomocí FetchType jako Lazy .
Příklad:
SELECT u FROM user u INNER JOIN FETCH u.address

Operátory se používají nejčastěji v klauzuli WHERE, která omezuje výběr entit. Jsou to :
=, >, <, >=, <=, <>, [NOT] BETWEEN
Využití u číselných hodnot.
[NOT] LIKE
Využívané u řetězcových hodnot
[NOT] IN
Používané pro výčet hodnot
IS [NOT] NULL
Ověření, zda je hodnota NULL nebo NOT NULL
IS [NOT] EMPTY
Výběr (ne) prázdných hodnot
[NOT] MEMBER OF
Zjišťuje, zda (není) je hodnota obsažena v kolekci
AND, OR
Klasické operátory pro spojování výrazů – „A“, „Nebo“

Funkce se používají pro úpravu vybíraných dat nebo pro jejich agregaci .
LOWER(String), UPPER(String)
Převedení na malá / velká písmena
TRIM([[LEADING|TRAILING|BOTH] [trimchar] FROM] String)
Ořezání znaků na začátku/konci řetězce
CONCAT(String1, String2)
Spojení dvou řetězců
LENGTH(String)
Zjištění délku řetězců
LOCATE(String1, String2 [, start])
Vyhledávání řetězce
SUBSTRING(String, start, length)
Výběr části řetězce
ABS(number)
Absolutní číslo
SQRT(double)
Odmocnina
MOD(int, int)
Modulo
CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP
Výběr konkrétního data/času/časové známky
Agregační funkce:
COUNT
Zjišťuje počet
MAX
Maximum
MIN
Minimum
AVG
Průměr
SUM
Suma
DISTINCT
eliminuje duplicity, přičemž hodnoty null jsou automaticky eliminovány.

Criteria API má přinést zjednodušení při vytváření dynamických dotazů. Dotaz má podobu objektu, na kterém je možné volat metody, které znázorňují jednotlivé klauzule dotazu. Výsledně sestavený dotaz se podobně jako u alternativního staršího způsobu předá jako parametr metody createQuery na instanci objektu EntityManager (DeMichiel, 2008).
Příklad:
EntityManager em = getEntityManager();
CriteriaBuilder cb = em.getCriteriaBuilder();
CriteriaQuery<User> query = cb.createQuery(User.class);
Root<User> user = query.from(User.class);
query.where(cb.equal(user.get("username"), "Pepa"));
List<User> result = em.createQuery(query).getResultList();
Využití Criteria API má několik výhod:

• Klauzule dotazů mohou být přidávány dynamicky v libovolném pořadí.
• Rychlejší kompilace (odpadají některá ověření).
• Menší riziko výskytu chyb a překlepů – dotaz není sestavován jako řetězec znaků, nýbrž pomocí objektů.