package io.ebeaninternal.server.core;


import io.ebean.RowConsumer;
import io.ebean.RowMapper;
import io.ebean.SqlRow;
import io.ebean.meta.MetricVisitor;

import java.util.List;
import java.util.function.Consumer;
import java.util.function.Predicate;

public interface RelationalQueryEngine {

  
Return a new SqlRow with appropriate mapping for DB true and optimised binary UUID etc.
/**
   * Return a new SqlRow with appropriate mapping for DB true and optimised binary UUID etc.
   */
  SqlRow createSqlRow(int estimateCapacity);

  
Find a list of beans using relational query.
/**
   * Find a list of beans using relational query.
   */
  List<SqlRow> findList(RelationalQueryRequest request);

  
Find each query using relational query.
/**
   * Find each query using relational query.
   */
  void findEach(RelationalQueryRequest request, Consumer<SqlRow> consumer);

  
Find each while query using relational query.
/**
   * Find each while query using relational query.
   */
  void findEach(RelationalQueryRequest request, Predicate<SqlRow> consumer);

  
Find single attribute.
/**
   * Find single attribute.
   */
  <T> T findSingleAttribute(RelationalQueryRequest request, Class<T> cls);

  
Find single attribute list.
/**
   * Find single attribute list.
   */
  <T> List<T> findSingleAttributeList(RelationalQueryRequest request, Class<T> cls);

  
Find one via mapper.
/**
   * Find one via mapper.
   */
  <T> T findOneMapper(RelationalQueryRequest request, RowMapper<T> mapper);

  
Find list via mapper.
/**
   * Find list via mapper.
   */
  <T> List<T> findListMapper(RelationalQueryRequest request, RowMapper<T> mapper);

  
Find each via raw consumer.
/**
   * Find each via raw consumer.
   */
  void findEachRow(RelationalQueryRequest request, RowConsumer mapper);

  
Collect SQL query execution statistics.
/**
   * Collect SQL query execution statistics.
   */
  void collect(String label, long exeMicros, int rows);

  
Visit the metrics.
/**
   * Visit the metrics.
   */
  void visitMetrics(MetricVisitor visitor);
}