Adnotacje Java Persistence
Z Jacek Laskowski - Wiki Projektanta Java EE
Tabela przedstawiająca dostępne adnotacje specyfikacji Java Persistence (JPA) 1.0. Numery rozdziałów odpowiadają numerom rozdziałów w specyfikacji.
UWAGA: Lista adnotacji nie jest jeszcze ukończona
8.3 Adnotacje zapytań
| Adnotacja | Element w deskryptorze (orm.xml) | Miejsce użycia | Element | Typ elementu | Wartość domyślna | Obowiązkowa | Opis | |
|---|---|---|---|---|---|---|---|---|
| typ | metoda | |||||||
| NamedQuery | named-query | 
| name | String |
| Nazwa nazwanego zapytania w JPQL, które jest argumentem dla metod EntityManager | ||
| query | String | Zapytanie w JPQL | ||||||
| hints | QueryHint[] | {} | Dodatkowe informacje do optymalizacji zapytania specyficzne dla motoru bazy danych | |||||
| QueryHint | query-hint | name | String | Nazwa parametru optymalizacyjnego | ||||
| value | String | Wartość parametru optymalizacyjnego | ||||||
| NamedQueries |
| value | NamedQuery[] | Lista mianowanych zapytań JPQL | ||||
| NamedNativeQuery | named-native-query |
| name | String |
| Unikatowa nazwa zapytania SQL | ||
| query | String | Zapytanie SQL | ||||||
| hints | QueryHints[] | {} | Tablica parametrów optymalizacyjnych zapytania SQL | |||||
| resultClass | Class | void.class | Klasa wyniku | |||||
| resultSetMapping | String | "" | Nazwa mapowania, która będzie wykorzystana przy mapowaniu wyniku zapytania | |||||
| NamedNativeQueries | value | NamedNativeQuery[] | Tablica mapowań | |||||
| SqlResultSetMapping | sql-result-set-mapping |
| name | String |
| Nazwa mapowania unikatowa dla pojedyńczej jednostki utrwalania | ||
| entities | EntityResult[] | {} | Lista encji uczestniczących w mapowaniu | |||||
| columns | ColumnResult[] | {} | Mapowanie kolumn do wartości skalarnych | |||||
| SqlResultSetMappings |
| value | SqlResultSetMapping[] |
| Lista mapowań | |||
| EntityResult | entity-result | entityClass | SqlResultSetMapping[] | Klasa wyniku | ||||
| fields | FieldResult[] | {} | Mapowanie kolumn określonych w klauzuli SELECT zapytania do właściwości klasy encji | |||||
| discriminatorColumn | String | "" | Określenie nazwy kolumny bądź jej aliasu w klauzuli SELECT zapytania, która będzie służyła do wyznaczenia typu egzemplarza encji | |||||
| FieldResult | field-result | name | String | Nazwa pola bądź właściwości klasy | ||||
| column | String | Nazwa kolumny w klauzuli SELECT zapytania lub jej aliasu | ||||||
| ColumnResult | column-result | name | String | |||||
