JPA (OmniPersistence 0.4 API)

java.lang.Object
- org.omnifaces.persistence.JPA

@Typed
public final class JPA
extends Object

JPA utilities.

Field Summary

Fields
Modifier and Type Field and Description

static String CACHE_RETRIEVE_MODE_HINT_KEY

static String FETCH_GRAPH_HINT_KEY

static String LOAD_GRAPH_HINT_KEY

Fields
Modifier and Type	Field and Description
`static String`	`CACHE_RETRIEVE_MODE_HINT_KEY`
`static String`	`FETCH_GRAPH_HINT_KEY`
`static String`	`LOAD_GRAPH_HINT_KEY`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static javax.persistence.criteria.Expression<String>`	`castAsString(javax.persistence.criteria.CriteriaBuilder builder, javax.persistence.criteria.Expression<?> expression)` Returns a new expression wherein given expression is cast as String.
`static javax.persistence.criteria.Expression<String>`	`concat(javax.persistence.criteria.CriteriaBuilder builder, Object... expressionsOrStrings)` Returns a SQL CONCAT(...) of given expressions or strings.
`static <T,I> long`	`countForeignKeyReferences(javax.persistence.EntityManager entityManager, Class<T> entityType, Class<I> identifierType, I id)` Returns count of all foreign key references to entity of given entity type with given ID of given identifier type.
`static <T> T`	`getFirstResultOrNull(javax.persistence.Query query)` Returns first result of given query, or `null` if there is none.
`static <T> T`	`getFirstResultOrNull(javax.persistence.TypedQuery<T> typedQuery)` Returns first result of given typed query, or `null` if there is none.
`static <T> Optional<T>`	`getOptionalFirstResult(javax.persistence.Query query)` Returns first result of given query as `Optional`.
`static <T> Optional<T>`	`getOptionalFirstResult(javax.persistence.TypedQuery<T> typedQuery)` Returns first result of given typed query as `Optional`.
`static <T> Optional<T>`	`getOptionalSingleResult(javax.persistence.Query query)` Returns single result of given query as `Optional`.
`static <T> Optional<T>`	`getOptionalSingleResult(javax.persistence.TypedQuery<T> typedQuery)` Returns single result of given typed query as `Optional`.
`static <K,T> Map<K,T>`	`getResultMap(javax.persistence.TypedQuery<T> typedQuery, Function<? super T,? extends K> keyMapper)` Returns the result list of given typed query as a map mapped by the given key mapper.
`static <K,T,V> Map<K,V>`	`getResultMap(javax.persistence.TypedQuery<T> typedQuery, Function<? super T,? extends K> keyMapper, Function<? super T,? extends V> valueMapper)` Returns the result list of given typed query as a map mapped by the given key and value mappers.
`static <T> T`	`getSingleResultOrNull(javax.persistence.Query query)` Returns single result of given query, or `null` if there is none.
`static <T> T`	`getSingleResultOrNull(javax.persistence.TypedQuery<T> typedQuery)` Returns single result of given typed query, or `null` if there is none.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - LOAD_GRAPH_HINT_KEY
```
public static final String LOAD_GRAPH_HINT_KEY
```
    See Also:
    
    Constant Field Values
  - FETCH_GRAPH_HINT_KEY
```
public static final String FETCH_GRAPH_HINT_KEY
```
    See Also:
    
    Constant Field Values
  - CACHE_RETRIEVE_MODE_HINT_KEY
```
public static final String CACHE_RETRIEVE_MODE_HINT_KEY
```
    See Also:
    
    Constant Field Values
- Method Detail
  - getOptionalSingleResult
```
public static <T> Optional<T> getOptionalSingleResult(javax.persistence.TypedQuery<T> typedQuery)
```
    Returns single result of given typed query as Optional.
    
    Type Parameters:
    
    T - The generic result type.
    
    Parameters:
    
    typedQuery - The involved typed query.
    
    Returns:
    
    Single result of given typed query as Optional.
    
    Throws:
    
    javax.persistence.NonUniqueResultException - When there is no unique result.
  - getOptionalSingleResult
```
public static <T> Optional<T> getOptionalSingleResult(javax.persistence.Query query)
```
    Returns single result of given query as Optional.
    
    Type Parameters:
    
    T - The expected result type.
    
    Parameters:
    
    query - The involved query.
    
    Returns:
    
    Single result of given query as Optional.
    
    Throws:
    
    javax.persistence.NonUniqueResultException - When there is no unique result.
    
    ClassCastException - When T is of wrong type.
  - getSingleResultOrNull
```
public static <T> T getSingleResultOrNull(javax.persistence.TypedQuery<T> typedQuery)
```
    Returns single result of given typed query, or null if there is none.
    
    Type Parameters:
    
    T - The generic result type.
    
    Parameters:
    
    typedQuery - The involved typed query.
    
    Returns:
    
    Single result of given typed query, or null if there is none.
    
    Throws:
    
    javax.persistence.NonUniqueResultException - When there is no unique result.
  - getSingleResultOrNull
```
public static <T> T getSingleResultOrNull(javax.persistence.Query query)
```
    Returns single result of given query, or null if there is none.
    
    Type Parameters:
    
    T - The expected result type.
    
    Parameters:
    
    query - The involved query.
    
    Returns:
    
    Single result of given query, or null if there is none.
    
    Throws:
    
    javax.persistence.NonUniqueResultException - When there is no unique result.
    
    ClassCastException - When T is of wrong type.
  - getOptionalFirstResult
```
public static <T> Optional<T> getOptionalFirstResult(javax.persistence.TypedQuery<T> typedQuery)
```
    Returns first result of given typed query as Optional.
    
    Type Parameters:
    
    T - The generic result type.
    
    Parameters:
    
    typedQuery - The involved typed query.
    
    Returns:
    
    First result of given typed query as Optional.
  - getOptionalFirstResult
```
public static <T> Optional<T> getOptionalFirstResult(javax.persistence.Query query)
```
    Returns first result of given query as Optional.
    
    Type Parameters:
    
    T - The expected result type.
    
    Parameters:
    
    query - The involved query.
    
    Returns:
    
    First result of given query as Optional.
    
    Throws:
    
    ClassCastException - When T is of wrong type.
  - getFirstResultOrNull
```
public static <T> T getFirstResultOrNull(javax.persistence.TypedQuery<T> typedQuery)
```
    Returns first result of given typed query, or null if there is none.
    
    Type Parameters:
    
    T - The generic result type.
    
    Parameters:
    
    typedQuery - The involved typed query.
    
    Returns:
    
    First result of given typed query, or null if there is none.
  - getFirstResultOrNull
```
public static <T> T getFirstResultOrNull(javax.persistence.Query query)
```
    Returns first result of given query, or null if there is none.
    
    Type Parameters:
    
    T - The expected result type.
    
    Parameters:
    
    query - The involved query.
    
    Returns:
    
    First result of given query, or null if there is none.
    
    Throws:
    
    ClassCastException - When T is of wrong type.
  - getResultMap
```
public static <K,T> Map<K,T> getResultMap(javax.persistence.TypedQuery<T> typedQuery,
                                          Function<? super T,? extends K> keyMapper)
