|
|
package com.dao;
|
|
|
|
|
|
import java.util.List;
|
|
|
import java.util.Map;
|
|
|
|
|
|
/**
|
|
|
* 通用接口
|
|
|
* 定义系统中常用的通用数据操作方法
|
|
|
* 这些方法可以被多个实体或模块复用
|
|
|
*/
|
|
|
public interface CommonDao {
|
|
|
|
|
|
/**
|
|
|
* 获取选项列表
|
|
|
* 通常用于下拉框、复选框等表单组件的选项数据
|
|
|
* @param params 查询参数,可能包含表名、字段名、条件等
|
|
|
* @return 返回选项值的字符串列表
|
|
|
*/
|
|
|
List<String> getOption(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 根据选项获取关联数据
|
|
|
* 用于获取与某个选项相关联的详细信息
|
|
|
* @param params 查询参数,包含选项值和关联条件
|
|
|
* @return 返回关联数据的键值对映射
|
|
|
*/
|
|
|
Map<String, Object> getFollowByOption(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 根据选项获取关联数据列表
|
|
|
* 与getFollowByOption类似,但返回字符串列表而不是Map
|
|
|
* @param params 查询参数
|
|
|
* @return 返回关联数据的字符串列表
|
|
|
*/
|
|
|
List<String> getFollowByOption2(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 审核操作
|
|
|
* 通常用于更新审核状态,如通过、拒绝等
|
|
|
* @param params 审核参数,包含审核ID、审核状态、审核意见等
|
|
|
*/
|
|
|
void sh(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 提醒统计
|
|
|
* 用于统计需要提醒的记录数量,如待办事项、逾期任务等
|
|
|
* @param params 统计参数,包含统计条件、时间范围等
|
|
|
* @return 返回符合提醒条件的记录数量
|
|
|
*/
|
|
|
int remindCount(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 选择计算值
|
|
|
* 用于执行计算查询,如求和、平均值、最大值、最小值等
|
|
|
* @param params 计算参数,包含计算字段、计算类型、条件等
|
|
|
* @return 返回计算结果的键值对映射
|
|
|
*/
|
|
|
Map<String, Object> selectCal(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 分组查询
|
|
|
* 用于按某个字段分组统计数据
|
|
|
* @param params 分组参数,包含分组字段、统计字段、条件等
|
|
|
* @return 返回分组统计结果列表,每个元素是一个分组的统计信息
|
|
|
*/
|
|
|
List<Map<String, Object>> selectGroup(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 选择值
|
|
|
* 通用的数据查询方法,用于获取特定字段的值
|
|
|
* @param params 查询参数,包含表名、字段名、条件等
|
|
|
* @return 返回查询结果的键值对列表
|
|
|
*/
|
|
|
List<Map<String, Object>> selectValue(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 时间统计值
|
|
|
* 专门用于按时间维度进行统计,如按日、周、月、年统计
|
|
|
* @param params 时间统计参数,包含时间字段、统计类型、时间范围等
|
|
|
* @return 返回时间统计结果列表
|
|
|
*/
|
|
|
List<Map<String, Object>> selectTimeStatValue(Map<String, Object> params);
|
|
|
} |