com.jpattern.orm.query.IOrmQuery Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jporm-api Show documentation

There is a newer version: 3.5.1

package com.jpattern.orm.query;

import java.util.List;

import com.jpattern.orm.exception.OrmException;
import com.jpattern.orm.exception.OrmNotUniqueResultException;

/**
 * 
 * @author Francesco Cina
 *
 * 18/giu/2011
 */
public interface IOrmQuery extends IBaseOrmQuery {

	/**
	 * Execute the query returning the list of objects.
	 * @return
	 */
	List findList() throws OrmException;
	
	/**
	 * Return the count of entities this query should return.
	 * @return
	 */
	long findRowCount() throws OrmException;
    
	/**
	 * Execute the query returning either a single bean or null (if no matching bean is found).
	 * @return 
	 * @throws OrmNotUniqueResultException if more than one row is returned from the query
	 */
	T findUnique() throws OrmException, OrmNotUniqueResultException;
    
	/**
	 * Execute the query and for every object created call the IOrmSerialResultReader.
	 * The objects are created one after the other to avoid the use of too much memory.
	 * @param srr
	 * @throws OrmException
	 */
	void find(IOrmRowMapper srr) throws OrmException; 
	
	/**
	 * Return the sql that was generated to return the row count of the execution of this query.
	 * @return
	 */
	String getGeneratedRowCountSql() throws OrmException;
	
	/**
	 * use Distinct in the select clause
	 * @return
	 */
	IOrmQuery setDistinct() throws OrmException;    
	
	/**
	 * return if use Distinct in the select clause
	 * @return
	 */
	boolean isDistinct() throws OrmException;  
	
	/**
	 * Set the maximum number of rows to return in the query.
	 * @param maxRows
	 * @return
	 */
	IOrmQuery setMaxRows(int maxRows) throws OrmException;
	
	/**
	 * Set the query timeout for the query.
	 */
	IOrmQuery setQueryTimeout(int queryTimeout);

	/**
	 * 
	 * @param lockMode
	 * @return
	 */
	IOrmQuery setLockMode(LockMode lockMode);
}