```
    Returns the result list of given typed query as a map mapped by the given key mapper.
    
    Type Parameters:
    
    K - The generic map key type.
    
    T - The generic result type, also map value type.
    
    Parameters:
    
    typedQuery - The involved typed query.
    
    keyMapper - The key mapper.
    
    Returns:
    
    The result list of given typed query as a map mapped by the given key mapper.
  - getResultMap
```
public static <K,T,V> Map<K,V> getResultMap(javax.persistence.TypedQuery<T> typedQuery,
                                            Function<? super T,? extends K> keyMapper,
                                            Function<? super T,? extends V> valueMapper)
```
    Returns the result list of given typed query as a map mapped by the given key and value mappers.
    
    Type Parameters:
    
    K - The generic map key type.
    
    T - The generic result type.
    
    V - The generic map value type.
    
    Parameters:
    
    typedQuery - The involved typed query.
    
    keyMapper - The key mapper.
    
    valueMapper - The value mapper.
    
    Returns:
    
    The result list of given typed query as a map mapped by the given key and value mappers.
  - countForeignKeyReferences
```
public static <T,I> long countForeignKeyReferences(javax.persistence.EntityManager entityManager,
                                                   Class<T> entityType,
                                                   Class<I> identifierType,
                                                   I id)
```
    Returns count of all foreign key references to entity of given entity type with given ID of given identifier type. This is particularly useful in case you intend to check if the given entity is still referenced elsewhere in database.
    
    Type Parameters:
    
    T - The generic result type.
    
    I - The generic identifier type.
    
    Parameters:
    
    entityManager - The involved entity manager.
    
    entityType - Entity type.
    
    identifierType - Identifier type.
    
    id - Entity ID.
    
    Returns:
    
    Count of all foreign key references to entity of given entity type with given ID of given identifier type.
  - concat
```
public static javax.persistence.criteria.Expression<String> concat(javax.persistence.criteria.CriteriaBuilder builder,
                                                                   Object... expressionsOrStrings)
```
    Returns a SQL CONCAT(...) of given expressions or strings.
    
    Parameters:
    
    builder - The involved criteria builder.
    
    expressionsOrStrings - Expressions or Strings.
    
    Returns:
    
    A SQL CONCAT(...) of given expressions or strings.
    
    Throws:
    
    IllegalArgumentException - When there are less than 2 expressions or strings. There's no point of concat then.
  - castAsString
```
public static javax.persistence.criteria.Expression<String> castAsString(javax.persistence.criteria.CriteriaBuilder builder,
                                                                         javax.persistence.criteria.Expression<?> expression)
```
    Returns a new expression wherein given expression is cast as String. This covers known problems with certain providers and/or databases.
    
    Parameters:
    
    builder - The involved criteria builder.
    
    expression - Expression to be cast as String.
    
    Returns:
    
    A new expression wherein given expression is cast as String.

Class JPA

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

LOAD_GRAPH_HINT_KEY

FETCH_GRAPH_HINT_KEY

CACHE_RETRIEVE_MODE_HINT_KEY

Method Detail

getOptionalSingleResult

getOptionalSingleResult

getSingleResultOrNull

getSingleResultOrNull

getOptionalFirstResult

getOptionalFirstResult

getFirstResultOrNull

getFirstResultOrNull

getResultMap

getResultMap

countForeignKeyReferences

concat

castAsString