io.github.jhipster.service

Class QueryService<ENTITY>

java.lang.Object

io.github.jhipster.service.QueryService<ENTITY>

Type Parameters:

ENTITY - the type of the entity which is queried.

@Transactional(readOnly=true)
public abstract class QueryService<ENTITY>
extends Object

Base service for constructing and executing complex queries.

Constructor Summary

Constructors

Constructor and Description
QueryService()

Method Summary

Modifier and Type	Method and Description
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	buildRangeSpecification(RangeFilter<X> filter, javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field) Helper function to return a specification for filtering on a single Comparable, where equality, less than, greater than and less-than-or-equal-to and greater-than-or-equal-to and null/non-null conditions are supported.
protected <OTHER,MISC,X> org.springframework.data.jpa.domain.Specification<ENTITY>	buildReferringEntitySpecification(Filter<X> filter, Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.SetJoin<MISC,OTHER>> functionToEntity, Function<javax.persistence.criteria.SetJoin<MISC,OTHER>,javax.persistence.criteria.Expression<X>> entityToColumn) Helper function to return a specification for filtering on one-to-many or many-to-many reference.
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY>	buildReferringEntitySpecification(Filter<X> filter, javax.persistence.metamodel.SetAttribute<ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField) Helper function to return a specification for filtering on one-to-many or many-to-many reference.
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY>	buildReferringEntitySpecification(Filter<X> filter, javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<? super OTHER,X> valueField) Helper function to return a specification for filtering on one-to-one or many-to-one reference.
protected <OTHER,MISC,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	buildReferringEntitySpecification(RangeFilter<X> filter, Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.SetJoin<MISC,OTHER>> functionToEntity, Function<javax.persistence.criteria.SetJoin<MISC,OTHER>,javax.persistence.criteria.Expression<X>> entityToColumn) Helper function to return a specification for filtering on one-to-many or many-to-many reference.
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	buildReferringEntitySpecification(RangeFilter<X> filter, javax.persistence.metamodel.SetAttribute<ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField) Helper function to return a specification for filtering on one-to-many or many-to-many reference.
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	buildReferringEntitySpecification(RangeFilter<X> filter, javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField) Deprecated. just call buildSpecification(filter, root -> root.get(reference).get(valueField))
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	buildSpecification(Filter<X> filter, Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction) Helper function to return a specification for filtering on a single field, where equality, and null/non-null conditions are supported.
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	buildSpecification(Filter<X> filter, javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field) Helper function to return a specification for filtering on a single field, where equality, and null/non-null conditions are supported.
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	buildSpecification(RangeFilter<X> filter, Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction) Helper function to return a specification for filtering on a single Comparable, where equality, less than, greater than and less-than-or-equal-to and greater-than-or-equal-to and null/non-null conditions are supported.
protected org.springframework.data.jpa.domain.Specification<ENTITY>	buildSpecification(StringFilter filter, Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<String>> metaclassFunction) Helper function to return a specification for filtering on a String field, where equality, containment, and null/non-null conditions are supported.
protected org.springframework.data.jpa.domain.Specification<ENTITY>	buildStringSpecification(StringFilter filter, javax.persistence.metamodel.SingularAttribute<? super ENTITY,String> field) Helper function to return a specification for filtering on a String field, where equality, containment, and null/non-null conditions are supported.
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	byFieldEmptiness(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<Set<X>>> metaclassFunction, boolean specified)
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	byFieldSpecified(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction, boolean specified)
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	byFieldSpecified(javax.persistence.metamodel.SetAttribute<ENTITY,X> field, boolean specified) Deprecated. Just call the byFieldEmptiness(root -> root.get(field), value) directly.
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	byFieldSpecified(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field, boolean specified) Deprecated. Just call the byFieldSpecified(root -> root.get(field), value) directly.
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY>	equalsSetSpecification(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> idField, X value) Deprecated. Just call the equalsSpecification(root -> root.join(reference).get(valueField), value) directly.
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	equalsSpecification(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction, X value) Generic method, which based on a Root<ENTITY> returns an Expression which type is the same as the given 'value' type.
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY>	equalsSpecification(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<? super OTHER,X> valueField, X value) Deprecated. Just call the equalsSpecification(root -> root.get(reference).get(valueField), value) directly.
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	equalsSpecification(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field, X value) Deprecated. Just call the equalsSpecification(root -> root.get(field), value) directly.
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	greaterThan(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction, X value)
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	greaterThan(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField, X value) Deprecated. Just call the greaterThan(root -> root.join(reference).get(valueField), value) directly.
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	greaterThan(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField, X value) Deprecated. Just call the greaterThan(root -> root.get(reference).get(valueField), value) directly.
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	greaterThan(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field, X value) Deprecated. Just call the greaterThan(root -> root.get(field), value) directly.
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	greaterThanOrEqualTo(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction, X value)
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	greaterThanOrEqualTo(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField, X value) Deprecated. Just call the greaterThanOrEqualTo(root -> root.join(reference).get(valueField), value) directly.
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	greaterThanOrEqualTo(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField, X value) Deprecated. Just call the greaterThanOrEqualTo(root -> root.get(reference).get(valueField), value) directly.
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	greaterThanOrEqualTo(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field, X value) Deprecated. Just call the greaterThanOrEqualTo(root -> root.get(field), value) directly.
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	lessThan(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction, X value)
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	lessThan(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField, X value) Deprecated. Just call the lessThan(root -> root.join(reference).get(valueField), value) directly.
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	lessThan(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField, X value) Deprecated. Just call the lessThan(root -< root.get(reference).get(valueField), value) directly.
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	lessThan(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field, X value) Deprecated. Just call the lessThan(root -> root.get(field), value) directly.
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	lessThanOrEqualTo(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction, X value)
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	lessThanOrEqualTo(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField, X value) Deprecated. Just call the lessThanOrEqualTo(root -> root.join(reference).get(valueField), value) directly.
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	lessThanOrEqualTo(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField, X value) Deprecated. Just call the lessThanOrEqualTo(root -> root.get(reference).get(valueField), value) directly.
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY>	lessThanOrEqualTo(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field, X value) Deprecated. Just call the lessThanOrEqualTo(root -> root.get(field), value) directly.
protected org.springframework.data.jpa.domain.Specification<ENTITY>	likeUpperSpecification(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<String>> metaclassFunction, String value)
protected org.springframework.data.jpa.domain.Specification<ENTITY>	likeUpperSpecification(javax.persistence.metamodel.SingularAttribute<? super ENTITY,String> field, String value) Deprecated. Just call the likeUpperSpecification(root -> root.get(field), value) directly.
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	valueIn(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction, Collection<X> values)
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY>	valueIn(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField, Collection<X> values) Deprecated. Just call the valueIn(root -> root.get(reference).get(valueField), value) directly.
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY>	valueIn(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference, javax.persistence.metamodel.SingularAttribute<? super OTHER,X> valueField, Collection<X> values) Deprecated. Just call the valueIn(root -> root.get(reference).get(valueField), value) directly.
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY>	valueIn(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field, Collection<X> values) Deprecated. Just call the valueIn(root -> root.get(field), value) directly.
protected String	wrapLikeQuery(String txt)

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryService

