idao.java

一个简单的java邮件系统源码

package com.easyjf.web.tools;

import java.io.Serializable;
import java.util.Collection;
import java.util.List;

/**
*
* <p>Title: 数据库操作接口</p>
* <p>Description:EasyJWeb Tools中的添删改查等业务引擎使用该DAO进行数据库操作 </p>
* <p>Copyright: Copyright (c) 2006</p>
* <p>Company: EasyJF开源团队</p>
* @author 大峡
* @version 0.1
*/
public interface IDAO {
	/**
	 * 把对象保存到持久层
	 * 
	 * @param obj
	 * @return
	 * @throws IdExistException
	 */
	boolean save(Object obj);

	/**
	 * 更新持久层中的对象
	 * 
	 * @param obj
	 * @return
	 */
	boolean update(Object obj);

	/**
	 * 删除持久层中的对象
	 * 
	 * @param obj
	 * @return
	 */
	boolean del(Object obj);

	/**
	 * 根据类及主键加载对象
	 * 
	 * @param clz
	 * @param id
	 * @return
	 */
	Object get(Class clz, Serializable id);

	/**
	 * 根据类、字段名及字段值加载对象，只加载一条符合条件的对象。
	 * 
	 * @param clz
	 * @param fieldName
	 * @param value
	 * @return
	 */
	Object getBy(Class clz, String fieldName, Serializable value);

	/**
	 * 根据条件查询对象
	 * 
	 * @param clz 类名
	 * @param scope 查询条件
	 * @return
	 */
	List query(Class clz, String scope);

	/**
	 * 根据条件、条件参数查询对象
	 * 
	 * @param clz 类名
	 * @param scope 查询条件
	 * @param paras 查询参数
	 * @return
	 */
	List query(Class clz, String scope, Collection paras);

	/**
	 * 查询符合条件的对象，从begin开始取max条记录
	 * 
	 * @param clz Java类
	 * @param scope 查询条件
	 * @param paras 查询参数
	 * @param begin 返回有效结果开始记录数
	 * @param max  返回的最多记录数
	 * @return
	 */
	List query(Class clz, String scope, Collection paras, int begin, int max);
	
	/**
	 * 执行sql语句，并返回一个对象,如select count(*) from tableName等
	 * @param sql sql语句
	 * @return
	 */
	Object uniqueResult(String sql);
	
	/**
	 * 根据sql语句及查询参数执行查询，并返回一个唯一对象，如select count(*) from tableName where filed=?
	 * @param sql
	 * @param paras
	 * @return
	 */
	Object uniqueResult(String sql,Collection paras);
	
	/**
	 * 执行任意sql语句，返回受影响的记录数
	 * @param sql sql语句
	 * @return
	 */
	int execute(String sql); 
	/**
	 * 根据sql语句及参数执行数据库操作，返回受影响的记录数
	 * @param sql sql语句
	 * @param paras 参数
	 * @return
	 */
	int execute(String sql,Collection paras); // 执行任意SQL语句
}