ibookmarkdao.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 Bookmark Records to the database. Includes various 
 * Select, Insert, Update, and Delete methods. 
 */
public interface IBookmarkDAO {
	
	/**
	 * Insert a single Bookmark record into the database.
	 * @param bookmark
	 */
	public void insert(BookmarkRecord bookmark) throws PersonalizationDAOException;

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

	/**
	 * Counts the number of Bookmark 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 Bookmark records based on input Criteria and PageInfo and returns
	 * the subset as a list of BookmarkInfoRecords. 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<BookmarkInfoRecord> selectPage(Criteria criteria, PageInfo pageInfo) throws PersonalizationDAOException;
	
	/**
	 * Selects a single Bookmark record based on the input Bookmark Id and returns
	 * the information as a BookmarkRecord.
	 * @param id
	 */
	public BookmarkRecord selectOne(String id) throws PersonalizationDAOException;

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

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