public QueryService()

Method Detail

buildSpecification

protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> buildSpecification(Filter<X> filter,
                                                                                           javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field)

Helper function to return a specification for filtering on a single field, where equality, and null/non-null conditions are supported.

Type Parameters:

X - The type of the attribute which is filtered.

Parameters:

filter - the individual attribute filter coming from the frontend.

field - the JPA static metamodel representing the field.

Returns:

a Specification

buildSpecification

protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> buildSpecification(Filter<X> filter,
                                                                                           Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction)

Helper function to return a specification for filtering on a single field, where equality, and null/non-null conditions are supported.

Type Parameters:

X - The type of the attribute which is filtered.

Parameters:

filter - the individual attribute filter coming from the frontend.

metaclassFunction - the function, which navigates from the current entity to a column, for which the filter applies.

Returns:

a Specification

buildStringSpecification

protected org.springframework.data.jpa.domain.Specification<ENTITY> buildStringSpecification(StringFilter filter,
                                                                                             javax.persistence.metamodel.SingularAttribute<? super ENTITY,String> field)

Helper function to return a specification for filtering on a String field, where equality, containment, and null/non-null conditions are supported.

Parameters:

filter - the individual attribute filter coming from the frontend.

field - the JPA static metamodel representing the field.

Returns:

