package io.ebeaninternal.server.expression;
import io.ebean.ExampleExpression;
import io.ebean.Expression;
import io.ebean.ExpressionFactory;
import io.ebean.ExpressionList;
import io.ebean.Junction;
import io.ebean.LikeType;
import io.ebean.Pairs;
import io.ebean.Query;
import io.ebean.bean.EntityBean;
import io.ebean.search.Match;
import io.ebean.search.MultiMatch;
import io.ebean.search.TextCommonTerms;
import io.ebean.search.TextQueryString;
import io.ebean.search.TextSimple;
import io.ebeaninternal.api.SpiExpressionFactory;
import io.ebeaninternal.api.SpiQuery;
import io.ebeaninternal.server.grammer.EqlParser;
import java.util.Arrays;
import java.util.Collection;
import java.util.Map;
Default Expression factory for creating standard expressions.
/**
* Default Expression factory for creating standard expressions.
*/
public class DefaultExpressionFactory implements SpiExpressionFactory {
private static final Object[] EMPTY_ARRAY = new Object[]{};
private final boolean nativeIlike;
private final boolean equalsWithNullAsNoop;
public DefaultExpressionFactory(boolean equalsWithNullAsNoop, boolean nativeIlike) {
this.equalsWithNullAsNoop = equalsWithNullAsNoop;
this.nativeIlike = nativeIlike;
}
@Override
public ExpressionFactory createExpressionFactory() {
return this;
}
public String getLang() {
return "sql";
}
@Override
public Expression textMatch(String propertyName, String search, Match options) {
return new TextMatchExpression(propertyName, search, options);
}
@Override
public Expression textMultiMatch(String query, MultiMatch options) {
return new TextMultiMatchExpression(query, options);
}
@Override
public Expression textSimple(String search, TextSimple options) {
return new TextSimpleExpression(search, options);
}
@Override
public Expression textQueryString(String search, TextQueryString options) {
return new TextQueryStringExpression(search, options);
}
@Override
public Expression textCommonTerms(String search, TextCommonTerms options) {
return new TextCommonTermsExpression(search, options);
}
@Override
public Expression jsonExists(String propertyName, String path) {
return new JsonPathExpression(propertyName, path, Op.EXISTS, null);
}
@Override
public Expression jsonNotExists(String propertyName, String path) {
return new JsonPathExpression(propertyName, path, Op.NOT_EXISTS, null);
}
@Override
public Expression jsonEqualTo(String propertyName, String path, Object value) {
return new JsonPathExpression(propertyName, path, Op.EQ, value);
}
@Override
public Expression jsonNotEqualTo(String propertyName, String path, Object value) {
return new JsonPathExpression(propertyName, path, Op.NOT_EQ, value);
}
@Override
public Expression jsonGreaterThan(String propertyName, String path, Object value) {
return new JsonPathExpression(propertyName, path, Op.GT, value);
}
@Override
public Expression jsonGreaterOrEqual(String propertyName, String path, Object value) {
return new JsonPathExpression(propertyName, path, Op.GT_EQ, value);
}
@Override
public Expression jsonLessThan(String propertyName, String path, Object value) {
return new JsonPathExpression(propertyName, path, Op.LT, value);
}
@Override
public Expression jsonLessOrEqualTo(String propertyName, String path, Object value) {
return new JsonPathExpression(propertyName, path, Op.LT_EQ, value);
}
@Override
public Expression jsonBetween(String propertyName, String path, Object lowerValue, Object upperValue) {
return new JsonPathExpression(propertyName, path, lowerValue, upperValue);
}
@Override
public Expression arrayContains(String propertyName, Object... values) {
return new ArrayContainsExpression(propertyName, true, values);
}
@Override
public Expression arrayNotContains(String propertyName, Object... values) {
return new ArrayContainsExpression(propertyName, false, values);
}
@Override
public Expression arrayIsEmpty(String propertyName) {
return new ArrayIsEmptyExpression(propertyName, true);
}
@Override
public Expression arrayIsNotEmpty(String propertyName) {
return new ArrayIsEmptyExpression(propertyName, false);
}
@Override
public Expression bitwiseAny(String propertyName, long flags) {
return new BitwiseExpression(propertyName, BitwiseOp.ANY, flags, "!=", 0L);
}
@Override
public Expression bitwiseAll(String propertyName, long flags) {
return new BitwiseExpression(propertyName, BitwiseOp.ALL, flags, "=", flags);
}
@Override
public Expression bitwiseAnd(String propertyName, long flags, long match) {
return new BitwiseExpression(propertyName, BitwiseOp.AND, flags, "=", match);
}
@Override
public <T> void where(ExpressionList<T> list, String expressions, Object[] params) {
EqlParser.parseWhere(expressions, list, this, params);
}
Equal To - property equal to the given value.
/**
* Equal To - property equal to the given value.
*/
@Override
public Expression eq(String propertyName, Object value) {
if (value == null) {
return equalsWithNullAsNoop ? NoopExpression.INSTANCE : isNull(propertyName);
}
return new SimpleExpression(propertyName, Op.EQ, value);
}
@Override
public Expression eqOrNull(String propertyName, Object value) {
return or(eq(propertyName, value), isNull(propertyName));
}
Not Equal To - property not equal to the given value.
/**
* Not Equal To - property not equal to the given value.
*/
@Override
public Expression ne(String propertyName, Object value) {
if (value == null) {
return equalsWithNullAsNoop ? NoopExpression.INSTANCE : isNotNull(propertyName);
}
return new SimpleExpression(propertyName, Op.NOT_EQ, value);
}
Case Insensitive Equal To - property equal to the given value (typically
using a lower() function to make it case insensitive).
/**
* Case Insensitive Equal To - property equal to the given value (typically
* using a lower() function to make it case insensitive).
*/
@Override
public Expression ieq(String propertyName, String value) {
if (value == null) {
return equalsWithNullAsNoop ? NoopExpression.INSTANCE : isNull(propertyName);
}
return new CaseInsensitiveEqualExpression(propertyName, value, false);
}
Case Insensitive Equal To - property equal to the given value (typically
using a lower() function to make it case insensitive).
/**
* Case Insensitive Equal To - property equal to the given value (typically
* using a lower() function to make it case insensitive).
*/
@Override
public Expression ine(String propertyName, String value) {
if (value == null) {
return equalsWithNullAsNoop ? NoopExpression.INSTANCE : isNotNull(propertyName);
}
return new CaseInsensitiveEqualExpression(propertyName, value, true);
}
Create for named parameter use (and without support for equalsWithNullAsNoop).
/**
* Create for named parameter use (and without support for equalsWithNullAsNoop).
*/
@Override
public Expression ieqObject(String propertyName, Object value) {
return new CaseInsensitiveEqualExpression(propertyName, value, false);
}
Create for named parameter use (and without support for equalsWithNullAsNoop).
/**
* Create for named parameter use (and without support for equalsWithNullAsNoop).
*/
@Override
public Expression ineObject(String propertyName, Object value) {
return new CaseInsensitiveEqualExpression(propertyName, value, true);
}
Between - property between the two given values.
/**
* Between - property between the two given values.
*/
@Override
public Expression inRange(String propertyName, Object value1, Object value2) {
return new InRangeExpression(propertyName, value1, value2);
}
@Override
public Expression inRangeWith(String lowProperty, String highProperty, Object value) {
return and(le(lowProperty, value), gtOrNull(highProperty, value));
}
Between - property between the two given values.
/**
* Between - property between the two given values.
*/
@Override
public Expression between(String propertyName, Object value1, Object value2) {
return new BetweenExpression(propertyName, value1, value2);
}
Between - value between two given properties.
/**
* Between - value between two given properties.
*/
@Override
public Expression betweenProperties(String lowProperty, String highProperty, Object value) {
return new BetweenPropertyExpression(lowProperty, highProperty, value);
}
Greater Than - property greater than the given value.
/**
* Greater Than - property greater than the given value.
*/
@Override
public Expression gt(String propertyName, Object value) {
return new SimpleExpression(propertyName, Op.GT, value);
}
Greater Than or null - property greater than the given value or null.
/**
* Greater Than or null - property greater than the given value or null.
*/
@Override
public Expression gtOrNull(String propertyName, Object value) {
return or(gt(propertyName, value), isNull(propertyName));
}
@Override
public Expression geOrNull(String propertyName, Object value) {
return or(ge(propertyName, value), isNull(propertyName));
}
Greater Than or Equal to - property greater than or equal to the given
value.
/**
* Greater Than or Equal to - property greater than or equal to the given
* value.
*/
@Override
public Expression ge(String propertyName, Object value) {
return new SimpleExpression(propertyName, Op.GT_EQ, value);
}
Less Than or null - property less than the given value or null.
/**
* Less Than or null - property less than the given value or null.
*/
@Override
public Expression ltOrNull(String propertyName, Object value) {
return or(lt(propertyName, value), isNull(propertyName));
}
@Override
public Expression leOrNull(String propertyName, Object value) {
return or(le(propertyName, value), isNull(propertyName));
}
Less Than - property less than the given value.
/**
* Less Than - property less than the given value.
*/
@Override
public Expression lt(String propertyName, Object value) {
return new SimpleExpression(propertyName, Op.LT, value);
}
Less Than or Equal to - property less than or equal to the given value.
/**
* Less Than or Equal to - property less than or equal to the given value.
*/
@Override
public Expression le(String propertyName, Object value) {
return new SimpleExpression(propertyName, Op.LT_EQ, value);
}
Is Null - property is null.
/**
* Is Null - property is null.
*/
@Override
public Expression isNull(String propertyName) {
return new NullExpression(propertyName, false);
}
Is Not Null - property is not null.
/**
* Is Not Null - property is not null.
*/
@Override
public Expression isNotNull(String propertyName) {
return new NullExpression(propertyName, true);
}
private EntityBean checkEntityBean(Object bean) {
if (!(bean instanceof EntityBean)) {
throw new IllegalStateException("Expecting an EntityBean");
}
return (EntityBean) bean;
}
Case insensitive exampleLike(Object)
/**
* Case insensitive {@link #exampleLike(Object)}
*/
@Override
public ExampleExpression iexampleLike(Object example) {
return new DefaultExampleExpression(checkEntityBean(example), true, LikeType.RAW);
}
Create the query by Example expression which is case sensitive and using
LikeType.RAW (you need to add you own wildcards % and _).
/**
* Create the query by Example expression which is case sensitive and using
* LikeType.RAW (you need to add you own wildcards % and _).
*/
@Override
public ExampleExpression exampleLike(Object example) {
return new DefaultExampleExpression(checkEntityBean(example), false, LikeType.RAW);
}
Create the query by Example expression specifying more options.
/**
* Create the query by Example expression specifying more options.
*/
@Override
public ExampleExpression exampleLike(Object example, boolean caseInsensitive, LikeType likeType) {
return new DefaultExampleExpression(checkEntityBean(example), caseInsensitive, likeType);
}
@Override
public Expression like(String propertyName, Object value, boolean caseInsensitive, LikeType likeType) {
return new LikeExpression(propertyName, value, caseInsensitive, likeType);
}
Like - property like value where the value contains the SQL wild card
characters % (percentage) and _ (underscore).
/**
* Like - property like value where the value contains the SQL wild card
* characters % (percentage) and _ (underscore).
*/
@Override
public Expression like(String propertyName, String value) {
return new LikeExpression(propertyName, value, false, LikeType.RAW);
}
Case insensitive Like - property like value where the value contains the
SQL wild card characters % (percentage) and _ (underscore). Typically uses
a lower() function to make the expression case insensitive.
/**
* Case insensitive Like - property like value where the value contains the
* SQL wild card characters % (percentage) and _ (underscore). Typically uses
* a lower() function to make the expression case insensitive.
*/
@Override
public Expression ilike(String propertyName, String value) {
if (nativeIlike) {
return new NativeILikeExpression(propertyName, value);
} else {
return new LikeExpression(propertyName, value, true, LikeType.RAW);
}
}
Starts With - property like value%.
/**
* Starts With - property like value%.
*/
@Override
public Expression startsWith(String propertyName, String value) {
return new LikeExpression(propertyName, value, false, LikeType.STARTS_WITH);
}
Case insensitive Starts With - property like value%. Typically uses a
lower() function to make the expression case insensitive.
/**
* Case insensitive Starts With - property like value%. Typically uses a
* lower() function to make the expression case insensitive.
*/
@Override
public Expression istartsWith(String propertyName, String value) {
return new LikeExpression(propertyName, value, true, LikeType.STARTS_WITH);
}
Ends With - property like %value.
/**
* Ends With - property like %value.
*/
@Override
public Expression endsWith(String propertyName, String value) {
return new LikeExpression(propertyName, value, false, LikeType.ENDS_WITH);
}
Case insensitive Ends With - property like %value. Typically uses a lower()
function to make the expression case insensitive.
/**
* Case insensitive Ends With - property like %value. Typically uses a lower()
* function to make the expression case insensitive.
*/
@Override
public Expression iendsWith(String propertyName, String value) {
return new LikeExpression(propertyName, value, true, LikeType.ENDS_WITH);
}
Contains - property like %value%.
/**
* Contains - property like %value%.
*/
@Override
public Expression contains(String propertyName, String value) {
return new LikeExpression(propertyName, value, false, LikeType.CONTAINS);
}
Case insensitive Contains - property like %value%. Typically uses a lower()
function to make the expression case insensitive.
/**
* Case insensitive Contains - property like %value%. Typically uses a lower()
* function to make the expression case insensitive.
*/
@Override
public Expression icontains(String propertyName, String value) {
return new LikeExpression(propertyName, value, true, LikeType.CONTAINS);
}
In - property has a value in the collection of values.
/**
* In - property has a value in the collection of values.
*/
@Override
public Expression inPairs(Pairs pairs) {
return new InPairsExpression(pairs, false);
}
In - property has a value in the array of values.
/**
* In - property has a value in the array of values.
*/
@Override
public Expression in(String propertyName, Object[] values) {
return new InExpression(propertyName, values, false);
}
In - using a subQuery.
/**
* In - using a subQuery.
*/
@Override
public Expression in(String propertyName, Query<?> subQuery) {
return new InQueryExpression(propertyName, (SpiQuery<?>) subQuery, false);
}
In - property has a value in the collection of values.
/**
* In - property has a value in the collection of values.
*/
@Override
public Expression in(String propertyName, Collection<?> values) {
return new InExpression(propertyName, values, false);
}
In where null or empty values means that no predicate is added to the query.
That is, only add the IN predicate if the values are not null or empty.
/**
* In where null or empty values means that no predicate is added to the query.
* <p>
* That is, only add the IN predicate if the values are not null or empty.
*/
@Override
public Expression inOrEmpty(String propertyName, Collection<?> values) {
return new InExpression(propertyName, values, false, true);
}
In - property has a value in the array of values.
/**
* In - property has a value in the array of values.
*/
@Override
public Expression notIn(String propertyName, Object[] values) {
return new InExpression(propertyName, values, true);
}
Not In - property has a value in the collection of values.
/**
* Not In - property has a value in the collection of values.
*/
@Override
public Expression notIn(String propertyName, Collection<?> values) {
return new InExpression(propertyName, values, true);
}
In - using a subQuery.
/**
* In - using a subQuery.
*/
@Override
public Expression notIn(String propertyName, Query<?> subQuery) {
return new InQueryExpression(propertyName, (SpiQuery<?>) subQuery, true);
}
Exists subquery
/**
* Exists subquery
*/
@Override
public Expression exists(Query<?> subQuery) {
return new ExistsQueryExpression((SpiQuery<?>) subQuery, false);
}
Not exists subquery
/**
* Not exists subquery
*/
@Override
public Expression notExists(Query<?> subQuery) {
return new ExistsQueryExpression((SpiQuery<?>) subQuery, true);
}
@Override
public Expression isEmpty(String propertyName) {
return new IsEmptyExpression(propertyName, true);
}
@Override
public Expression isNotEmpty(String propertyName) {
return new IsEmptyExpression(propertyName, false);
}
Id Equal to - ID property is equal to the value.
/**
* Id Equal to - ID property is equal to the value.
*/
@Override
public Expression idEq(Object value) {
if (value == null) {
throw new NullPointerException("The id value is null");
}
return new IdExpression(value);
}
Id IN a collection of id values.
/**
* Id IN a collection of id values.
*/
@Override
public Expression idIn(Collection<?> idCollection) {
return new IdInExpression(idCollection);
}
Id IN a list of id values.
/**
* Id IN a list of id values.
*/
@Override
public Expression idIn(Object... idValues) {
return new IdInExpression(Arrays.asList(idValues));
}
All Equal - Map containing property names and their values.
Expression where all the property names in the map are equal to the
corresponding value.
Params: - propertyMap – a map keyed by property names.
/**
* All Equal - Map containing property names and their values.
* <p>
* Expression where all the property names in the map are equal to the
* corresponding value.
* </p>
*
* @param propertyMap a map keyed by property names.
*/
@Override
public Expression allEq(Map<String, Object> propertyMap) {
return new AllEqualsExpression(propertyMap);
}
Add raw expression with a single parameter.
The raw expression should contain a single ? at the location of the
parameter.
/**
* Add raw expression with a single parameter.
* <p>
* The raw expression should contain a single ? at the location of the
* parameter.
* </p>
*/
@Override
public Expression raw(String raw, Object value) {
return RawExpressionBuilder.buildSingle(raw, value);
}
Add raw expression with an array of parameters.
The raw expression should contain the same number of ? as there are
parameters.
/**
* Add raw expression with an array of parameters.
* <p>
* The raw expression should contain the same number of ? as there are
* parameters.
* </p>
*/
@Override
public Expression raw(String raw, Object[] values) {
return RawExpressionBuilder.build(raw, values);
}
Add raw expression with no parameters.
/**
* Add raw expression with no parameters.
*/
@Override
public Expression raw(String raw) {
return new RawExpression(raw, EMPTY_ARRAY);
}
And - join two expressions with a logical and.
/**
* And - join two expressions with a logical and.
*/
@Override
public Expression and(Expression expOne, Expression expTwo) {
return new LogicExpression.And(expOne, expTwo);
}
Or - join two expressions with a logical or.
/**
* Or - join two expressions with a logical or.
*/
@Override
public Expression or(Expression expOne, Expression expTwo) {
return new LogicExpression.Or(expOne, expTwo);
}
Negate the expression (prefix it with NOT).
/**
* Negate the expression (prefix it with NOT).
*/
@Override
public Expression not(Expression exp) {
return new NotExpression(exp);
}
Return a list of expressions that will be joined by AND's.
/**
* Return a list of expressions that will be joined by AND's.
*/
@Override
public <T> Junction<T> conjunction(Query<T> query) {
return new JunctionExpression<>(Junction.Type.AND, query, query.where());
}
Return a list of expressions that will be joined by OR's.
/**
* Return a list of expressions that will be joined by OR's.
*/
@Override
public <T> Junction<T> disjunction(Query<T> query) {
return new JunctionExpression<>(Junction.Type.OR, query, query.where());
}
Return a list of expressions that will be joined by AND's.
/**
* Return a list of expressions that will be joined by AND's.
*/
@Override
public <T> Junction<T> conjunction(Query<T> query, ExpressionList<T> parent) {
return new JunctionExpression<>(Junction.Type.AND, query, parent);
}
Return a list of expressions that will be joined by OR's.
/**
* Return a list of expressions that will be joined by OR's.
*/
@Override
public <T> Junction<T> disjunction(Query<T> query, ExpressionList<T> parent) {
return new JunctionExpression<>(Junction.Type.OR, query, parent);
}
Return a list of expressions that are wrapped by NOT.
/**
* Return a list of expressions that are wrapped by NOT.
*/
public <T> Junction<T> junction(Junction.Type type, Query<T> query) {
return new JunctionExpression<>(type, query, query.where());
}
Create and return a Full text junction (Must, Must Not or Should).
/**
* Create and return a Full text junction (Must, Must Not or Should).
*/
@Override
public <T> Junction<T> junction(Junction.Type type, Query<T> query, ExpressionList<T> parent) {
return new JunctionExpression<>(type, query, parent);
}
}