Package com.flowlogix.jeedao

Class DaoHelper<TT,KT>

java.lang.Object

com.flowlogix.jeedao.DaoHelper<TT,KT>

Type Parameters:

TT - Entity Type

KT - Primary Key Type

public final class DaoHelper<TT,KT>
extends Object

Lightweight wrapper around common JPA methods This is the primary class in the com.flowlogix.jeedao package

Main value-add is ability to easily add hints and query criteria to findAll() and findRange(int, int) methods, as well as count() methods

Another differentiator is that this class doesn't require inheritance, although some use cases could inherit from InheritableDaoHelper class.

Simple Example:

@Stateless
public class ExampleDAO {
    @PersistenceContext
    EntityManager em;
    @Delegate
    DaoHelper<UserEntity, Long> helper = new DaoHelper<>(() -> em, UserEntity.class);
}

Author:

lprimak

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DaoHelper.DaoHelperBuilder<TT,KT>
static class	DaoHelper.Parameters<TT>

Constructor Summary

Constructors

Constructor	Description
DaoHelper(@NonNull Supplier<jakarta.persistence.EntityManager> entityManager, @NonNull Class<TT> entityClass)

Method Summary

Modifier and Type	Method	Description
static <TT, KT> DaoHelper.DaoHelperBuilder<TT,KT>	builder()
QueryCriteria<TT>	buildQueryCriteria()
<RR> QueryCriteria<RR>	buildQueryCriteria(Class<RR> cls)
int	count()
<FF extends Function<DaoHelper.Parameters.ParametersBuilder<TT>, DaoHelper.Parameters<TT>>> int	count(FF paramsBuilder)
TypedNativeQuery	createNativeQuery(String sql, Class<?> resultClass)
TypedNativeQuery	createNativeQuery(String sql, String resultMapping)
List<TT>	findAll()
<FF extends Function<DaoHelper.Parameters.ParametersBuilder<TT>, DaoHelper.Parameters<TT>>> List<TT>	findAll(FF paramsBuilder)	find all with added criteria and hints
List<TT>	findRange(int min, int max)
<FF extends Function<DaoHelper.Parameters.ParametersBuilder<TT>, DaoHelper.Parameters<TT>>> List<TT>	findRange(int min, int max, FF paramsBuilder)	find range with added criteria and hints
@NonNull Class<TT>	getEntityClass()	entity class
jakarta.persistence.EntityManager	getEntityManager()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DaoHelper

@ConstructorProperties({"entityManager","entityClass"})
public DaoHelper(@NonNull
 @NonNull Supplier<jakarta.persistence.EntityManager> entityManager,
 @NonNull
 @NonNull Class<TT> entityClass)

Method Details

findAll

public List<TT> findAll()

findAll

public <FF extends Function<DaoHelper.Parameters.ParametersBuilder<TT>,
DaoHelper.Parameters<TT>>>
List<TT> findAll(FF paramsBuilder)

find all with added criteria and hints

Example:

findAll(builder -> builder.build())

Parameters:

paramsBuilder -

Returns:

findRange

public List<TT> findRange(int min,
 int max)

findRange

public <FF extends Function<DaoHelper.Parameters.ParametersBuilder<TT>,
DaoHelper.Parameters<TT>>>
List<TT> findRange(int min,
 int max,
 FF paramsBuilder)

find range with added criteria and hints

Parameters:

min -

max -

paramsBuilder -

Returns:

count

public int count()

count

public <FF extends Function<DaoHelper.Parameters.ParametersBuilder<TT>,
DaoHelper.Parameters<TT>>>
int count(FF paramsBuilder)

getEntityManager

public jakarta.persistence.EntityManager getEntityManager()

Returns:

entity manager

buildQueryCriteria

public QueryCriteria<TT> buildQueryCriteria()

buildQueryCriteria

public <RR> QueryCriteria<RR> buildQueryCriteria(Class<RR> cls)

createNativeQuery

public TypedNativeQuery createNativeQuery(String sql,
 Class<?> resultClass)

createNativeQuery

public TypedNativeQuery createNativeQuery(String sql,
 String resultMapping)

builder

public static <TT,
KT>
DaoHelper.DaoHelperBuilder<TT,KT> builder()

getEntityClass

@NonNull
public @NonNull Class<TT> getEntityClass()

entity class