a Specification

buildSpecification

protected org.springframework.data.jpa.domain.Specification<ENTITY> buildSpecification(StringFilter filter,
                                                                                       Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<String>> metaclassFunction)

Helper function to return a specification for filtering on a String field, where equality, containment, and null/non-null conditions are supported.

Parameters:

filter - the individual attribute filter coming from the frontend.

metaclassFunction - lambda, which based on a Root<ENTITY> returns Expression - basicaly picks a column

Returns:

a Specification

buildRangeSpecification

protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> buildRangeSpecification(RangeFilter<X> filter,
                                                                                                                              javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field)

Helper function to return a specification for filtering on a single Comparable, where equality, less than, greater than and less-than-or-equal-to and greater-than-or-equal-to and null/non-null conditions are supported.

Type Parameters:

X - The type of the attribute which is filtered.

Parameters:

filter - the individual attribute filter coming from the frontend.

field - the JPA static metamodel representing the field.

Returns:

a Specification

buildSpecification

protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> buildSpecification(RangeFilter<X> filter,
                                                                                                                         Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction)

Helper function to return a specification for filtering on a single Comparable, where equality, less than, greater than and less-than-or-equal-to and greater-than-or-equal-to and null/non-null conditions are supported.

Type Parameters:

X - The type of the attribute which is filtered.

Parameters:

filter - the individual attribute filter coming from the frontend.

metaclassFunction - lambda, which based on a Root<ENTITY> returns Expression - basicaly picks a column

Returns:

a Specification

buildReferringEntitySpecification

protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY> buildReferringEntitySpecification(Filter<X> filter,
                                                                                                                javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference,
                                                                                                                javax.persistence.metamodel.SingularAttribute<? super OTHER,X> valueField)

Helper function to return a specification for filtering on one-to-one or many-to-one reference. Usage:

   Specification<Employee> specByProjectId = buildReferringEntitySpecification(criteria.getProjectId(),
 Employee_.project, Project_.id);
   Specification<Employee> specByProjectName = buildReferringEntitySpecification(criteria.getProjectName(),
 Employee_.project, Project_.name);
 

Type Parameters:

OTHER - The type of the referenced entity.

X - The type of the attribute which is filtered.

Parameters:

filter - the filter object which contains a value, which needs to match or a flag if nullness is checked.

reference - the attribute of the static metamodel for the referring entity.

valueField - the attribute of the static metamodel of the referred entity, where the equality should be checked.

Returns:

a Specification

buildReferringEntitySpecification

@Deprecated
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> buildReferringEntitySpecification(RangeFilter<X> filter,
                                                                                                                                                          javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference,
                                                                                                                                                          javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField)

Deprecated. just call buildSpecification(filter, root -> root.get(reference).get(valueField))

Helper function to return a specification for filtering on one-to-one or many-to-one reference. Where equality, less than, greater than and less-than-or-equal-to and greater-than-or-equal-to and null/non-null conditions are supported. Usage:

   Specification<Employee> specByProjectId = buildReferringEntitySpecification(criteria.getProjectId(),
 Employee_.project, Project_.id);
   Specification<Employee> specByProjectName = buildReferringEntitySpecification(criteria.getProjectName(),
 Employee_.project, Project_.name);
 

Type Parameters:

OTHER - The type of the referenced entity.

X - The type of the attribute which is filtered.

Parameters:

filter - the filter object which contains a value, which needs to match or a flag if nullness is checked.

reference - the attribute of the static metamodel for the referring entity.

