iquerydao.java

esri的ArcGIS Server超级学习模板程序（for java）

package com.esri.solutions.jitk.personalization.dao;

import java.util.List;

/**
 * @author Derek Sedlmyer
 * @version 1.0
 * @created 05-Nov-2007 10:29:33 AM
 * 
 * The interface used to persist and retrieve Query Records to the database. Includes various 
 * Select, Insert, Update, and Delete methods. 
 */
public interface IQueryDAO {
	
	/**
	 * Insert a single Query record into the database.
	 * @param bookmark
	 */
	public void insert(QueryRecord query) throws PersonalizationDAOException;

	/**
	 * Selects a set of Query records based on input Criteria and returns a list
	 * of QueryInfoRecords.
	 * @param Criteria
	 * @return List<QueryInfoRecord>
	 * @throws PersonalizationDAOException
	 */
	public List<QueryInfoRecord> selectAll(Criteria criteria) throws PersonalizationDAOException;

	/**
	 * Counts the number of Query records based on the input Criteria and returns
	 * the count as an integer.
	 * @param Criteria
	 * @return int 
	 * @throws PersonalizationDAOException
	 */
	public int selectAllCount(Criteria criteria) throws PersonalizationDAOException;

	/**
	 * Selects a subset of Query records based on input Criteria and PageInfo and returns
	 * the subset as a list of QueryInfoRecords. It's used to page through the results
	 * as users move forward or backward through a list of records.
	 * @param Criteria
	 * @param PageInfo
	 */
	public List<QueryInfoRecord> selectPage(Criteria criteria, PageInfo pageInfo) throws PersonalizationDAOException;
	
	/**
	 * Selects a single Query record based on the input Query Id and returns
	 * the information as a QueryRecord.
	 * @param id
	 */
	public QueryRecord selectOne(String id) throws PersonalizationDAOException;

	/**
	 * Updates a single Query record.  All fields will be updated based on the 
	 * QueryRecord passed in. 
	 * @param bookmark
	 */
	public void update(QueryRecord query) throws PersonalizationDAOException;

	/**
	 * Deletes a single Query record based on input Query Id.
	 * @param id
	 */
	public void delete(String id) throws PersonalizationDAOException;
	
}