com.jaxio.jpa.querybyexample.SearchParameters Maven / Gradle / Ivy
Show all versions of javaee7-jpa-query-by-example Show documentation
/*
* Copyright 2015 JAXIO http://www.jaxio.com
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.jaxio.jpa.querybyexample;
import com.google.common.base.Function;
import org.apache.commons.lang.builder.ToStringBuilder;
import javax.persistence.metamodel.Attribute;
import javax.persistence.metamodel.SingularAttribute;
import java.io.Serializable;
import java.util.List;
import java.util.Map;
import java.util.Set;
import static com.google.common.base.Preconditions.checkNotNull;
import static com.google.common.collect.Lists.newArrayList;
import static com.google.common.collect.Lists.transform;
import static com.google.common.collect.Maps.newHashMap;
import static com.google.common.collect.Sets.newHashSet;
import static com.jaxio.jpa.querybyexample.PropertySelector.newPropertySelector;
import static org.apache.commons.lang.StringUtils.isNotBlank;
/*
* The SearchParameters is used to pass search parameters to the DAO layer.
*
* Its usage keeps 'find' method signatures in the DAO/Service layer simple.
*
* A SearchParameters helps you drive your search in the following areas:
*
* - Configure the search mode (EQUALS, LIKE, ...)
* - Pagination: it allows you to limit your search results to a specific range.
* - Allow you to specify ORDER BY and ASC/DESC
* - Enable/disable case sensitivity
* - Enable/disable 2d level cache
* - LIKE search against all string values: simply set the searchPattern property
* - Named query: if you set a named query it will be executed. Named queries can be defined in annotation or src/main/resources/META-INF/orm.xml
* - FullTextSearch: simply set the term property (requires Hibernate Search)
*
*
* Note : All requests are limited to a maximum number of elements to prevent resource exhaustion.
*
* @see SearchMode
* @see OrderBy
* @see Range
* @see PropertySelector
*/
public class SearchParameters implements Serializable {
private static final long serialVersionUID = 1L;
private SearchMode searchMode = SearchMode.EQUALS;
private boolean andMode = true;
// named query related
private String namedQuery;
private Map parameters = newHashMap();
private Set orders = newHashSet();
// technical parameters
private boolean caseSensitive = true;
// pagination
private int maxResults = -1;
private int first = 0;
private int pageSize = 0;
// fetches
private Set fetches = newHashSet();
// ranges
private List> ranges = newArrayList();
// property selectors
private List> properties = newArrayList();
// pattern to match against all strings.
private String searchPattern;
// hibernate search terms
private List terms = newArrayList();
private Float searchSimilarity = 0.5f;
private LuceneQueryBuilder luceneQueryBuilder = new DefaultLuceneQueryBuilder();
// Warn: before enabling cache for queries,
// check this: https://hibernate.atlassian.net/browse/HHH-1523
private Boolean cacheable = false;
private String cacheRegion;
// extra parameters
private Map extraParameters = newHashMap();
private boolean useAndInXToMany = true;
private boolean useDistinct = false;
// -----------------------------------
// SearchMode
// -----------------------------------
/*
* Fluently set the @{link SearchMode}. It defaults to EQUALS.
*
* @param searchMode searchmode
* @see SearchMode#EQUALS
*/
public void setSearchMode(SearchMode searchMode) {
this.searchMode = checkNotNull(searchMode);
}
/*
* Return the @{link SearchMode}. It defaults to EQUALS.
*
* @see SearchMode#EQUALS
*/
public SearchMode getSearchMode() {
return searchMode;
}
public boolean is(SearchMode searchMode) {
return getSearchMode() == searchMode;
}
/*
* Fluently set the @{link SearchMode}. It defaults to EQUALS.
*
* @param searchMode searchmode
* @see SearchMode#EQUALS
*/
public SearchParameters searchMode(SearchMode searchMode) {
setSearchMode(searchMode);
return this;
}
/*
* Use the EQUALS @{link SearchMode}.
*
* @param searchMode searchmode
* @see SearchMode#EQUALS
*/
public SearchParameters equals() {
return searchMode(SearchMode.EQUALS);
}
/*
* Use the ANYWHERE @{link SearchMode}.
*
* @param searchMode searchmode
* @see SearchMode#ANYWHERE
*/
public SearchParameters anywhere() {
return searchMode(SearchMode.ANYWHERE);
}
/*
* Use the STARTING_LIKE @{link SearchMode}.
*
* @see SearchMode#STARTING_LIKE
*/
public SearchParameters startingLike() {
return searchMode(SearchMode.STARTING_LIKE);
}
/*
* Use the LIKE @{link SearchMode}.
*
* @see SearchMode#LIKE
*/
public SearchParameters like() {
return searchMode(SearchMode.LIKE);
}
/*
* Use the ENDING_LIKE @{link SearchMode}.
*
* @see SearchMode#ENDING_LIKE
*/
public SearchParameters endingLike() {
return searchMode(SearchMode.ENDING_LIKE);
}
// -----------------------------------
// Predicate mode
// -----------------------------------
public void setAndMode(boolean andMode) {
this.andMode = andMode;
}
public boolean isAndMode() {
return andMode;
}
/*
* use and to build the final predicate
*/
public SearchParameters andMode() {
setAndMode(true);
return this;
}
/*
* use or to build the final predicate
*/
public SearchParameters orMode() {
setAndMode(false);
return this;
}
// -----------------------------------
// Named query support
// -----------------------------------
/*
* Returns true if a named query has been set, false otherwise. When it returns true, the DAO layer will call the namedQuery.
*/
public boolean hasNamedQuery() {
return isNotBlank(namedQuery);
}
/*
* Set the named query to be used by the DAO layer. Null by default.
*/
public void setNamedQuery(String namedQuery) {
this.namedQuery = namedQuery;
}
/*
* Return the name of the named query to be used by the DAO layer.
*/
public String getNamedQuery() {
return namedQuery;
}
/*
* Set the parameters for the named query.
*/
public void setNamedQueryParameters(Map parameters) {
this.parameters = checkNotNull(parameters);
}
/*
* Set the parameters for the named query.
*/
public void addNamedQueryParameter(String name, Object value) {
parameters.put(checkNotNull(name), checkNotNull(value));
}
/*
* The parameters associated with the named query, if any.
*/
public Map getNamedQueryParameters() {
return parameters;
}
/*
* Return the value of the given parameter name.
*/
public Object getNamedQueryParameter(String parameterName) {
return parameters.get(checkNotNull(parameterName));
}
/*
* Fluently set the named query to be used by the DAO layer. Null by default.
*/
public SearchParameters namedQuery(String namedQuery) {
setNamedQuery(namedQuery);
return this;
}
/*
* Fluently set the parameters for the named query.
*/
public SearchParameters namedQueryParameters(Map parameters) {
setNamedQueryParameters(parameters);
return this;
}
/*
* Fluently set the parameter for the named query.
*/
public SearchParameters namedQueryParameter(String name, Object value) {
addNamedQueryParameter(name, value);
return this;
}
// -----------------------------------
// Search pattern support
// -----------------------------------
/*
* When it returns true, it indicates to the DAO layer to use the given searchPattern on all string properties.
*/
public boolean hasSearchPattern() {
return isNotBlank(searchPattern);
}
/*
* Set the pattern which may contains wildcards (ex: e%r%ka ).
*
* The given searchPattern is used by the DAO layer on all string properties. Null by default.
*/
public void setSearchPattern(String searchPattern) {
this.searchPattern = searchPattern;
}
public SearchParameters searchPattern(String searchPattern) {
setSearchPattern(searchPattern);
return this;
}
public String getSearchPattern() {
return searchPattern;
}
// -----------------------------------
// Terms support (hibernate search)
// -----------------------------------
public void addTerm(TermSelector term) {
terms.add(checkNotNull(term));
}
public List getTerms() {
return terms;
}
public boolean hasTerms() {
return !terms.isEmpty();
}
public Float getSearchSimilarity() {
return searchSimilarity;
}
public void setSearchSimilarity(Float searchSimilarity) {
this.searchSimilarity = searchSimilarity;
}
public LuceneQueryBuilder getLuceneQueryBuilder() {
return luceneQueryBuilder;
}
public void setLuceneQueryBuilder(LuceneQueryBuilder luceneQueryBuilder) {
this.luceneQueryBuilder = checkNotNull(luceneQueryBuilder);
}
public SearchParameters term(TermSelector... terms) {
for (TermSelector term : checkNotNull(terms)) {
addTerm(term);
}
return this;
}
public SearchParameters term(String... selected) {
return term(new TermSelector().selected(selected));
}
public SearchParameters term(SingularAttribute attribute, String... selected) {
return term(new TermSelector(attribute).selected(selected));
}
/*
* Specify the similarity for the indexed properties, {@link #searchSimilarity} is between 0f and 1f
*/
public SearchParameters searchSimilarity(Float searchSimilarity) {
setSearchSimilarity(searchSimilarity);
return this;
}
public SearchParameters luceneQueryBuilder(LuceneQueryBuilder luceneQueryBuilder) {
setLuceneQueryBuilder(luceneQueryBuilder);
return this;
}
// -----------------------------------
// Case sensitiveness support
// -----------------------------------
/*
* Set the case sensitiveness. Defaults to false.
*
* @param caseSensitive caseSensitive
*/
public void setCaseSensitive(boolean caseSensitive) {
this.caseSensitive = caseSensitive;
}
public boolean isCaseSensitive() {
return caseSensitive;
}
public boolean isCaseInsensitive() {
return !caseSensitive;
}
/*
* Fluently set the case sensitiveness. Defaults to false.
*
* @param caseSensitive caseSensitive
*/
public SearchParameters caseSensitive(boolean caseSensitive) {
setCaseSensitive(caseSensitive);
return this;
}
/*
* Fluently set the case sensitiveness to true.
*/
public SearchParameters caseSensitive() {
return caseSensitive(true);
}
/*
* Fluently set the case sensitiveness to false.
*/
public SearchParameters caseInsensitive() {
return caseSensitive(false);
}
// -----------------------------------
// Order by support
// -----------------------------------
public List getOrders() {
return newArrayList(orders);
}
public void addOrderBy(OrderBy orderBy) {
if (!orders.add(checkNotNull(orderBy))) {
throw new IllegalArgumentException("Duplicate orderBy: '" + orderBy + "'.");
}
}
public boolean hasOrders() {
return !orders.isEmpty();
}
public SearchParameters orderBy(OrderBy... orderBys) {
for (OrderBy orderBy : checkNotNull(orderBys)) {
addOrderBy(orderBy);
}
return this;
}
public SearchParameters asc(Attribute... attributes) {
return orderBy(new OrderBy(OrderByDirection.ASC, attributes));
}
public SearchParameters desc(Attribute... attributes) {
return orderBy(new OrderBy(OrderByDirection.DESC, attributes));
}
public SearchParameters orderBy(OrderByDirection orderByDirection, Attribute... attributes) {
return orderBy(new OrderBy(orderByDirection, attributes));
}
public SearchParameters asc(String property, Class from) {
return orderBy(new OrderBy(OrderByDirection.ASC, property, from));
}
public SearchParameters desc(String property, Class from) {
return orderBy(new OrderBy(OrderByDirection.DESC, property, from));
}
public SearchParameters orderBy(OrderByDirection orderByDirection, String property, Class from) {
return orderBy(new OrderBy(orderByDirection, property, from));
}
// -----------------------------------
// Search by range support
// -----------------------------------
public List> getRanges() {
return ranges;
}
public void addRange(Range range) {
ranges.add(checkNotNull(range));
}
public boolean hasRanges() {
return !ranges.isEmpty();
}
public SearchParameters range(Range... ranges) {
for (Range range : checkNotNull(ranges)) {
addRange(range);
}
return this;
}
public > SearchParameters range(D from, D to, Attribute... attributes) {
return range(new Range(from, to, attributes));
}
// -----------------------------------
// Search by property selector support
// -----------------------------------
public List> getProperties() {
return properties;
}
public void addProperty(PropertySelector propertySelector) {
properties.add(checkNotNull(propertySelector));
}
public boolean hasProperties() {
return !properties.isEmpty();
}
public SearchParameters property(PropertySelector... propertySelectors) {
for (PropertySelector propertySelector : checkNotNull(propertySelectors)) {
addProperty(propertySelector);
}
return this;
}
public SearchParameters property(Attribute fields, F... selected) {
return property(newPropertySelector(fields).selected(selected));
}
// -----------------------------------
// Pagination support
// -----------------------------------
/*
* Set the maximum number of results to retrieve. Pass -1 for no limits.
*/
public void setMaxResults(int maxResults) {
this.maxResults = maxResults;
}
public int getMaxResults() {
return maxResults;
}
/*
* Set the position of the first result to retrieve.
*
* @param first position of the first result, numbered from 0
*/
public void setFirst(int first) {
this.first = first;
}
public int getFirst() {
return first;
}
/*
* Set the page size, that is the maximum number of result to retrieve.
*/
public void setPageSize(int pageSize) {
this.pageSize = pageSize;
}
public int getPageSize() {
return pageSize;
}
public SearchParameters maxResults(int maxResults) {
setMaxResults(maxResults);
return this;
}
public SearchParameters noLimit() {
setMaxResults(-1);
return this;
}
public SearchParameters limitBroadSearch() {
setMaxResults(500);
return this;
}
public SearchParameters first(int first) {
setFirst(first);
return this;
}
public SearchParameters pageSize(int pageSize) {
setPageSize(pageSize);
return this;
}
// -----------------------------------------
// Fetch associated entity using a LEFT Join
// -----------------------------------------
/*
* Returns the attributes (x-to-one association) which must be fetched with a left join.
*/
public List>> getFetches() {
return transform(newArrayList(fetches), new Function>>() {
public List> apply(PathHolder input) {
return input.getAttributes();
}
});
}
public boolean hasFetches() {
return !fetches.isEmpty();
}
/*
* The given attribute (x-to-one association) will be fetched with a left join.
*/
public void addFetch(Attribute... attributes) {
addFetch(newArrayList(attributes));
}
public void addFetch(List> attributes) {
fetches.add(new PathHolder(attributes));
}
/*
* Fluently set the fetch attribute
*/
public SearchParameters fetch(Attribute... attributes) {
fetch(newArrayList(attributes));
return this;
}
/*
* Fluently set the fetch attribute
*/
public SearchParameters fetch(List> attributes) {
addFetch(attributes);
return this;
}
// -----------------------------------
// Caching support
// -----------------------------------
/*
* Default to false. Please read https://hibernate.atlassian.net/browse/HHH-1523 before using cache.
*/
public void setCacheable(boolean cacheable) {
this.cacheable = cacheable;
}
public boolean isCacheable() {
return cacheable;
}
public boolean hasCacheRegion() {
return isNotBlank(cacheRegion);
}
public void setCacheRegion(String cacheRegion) {
this.cacheRegion = cacheRegion;
}
public String getCacheRegion() {
return cacheRegion;
}
public SearchParameters cacheable(boolean cacheable) {
setCacheable(cacheable);
return this;
}
public SearchParameters enableCache() {
setCacheable(true);
return this;
}
public SearchParameters disableCache() {
setCacheable(false);
return this;
}
public SearchParameters cacheRegion(String cacheRegion) {
setCacheRegion(checkNotNull(cacheRegion));
return this;
}
// -----------------------------------
// Extra parameters
// -----------------------------------
/*
* Set additionnal parameters.
*/
public void setExtraParameters(Map extraParameters) {
this.extraParameters = extraParameters;
}
public Map getExtraParameters() {
return extraParameters;
}
/*
* add additionnal parameter.
*/
public SearchParameters addExtraParameter(String key, Object o) {
extraParameters.put(checkNotNull(key), o);
return this;
}
/*
* get additionnal parameter.
*/
@SuppressWarnings("unchecked")
public T getExtraParameter(String key) {
return (T) extraParameters.get(key);
}
// -----------------------------------
// Use and in XToMany Search
// -----------------------------------
public void setUseAndInXToMany(boolean useAndInXToMany) {
this.useAndInXToMany = useAndInXToMany;
}
public boolean getUseAndInXToMany() {
return useAndInXToMany;
}
public SearchParameters useOrInXToMany() {
return useAndInXToMany(false);
}
public SearchParameters useAndInXToMany() {
return useAndInXToMany(true);
}
public SearchParameters useAndInXToMany(boolean xToManyAndMode) {
setUseAndInXToMany(xToManyAndMode);
return this;
}
// -----------------------------------
// Distinct
// -----------------------------------
public void setDistinct(boolean useDistinct) {
this.useDistinct = useDistinct;
}
public boolean getDistinct() {
return useDistinct;
}
public SearchParameters distinct(boolean useDistinct) {
setDistinct(useDistinct);
return this;
}
public SearchParameters distinct() {
return distinct(true);
}
@Override
public String toString() {
return ToStringBuilder.reflectionToString(this);
}
}