valueField - the attribute of the static metamodel of the referred entity, where the equality should be checked.

Returns:

a Specification

buildReferringEntitySpecification

protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY> buildReferringEntitySpecification(Filter<X> filter,
                                                                                                                javax.persistence.metamodel.SetAttribute<ENTITY,OTHER> reference,
                                                                                                                javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField)

Helper function to return a specification for filtering on one-to-many or many-to-many reference. Usage:

   Specification<Employee> specByEmployeeId = buildReferringEntitySpecification(criteria.getEmployeId(),
 Project_.employees, Employee_.id);
   Specification<Employee> specByEmployeeName = buildReferringEntitySpecification(criteria.getEmployeName(),
 Project_.project, Project_.name);
 

Type Parameters:

OTHER - The type of the referenced entity.

X - The type of the attribute which is filtered.

Parameters:

filter - the filter object which contains a value, which needs to match or a flag if emptiness is checked.

reference - the attribute of the static metamodel for the referring entity.

valueField - the attribute of the static metamodel of the referred entity, where the equality should be checked.

Returns:

a Specification

buildReferringEntitySpecification

protected <OTHER,MISC,X> org.springframework.data.jpa.domain.Specification<ENTITY> buildReferringEntitySpecification(Filter<X> filter,
                                                                                                                     Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.SetJoin<MISC,OTHER>> functionToEntity,
                                                                                                                     Function<javax.persistence.criteria.SetJoin<MISC,OTHER>,javax.persistence.criteria.Expression<X>> entityToColumn)

Helper function to return a specification for filtering on one-to-many or many-to-many reference. Usage:

   Specification<Employee> specByEmployeeId = buildReferringEntitySpecification(
          criteria.getEmployeId(),
          root -> root.get(Project_.company).join(Company_.employees),
          entity -> entity.get(Employee_.id));
   Specification<Employee> specByProjectName = buildReferringEntitySpecification(
          criteria.getProjectName(),
          root -> root.get(Project_.project)
          entity -> entity.get(Project_.name));
 

Type Parameters:

OTHER - The type of the referenced entity.

X - The type of the attribute which is filtered.

Parameters:

filter - the filter object which contains a value, which needs to match or a flag if emptiness is checked.

functionToEntity - the function, which joins he current entity to the entity set, on which the filtering is applied.

entityToColumn - the function, which of the static metamodel of the referred entity, where the equality should be checked.

Returns:

a Specification

buildReferringEntitySpecification

protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> buildReferringEntitySpecification(RangeFilter<X> filter,
                                                                                                                                              javax.persistence.metamodel.SetAttribute<ENTITY,OTHER> reference,
                                                                                                                                              javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField)

Helper function to return a specification for filtering on one-to-many or many-to-many reference. Where equality, less than, greater than and less-than-or-equal-to and greater-than-or-equal-to and null/non-null conditions are supported. Usage:

   Specification<Employee> specByEmployeeId = buildReferringEntitySpecification(criteria.getEmployeId(),
 Project_.employees, Employee_.id);
   Specification<Employee> specByEmployeeName = buildReferringEntitySpecification(criteria.getEmployeName(),
 Project_.project, Project_.name);
 

Type Parameters:

OTHER - The type of the referenced entity.

X - The type of the attribute which is filtered.

Parameters:

filter - the filter object which contains a value, which needs to match or a flag if emptiness is checked.

reference - the attribute of the static metamodel for the referring entity.

valueField - the attribute of the static metamodel of the referred entity, where the equality should be checked.

Returns:

a Specification

buildReferringEntitySpecification

protected <OTHER,MISC,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> buildReferringEntitySpecification(RangeFilter<X> filter,
                                                                                                                                                   Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.SetJoin<MISC,OTHER>> functionToEntity,
                                                                                                                                                   Function<javax.persistence.criteria.SetJoin<MISC,OTHER>,javax.persistence.criteria.Expression<X>> entityToColumn)

