Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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 org.apache.openjpa.kernel.exps;
import org.apache.openjpa.meta.ClassMetaData;
/**
* The ExpressionFactory must be implemented by a particular runtime
* to form {@link Expression}s in its native query language.
*
* @author Abe White
* @nojavadoc
*/
public interface ExpressionFactory {
/**
* Return a blank expression; this is used when the filter is empty.
*/
public Expression emptyExpression();
/**
* Return the given value as an expression.
*/
public Expression asExpression(Value bool);
/**
* Return an expression representing the given condition.
*/
public Expression equal(Value v1, Value v2);
/**
* Return an expression representing the given condition.
*/
public Expression notEqual(Value v1, Value v2);
/**
* Return an expression representing the given condition.
*/
public Expression lessThan(Value v1, Value v2);
/**
* Return an expression representing the given condition.
*/
public Expression greaterThan(Value v1, Value v2);
/**
* Return an expression representing the given condition.
*/
public Expression lessThanEqual(Value v1, Value v2);
/**
* Return an expression representing the given condition.
*/
public Expression greaterThanEqual(Value v1, Value v2);
/**
* Return an expression representing the given condition.
*/
public Expression isEmpty(Value target);
/**
* Return an expression representing the given condition.
*/
public Expression isNotEmpty(Value target);
/**
* Return an expression representing the given condition.
*/
public Expression contains(Value coll, Value arg);
/**
* Return an expression representing the given condition.
*/
public Expression containsKey(Value map, Value arg);
/**
* Return an expression representing the given condition.
*/
public Expression containsValue(Value map, Value arg);
/**
* Return an expression representing the given condition.
*/
public Value getMapValue(Value map, Value arg);
/**
* Return whether the first value is an instance of the given class.
*/
public Expression isInstance(Value obj, Class c);
/**
* Return the two expressions AND'd together.
*/
public Expression and(Expression exp1, Expression exp2);
/**
* Return the two expressions OR'd together.
*/
public Expression or(Expression exp1, Expression exp2);
/**
* Return the inverse of this expression.
*/
public Expression not(Expression exp);
/**
* Bind the given variable to the given collection value.
*/
public Expression bindVariable(Value var, Value coll);
/**
* Bind the given variable to the key set of the given map value.
*/
public Expression bindKeyVariable(Value var, Value map);
/**
* Bind the given variable to the value set of the given map value.
*/
public Expression bindValueVariable(Value var, Value map);
/**
* Return whether the first string ends with the second.
*/
public Expression endsWith(Value str1, Value str2);
/**
* Return whether the string matches the matching pattern.
*
* @param str the value to compare
* @param regexp the pattern against which to compare
* @param single the token that signifies a single-character match
* @param multi the token that signifies a multi-character match
* @param escape the escape token that escapes the matching tokens
*/
public Expression matches(Value str, Value regexp,
String single, String multi, String escape);
/**
* Return whether the string does not match the given pattern.
*
* @param str the value to compare
* @param regexp the pattern against which to compare
* @param single the token that signifies a single-character match
* @param multi the token that signifies a multi-character match
* @param escape the escape token that escapes the matching tokens
*/
public Expression notMatches(Value str, Value regexp, String single,
String multi, String escape);
/**
* Return whether the first string starts with the second.
*/
public Expression startsWith(Value str1, Value str2);
/**
* Returns the number of characters in the String value.
*/
public Value stringLength(Value str);
/**
* Trims the specified specified trimChar from the specified value.
*
* @param str the value from which to trim
* @param trimChar the characters to trim off
* @param where which side of the String to trim: null
* indicates both sides, true indicates
* leading, and false indicates trailing
*/
public Value trim(Value str, Value trimChar, Boolean where);
/**
* Return a subquery. Paths for the candidates of the subquery are
* created with {@link #newPath(Value)}, passing in the subquery as the
* value.
*
* @param candidate the candidate class of the subquery
* @param subs whether the query includes subclasses
* @param alias the alias given to the query candidate class
*/
public Subquery newSubquery(ClassMetaData candidate, boolean subs,
String alias);
/**
* Return a value representing a path which will consist
* of a chain of 1 or more field names starting in the namespace of the
* candidate class. Example: parent.address.city
*/
public Path newPath();
/**
* Return a value representing a path which will consist
* of a chain of 1 or more field names starting in the namespace of the
* given value. Example: var.address.city
*/
public Path newPath(Value val);
/**
* Return a value representing the given constant, which will be
* a {@link Number}, {@link String}, or {@link Boolean} instance.
*/
public Literal newLiteral(Object val, int parseType);
/**
* Return a value representing this.
*/
public Value getThis();
/**
* Return a value representing null.
*/
public Value getNull();
/**
* Return a value representing the current date.
*/
public Value getCurrentDate();
/**
* Return a value representing the current time.
*/
public Value getCurrentTime();
/**
* Return a value representing the current timestamp.
*/
public Value getCurrentTimestamp();
/**
* Return a value representing a parameter for the given value. The
* type may be Object if the parameter is not declared.
*/
public Parameter newParameter(String name, Class type);
/**
* Return the value of the given extension.
*/
public Value newExtension(FilterListener listener, Value target,
Value args);
/**
* Return the value of the given function.
*/
public Value newAggregate(AggregateListener listener, Value args);
/**
* Return a function argument list consisting of the given values, either
* of which may itself be an argument list.
*/
public Arguments newArgumentList(Value arg1, Value arg2);
/**
* Return an unbound variable. This method will only be called once for
* a given named unbound variable. The type may be Object
* if the variable is not declared.
*/
public Value newUnboundVariable(String name, Class type);
/**
* This method will be called only once per variable bound in a
* contains clause, and the returned value will be reused
* for any further instances of the variable in subexpression of the
* filter string. The type may be Object if the variable is
* not declared.
*/
public Value newBoundVariable(String name, Class type);
/**
* Cast the value to the given class.
*/
public Value cast(Value obj, Class cls);
/**
* Return a value representing the two values added together.
*/
public Value add(Value num1, Value num2);
/**
* Return a value representing the second value subtracted from the first.
*/
public Value subtract(Value num1, Value num2);
/**
* Return a value representing the two values multiplied together.
*/
public Value multiply(Value num1, Value num2);
/**
* Return a value representing the first value divided by the first one.
*/
public Value divide(Value num1, Value num2);
/**
* Return a value representing the first value mod'd by the second one.
*/
public Value mod(Value num1, Value num2);
/**
* Return a value representing the absolute value of the given one.
*/
public Value abs(Value num);
/**
* Return a value representing the {@link String#indexOf} function on
* the given target with the given args.
*/
public Value indexOf(Value str, Value args);
/**
* Return a value representing the concatenation of
* the given target with the given args.
*/
public Value concat(Value str, Value args);
/**
* Return the square root of the given value.
*/
public Value sqrt(Value num);
/**
* Return a value representing the {@link String#substring} function on
* the given target with the given args. As with {@link String#substring},
* the start index is zero-based, and the second argument is the end index.
*/
public Value substring(Value str, Value args);
/**
* Return the upper case of the given value.
*/
public Value toUpperCase(Value str);
/**
* Return the upper case of the given value.
*/
public Value toLowerCase(Value str);
/**
* Return the average of the given value for all matches.
*/
public Value avg(Value num);
/**
* Return the count of the given value for all matches.
*/
public Value count(Value obj);
/**
* Return the max of the given value for all matches.
*/
public Value max(Value num);
/**
* Return the max of the given value for all matches.
*/
public Value min(Value num);
/**
* Return the max of the given value for all matches.
*/
public Value sum(Value num);
/**
* Return an expression representing the given condition.
*
* @since 0.4.0.0
*/
public Value any(Value target);
/**
* Return an expression representing the given condition.
*
* @since 0.4.0.0
*/
public Value all(Value target);
/**
* Return an expression representing the given condition.
*
* @since 0.4.0.0
*/
public Value size(Value target);
/**
* Return distinct values of the given value. This is typically used
* within aggregates, for example: max(distinct(path))
*
* @since 0.4.0.0
*/
public Value distinct (Value obj);
/**
* Return the object id of the given value.
*/
public Value getObjectId (Value val);
}
