io.ebeaninternal.api.SpiExpression Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of ebean Show documentation
composite of common runtime dependencies for all platforms
There is a newer version: 15.8.1
package io.ebeaninternal.api;

import io.ebean.Expression;
import io.ebean.event.BeanQueryRequest;
import io.ebeaninternal.server.deploy.BeanDescriptor;
import io.ebeaninternal.server.expression.DocQueryContext;

import java.io.IOException;


/**
 * An expression that becomes part of a Where clause or Having clause.
 */
public interface SpiExpression extends Expression {

  /**
   * Simplify nested expressions if possible.
   */
  void simplify();

  /**
   * Write the expression as an elastic search expression.
   */
  void writeDocQuery(DocQueryContext context) throws IOException;

  /**
   * Return the nested path for this expression.
   */
  String nestedPath(BeanDescriptor desc);

  /**
   * Process "Many" properties populating ManyWhereJoins.
   * 
   * Predicates on Many properties require an extra independent join clause.
   * 
   */
  void containsMany(BeanDescriptor desc, ManyWhereJoins whereManyJoins);

  /**
   * Prepare the expression. For example, compile sub-query expressions etc.
   */
  void prepareExpression(BeanQueryRequest request);

  /**
   * Calculate a hash value used to identify a query for AutoTune tuning.
   * 
   * That is, if the hash changes then the query will be considered different
   * from an AutoTune perspective and get different tuning.
   * 
   */
  void queryPlanHash(HashQueryPlanBuilder builder);

  /**
   * Return the hash value for the values that will be bound.
   */
  int queryBindHash();

  /**
   * Return true if the expression is the same without taking into account bind values.
   */
  boolean isSameByPlan(SpiExpression other);

  /**
   * Return true if the expression is the same with respect to bind values.
   */
  boolean isSameByBind(SpiExpression other);

  /**
   * Add some sql to the query.
   * 
   * This will contain ? as a place holder for each associated bind values.
   * 
   * 
   * The 'sql' added to the query can contain object property names rather
   * than db tables and columns. This 'sql' is later parsed converting the
   * logical property names to their full database column names.
   * 
   *
   * @param request the associated request.
   */
  void addSql(SpiExpressionRequest request);

  /**
   * Add the parameter values to be set against query. For each ? place holder
   * there should be a corresponding value that is added to the bindList.
   *
   * @param request the associated request.
   */
  void addBindValues(SpiExpressionRequest request);

  /**
   * Validate all the properties/paths associated with this expression.
   */
  void validate(SpiExpressionValidation validation);

  /**
   * Return a copy of the expression for use in the query plan key.
   */
  SpiExpression copyForPlanKey();

  /**
   * Return the bind Id value if this is a "equal to" expression for the id property.
   */
  Object getIdEqualTo(String idName);
}