com.simple.orm.dao.BaseDao Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of simple-orm Show documentation
基于 spring-jdbc的简易rom框架
There is a newer version: v1.9
package com.simple.orm.dao;

import java.io.Serializable;
import java.sql.SQLException;
import java.util.List;

/**
 * 数据库基本操作类
 * 
 * @author haopeng
 * @param  数据库映射的对象
 */
public interface BaseDao {

	/**
	 * 根据主键属性查询一条数据
	 * 
	 * @param id 主键的值
	 * @return 返回数据表的映射对象
	 * @throws SQLException 抛出数据库异常
	 */
	M find(Serializable id) throws SQLException;

	/**
	 * 根据属性值查询一条数据
	 * 
	 * @param property 属性名称
	 * @param value    对应的属性值
	 * @return 返回数据表的映射对象
	 * @throws SQLException 抛出数据库异常
	 */
	M find(String property, Object value) throws SQLException;

	/**
	 * 根据属性值查询
	 * 
	 * @param property 属性名称
	 * @param value    对应的属性值
	 * @return 返回数据表的映射对象列表
	 * @throws SQLException 抛出数据库异常
	 */
	List query(String property, Object value) throws SQLException;

	/**
	 * 根据属性值分页查询
	 * 
	 * @param property 属性名称
	 * @param value    对应的属性值
	 * @param start    开始索引（limit start,num）
	 * @param num      最大查询数量
	 * @return 返回数据表的映射对象列表
	 * @throws SQLException 抛出数据库异常
	 */
	List query(String property, Object value, Integer start, Integer num) throws SQLException;

	/**
	 * 查询所有
	 * 
	 * @return 返回数据表的映射对象列表
	 * @throws SQLException 抛出数据库异常
	 */
	List query() throws SQLException;

	/**
	 * 根据对象分页查询
	 * 
	 * @param m     映射的对象
	 * @param start 开始索引（limit start,num）
	 * @param num   最大查询数量
	 * @return 返回数据表的映射对象列表
	 * @throws SQLException 抛出数据库异常
	 */
	List query(M m, Integer start, Integer num) throws SQLException;

	/**
	 * 根据分页查询所有
	 * 
	 * @param start 开始索引(limit start,num)
	 * @param num   最大查询数量
	 * @return 返回数据表的映射对象列表
	 * @throws SQLException 抛出数据库异常
	 */
	List query(Integer start, Integer num) throws SQLException;

	/**
	 * 根据对象设置的属性查询
	 * 
	 * @param m 映射的对象
	 * @return 返回数据表的映射对象列表
	 * @throws SQLException 抛出数据库异常
	 */
	List query(M m) throws SQLException;

	/**
	 * 保存数据 并返回当前的对象
	 * 
	 * @param m 映射的对象
	 * @return 返回数据表的映射对象
	 * @throws SQLException 抛出数据库异常
	 */
	M insert(M m) throws SQLException;

	/**
	 * 根据映射对象设置的属性条件统计数量
	 * 
	 * @param m 映射的对象
	 * @return 返回数字
	 * @throws SQLException 抛出数据库异常
	 */
	Long count(M m) throws SQLException;

	/**
	 * 根据属性名称和值统计数量
	 * 
	 * @param property 属性名称
	 * @param value    属性值
	 * @return 返回数字
	 * @throws SQLException 抛出数据库异常
	 */
	Long count(String property, Object value) throws SQLException;

	/**
	 * 统计表中的数量
	 * 
	 * @return 返回数字
	 * @throws SQLException 抛出数据库异常
	 */
	Long count() throws SQLException;

	/**
	 * 根据M主键值更新其他属性
	 * 
	 * @param m 映射的对象
	 * @return 返回当前的映射对象
	 * @throws SQLException 抛出数据库异常
	 */
	M update(M m) throws SQLException;

	/**
	 * 根据主键Id删除
	 * 
	 * @param id 主键的值
	 * @return 返回影响的行数
	 * @throws SQLException 抛出数据库异常
	 */
	Integer deleteById(Serializable id) throws SQLException;

	/**
	 * 根据M实例的对象属性删除
	 * 
	 * @param m 映射的对象
	 * @return 返回影响的行数
	 * @throws SQLException 抛出数据库异常
	 */
	Integer delete(M m) throws SQLException;

}