Helper function to return a specification for filtering on one-to-many or many-to-many reference. Where equality, less than, greater than and less-than-or-equal-to and greater-than-or-equal-to and null/non-null conditions are supported. Usage:

   Specification<Employee> specByEmployeeId = buildReferringEntitySpecification(
          criteria.getEmployeId(),
          root -> root.get(Project_.company).join(Company_.employees),
          entity -> entity.get(Employee_.id));
   Specification<Employee> specByProjectName = buildReferringEntitySpecification(
          criteria.getProjectName(),
          root -> root.get(Project_.project)
          entity -> entity.get(Project_.name));
 
 

Type Parameters:

OTHER - The type of the referenced entity.

MISC - The type of the entity which is the last before the OTHER in the chain.

X - The type of the attribute which is filtered.

Parameters:

filter - the filter object which contains a value, which needs to match or a flag if emptiness is checked.

functionToEntity - the function, which joins he current entity to the entity set, on which the filtering is applied.

entityToColumn - the function, which of the static metamodel of the referred entity, where the equality should be checked.

Returns:

a Specification

equalsSpecification

protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> equalsSpecification(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction,
                                                                                            X value)

Generic method, which based on a Root<ENTITY> returns an Expression which type is the same as the given 'value' type.

Parameters:

metaclassFunction - function which returns the column which is used for filtering.

value - the actual value to filter for.

Returns:

a Specification.

equalsSpecification

protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> equalsSpecification(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field,
                                                                                            X value)

Deprecated. Just call the equalsSpecification(root -> root.get(field), value) directly.

equalsSpecification

@Deprecated
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY> equalsSpecification(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference,
                                                                                                              javax.persistence.metamodel.SingularAttribute<? super OTHER,X> valueField,
                                                                                                              X value)

Deprecated. Just call the equalsSpecification(root -> root.get(reference).get(valueField), value) directly.

equalsSetSpecification

@Deprecated
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY> equalsSetSpecification(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference,
                                                                                                                 javax.persistence.metamodel.SingularAttribute<OTHER,X> idField,
                                                                                                                 X value)

Deprecated. Just call the equalsSpecification(root -> root.join(reference).get(valueField), value) directly.

likeUpperSpecification

protected org.springframework.data.jpa.domain.Specification<ENTITY> likeUpperSpecification(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<String>> metaclassFunction,
                                                                                           String value)

likeUpperSpecification

protected org.springframework.data.jpa.domain.Specification<ENTITY> likeUpperSpecification(javax.persistence.metamodel.SingularAttribute<? super ENTITY,String> field,
                                                                                           String value)

Deprecated. Just call the likeUpperSpecification(root -> root.get(field), value) directly.

byFieldSpecified

protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> byFieldSpecified(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction,
                                                                                         boolean specified)

byFieldSpecified

@Deprecated
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> byFieldSpecified(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field,
                                                                                                     boolean specified)

Deprecated. Just call the byFieldSpecified(root -> root.get(field), value) directly.

byFieldEmptiness

protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> byFieldEmptiness(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<Set<X>>> metaclassFunction,
                                                                                         boolean specified)

byFieldSpecified

@Deprecated
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> byFieldSpecified(javax.persistence.metamodel.SetAttribute<ENTITY,X> field,
                                                                                                     boolean specified)

Deprecated. Just call the byFieldEmptiness(root -> root.get(field), value) directly.

valueIn

protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> valueIn(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction,
                                                                                Collection<X> values)

valueIn

@Deprecated
protected <X> org.springframework.data.jpa.domain.Specification<ENTITY> valueIn(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field,
                                                                                            Collection<X> values)

Deprecated. Just call the valueIn(root -> root.get(field), value) directly.

valueIn

@Deprecated
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY> valueIn(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference,
                                                                                                  javax.persistence.metamodel.SingularAttribute<? super OTHER,X> valueField,
                                                                                                  Collection<X> values)

Deprecated. Just call the valueIn(root -> root.get(reference).get(valueField), value) directly.

greaterThanOrEqualTo

protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> greaterThanOrEqualTo(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction,
                                                                                                                           X value)

