package io.ebeaninternal.api;

import io.ebean.bean.BeanCollection;
import io.ebean.bean.EntityBeanIntercept;
import io.ebean.bean.ObjectGraphNode;
import io.ebean.bean.PersistenceContext;
import io.ebeaninternal.server.core.OrmQueryRequest;

Controls the loading of reference objects for a query instance.
/**
 * Controls the loading of reference objects for a query instance.
 */
public interface LoadContext {

  
Return the minimum batch size when using QueryIterator with query joins.
/**
   * Return the minimum batch size when using QueryIterator with query joins.
   */
  int getSecondaryQueriesMinBatchSize(int defaultQueryBatch);

  
Execute any secondary (+query) queries if there are any defined.
Params:
parentRequest – the originating query request
forEach –       set true when using findEach iteration/**
   * Execute any secondary (+query) queries if there are any defined.
   *
   * @param parentRequest the originating query request
   * @param forEach       set true when using findEach iteration
   */
  void executeSecondaryQueries(OrmQueryRequest<?> parentRequest, boolean forEach);

  
Return the node for a given path which is used by AutoTune profiling.
/**
   * Return the node for a given path which is used by AutoTune profiling.
   */
  ObjectGraphNode getObjectGraphNode(String path);

  
Return the persistence context used by this query and future lazy loading.
/**
   * Return the persistence context used by this query and future lazy loading.
   */
  PersistenceContext getPersistenceContext();

  
Set the persistence context used by this query and future lazy loading.

Used by query iterator when processing large result sets.

/**
   * Set the persistence context used by this query and future lazy loading.
   * <p>
   * Used by query iterator when processing large result sets.
   * </p>
   */
  void resetPersistenceContext(PersistenceContext persistenceContext);

  
Register a Bean for lazy loading.
/**
   * Register a Bean for lazy loading.
   */
  void register(String path, EntityBeanIntercept ebi);

  
Register a collection for lazy loading.
/**
   * Register a collection for lazy loading.
   */
  void register(String path, BeanCollection<?> bc);

}