greaterThan

protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> greaterThan(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction,
                                                                                                                  X value)

lessThanOrEqualTo

protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> lessThanOrEqualTo(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction,
                                                                                                                        X value)

lessThan

protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> lessThan(Function<javax.persistence.criteria.Root<ENTITY>,javax.persistence.criteria.Expression<X>> metaclassFunction,
                                                                                                               X value)

greaterThanOrEqualTo

@Deprecated
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> greaterThanOrEqualTo(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field,
                                                                                                                                       X value)

Deprecated. Just call the greaterThanOrEqualTo(root -> root.get(field), value) directly.

greaterThan

@Deprecated
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> greaterThan(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field,
                                                                                                                              X value)

Deprecated. Just call the greaterThan(root -> root.get(field), value) directly.

lessThanOrEqualTo

@Deprecated
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> lessThanOrEqualTo(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field,
                                                                                                                                    X value)

Deprecated. Just call the lessThanOrEqualTo(root -> root.get(field), value) directly.

lessThan

@Deprecated
protected <X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> lessThan(javax.persistence.metamodel.SingularAttribute<? super ENTITY,X> field,
                                                                                                                           X value)

Deprecated. Just call the lessThan(root -> root.get(field), value) directly.

wrapLikeQuery

protected String wrapLikeQuery(String txt)

valueIn

@Deprecated
protected <OTHER,X> org.springframework.data.jpa.domain.Specification<ENTITY> valueIn(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference,
                                                                                                  javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField,
                                                                                                  Collection<X> values)

Deprecated. Just call the valueIn(root -> root.get(reference).get(valueField), value) directly.

greaterThan

@Deprecated
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> greaterThan(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference,
                                                                                                                                    javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField,
                                                                                                                                    X value)

Deprecated. Just call the greaterThan(root -> root.get(reference).get(valueField), value) directly.

greaterThan

@Deprecated
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> greaterThan(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference,
                                                                                                                                    javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField,
                                                                                                                                    X value)

Deprecated. Just call the greaterThan(root -> root.join(reference).get(valueField), value) directly.

greaterThanOrEqualTo

@Deprecated
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> greaterThanOrEqualTo(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference,
                                                                                                                                             javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField,
                                                                                                                                             X value)

Deprecated. Just call the greaterThanOrEqualTo(root -> root.get(reference).get(valueField), value) directly.

greaterThanOrEqualTo

@Deprecated
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> greaterThanOrEqualTo(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference,
                                                                                                                                             javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField,
                                                                                                                                             X value)

Deprecated. Just call the greaterThanOrEqualTo(root -> root.join(reference).get(valueField), value) directly.

lessThan

@Deprecated
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> lessThan(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference,
                                                                                                                                 javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField,
                                                                                                                                 X value)

Deprecated. Just call the lessThan(root -< root.get(reference).get(valueField), value) directly.

lessThan

@Deprecated
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> lessThan(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference,
                                                                                                                                 javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField,
                                                                                                                                 X value)

Deprecated. Just call the lessThan(root -> root.join(reference).get(valueField), value) directly.

lessThanOrEqualTo

@Deprecated
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> lessThanOrEqualTo(javax.persistence.metamodel.SingularAttribute<? super ENTITY,OTHER> reference,
                                                                                                                                          javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField,
                                                                                                                                          X value)

Deprecated. Just call the lessThanOrEqualTo(root -> root.get(reference).get(valueField), value) directly.

lessThanOrEqualTo

@Deprecated
protected <OTHER,X extends Comparable<? super X>> org.springframework.data.jpa.domain.Specification<ENTITY> lessThanOrEqualTo(javax.persistence.metamodel.SetAttribute<? super ENTITY,OTHER> reference,
                                                                                                                                          javax.persistence.metamodel.SingularAttribute<OTHER,X> valueField,
                                                                                                                                          X value)

Deprecated. Just call the lessThanOrEqualTo(root -> root.join(reference).get(valueField), value) directly.