|
|
|
|
|
package com.dao;
|
|
|
|
|
|
import java.util.List;
|
|
|
import java.util.Map;
|
|
|
|
|
|
/**
|
|
|
* 通用接口，定义了一系列通用的数据操作方法，供具体的实现类去实现这些方法以满足不同的数据处理需求。
|
|
|
* 这些方法通常会涉及到数据库查询、统计等相关操作，通过传入不同的参数来控制具体的操作逻辑。
|
|
|
*/
|
|
|
|
|
|
public interface CommonDao{
|
|
|
|
|
|
/**
|
|
|
* 获取选项列表的方法，根据传入的参数（params）来查询并返回相应的选项列表。
|
|
|
* 参数 params 是一个 Map<String, Object> 类型，其具体的键值对内容取决于具体的业务需求，
|
|
|
* 例如可能包含查询条件、筛选字段等信息，用于确定获取哪些选项数据。
|
|
|
* 返回值是一个包含字符串的列表（List<String>），每个字符串元素代表一个选项内容。
|
|
|
* @param params 用于控制查询选项列表的参数集合
|
|
|
* @return 符合条件的选项列表
|
|
|
*/
|
|
|
List<String> getOption(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 根据传入的选项相关参数（params），查询并返回对应的关注信息（具体含义取决于业务场景），以 Map 的形式返回结果。
|
|
|
* 参数 params 同样是 Map<String, Object> 类型，包含了用于确定关注信息查询范围、条件等的各种键值对信息。
|
|
|
* 返回值是一个 Map<String, Object>，其中键表示关注信息的不同属性，值则是对应属性的具体内容。
|
|
|
* @param params 用于控制查询关注信息的参数集合
|
|
|
* @return 包含关注信息的 Map
|
|
|
*/
|
|
|
Map<String, Object> getFollowByOption(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 与 getFollowByOption 类似，也是根据传入的选项相关参数（params）查询关注信息，不过返回值类型为 List<String>。
|
|
|
* 具体返回的字符串列表内容以及参数 params 的含义都取决于具体业务逻辑，可能是另一种形式的关注信息表示。
|
|
|
* @param params 用于控制查询关注信息的参数集合
|
|
|
* @return 符合条件的关注信息列表（以字符串形式表示）
|
|
|
*/
|
|
|
List<String> getFollowByOption2(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 执行某个操作（从方法名 sh 推测可能是一个特定的业务操作，具体含义需结合业务场景确定），
|
|
|
* 通过传入参数（params）来控制该操作的具体行为，该方法无返回值，意味着它可能主要用于对数据进行修改、更新等操作。
|
|
|
* @param params 用于控制操作执行的参数集合
|
|
|
*/
|
|
|
void sh(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 用于统计提醒相关的数量，根据传入的参数（params）确定统计的范围、条件等信息，返回统计得到的提醒数量。
|
|
|
* 参数 params 作为 Map<String, Object> 类型，包含了如时间范围、提醒类型等各种影响统计结果的条件信息。
|
|
|
* 返回值为整型（int），代表符合条件的提醒数量。
|
|
|
* @param params 用于控制提醒数量统计的参数集合
|
|
|
* @return 提醒的数量
|
|
|
*/
|
|
|
int remindCount(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 根据传入的参数（params）进行计算操作（从方法名 selectCal 推测可能是某种选择计算，具体取决于业务逻辑），
|
|
|
* 返回计算后的结果，以 Map<String, Object> 形式呈现，其中键可以表示计算结果的不同属性，值则是对应属性的具体数值等内容。
|
|
|
* @param params 用于控制计算操作的参数集合
|
|
|
* @return 包含计算结果的 Map
|
|
|
*/
|
|
|
Map<String, Object> selectCal(Map<String, Object> params);
|
|
|
/**
|
|
|
tableName 查询表
|
|
|
condition1 条件1
|
|
|
condition1Value 条件1值
|
|
|
average 计算平均评分
|
|
|
* */
|
|
|
|
|
|
/**
|
|
|
* 查询评分相关信息的方法，根据传入的参数（params）确定查询的表（tableName）、条件（condition1 及 condition1Value）等信息，
|
|
|
* 可能还涉及到平均评分（average）相关的计算或筛选逻辑，最终返回包含评分相关信息的 Map<String, Object>。
|
|
|
* 参数 params 中各键值对具体含义如注释中所描述，用于精确控制评分信息的查询操作。
|
|
|
* @param params 用于控制评分信息查询的参数集合，包含查询表名、条件及相关计算控制等信息
|
|
|
* @return 包含评分相关信息的 Map
|
|
|
*/
|
|
|
Map<String, Object> queryScore(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 执行分组查询操作，根据传入的参数（params）确定分组的依据、查询的数据表等信息，
|
|
|
* 返回一个包含多个 Map<String, Object> 的列表（List<Map<String, Object>>），每个内层的 Map 可能表示一组分组查询后的结果信息，
|
|
|
* 例如包含分组字段以及对应分组下的其他相关数据等内容，具体取决于业务逻辑的设计。
|
|
|
* @param params 用于控制分组查询操作的参数集合
|
|
|
* @return 分组查询后的结果列表，每个元素为一组分组相关的信息 Map
|
|
|
*/
|
|
|
List<Map<String, Object>> selectGroup(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 根据传入的参数（params）进行按值查询操作（具体按什么值以及查询逻辑取决于业务场景），
|
|
|
* 返回一个包含多个 Map<String, Object> 的列表（List<Map<String, Object>>），每个内层的 Map 对应按值查询后的一组结果信息，
|
|
|
* 其具体的键值对内容表示按值查询相关的属性及对应的值，由具体业务逻辑决定。
|
|
|
* @param params 用于控制按值查询操作的参数集合
|
|
|
* @return 按值查询后的结果列表，每个元素为一组按值相关的信息 Map
|
|
|
*/
|
|
|
List<Map<String, Object>> selectValue(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 用于进行图表相关的综合查询操作（从方法名 chartBoth 推测可能涉及到多方面图表数据生成相关逻辑），
|
|
|
* 根据传入的参数（params）来确定具体的查询条件、涉及的数据表等信息，
|
|
|
* 返回一个包含多个 Map<String, Object> 的列表（List<Map<String, Object>>），该列表包含了图表生成所需的各种数据信息，
|
|
|
* 具体每个 Map 中的键值对内容以及整体列表结构取决于图表的类型和业务需求，例如可能包含图表的系列数据、坐标轴数据等。
|
|
|
* @param params 用于控制图表综合查询操作的参数集合
|
|
|
* @return 图表相关综合查询后的结果列表，用于后续图表生成等操作
|
|
|
*/
|
|
|
List<Map<String, Object>> chartBoth(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 进行图表相关的某种单一查询操作（与 chartBoth 相对，可能只涉及图表某一方面的数据查询，具体取决于业务逻辑），
|
|
|
* 依据传入的参数（params）确定查询范围和条件，返回一个包含多个 Map<String, Object> 的列表（List<Map<String, Object>>），
|
|
|
* 列表中的每个 Map 包含了此次单一图表查询相关的结果信息，具体内容由业务逻辑决定，例如可能是图表某一数据系列的数据等。
|
|
|
* @param params 用于控制图表单一查询操作的参数集合
|
|
|
* @return 图表相关单一查询后的结果列表，用于特定图表部分的数据展示等操作
|
|
|
*/
|
|
|
List<Map<String, Object>> chartOne(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 下面为新加的
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 此接口（推测所在接口定义了一系列与数据统计相关的方法，这里是其中部分方法，具体需结合完整接口来看）用于提供不同条件下的数据统计功能，
|
|
|
* 涉及到新的级联字典表以及普通表按日期分组等多种统计场景，通过传入不同的参数来控制具体的统计逻辑，返回相应的统计结果数据结构。
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 新的级联字典表的 分组求和方法
|
|
|
* @param params
|
|
|
* @return
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 新的级联字典表的分组求和方法。
|
|
|
* 该方法接收一个参数 params，它是一个 Map<String, Object> 类型，其中包含了执行分组求和操作所需要的各种条件信息、配置参数等，
|
|
|
* 例如可能包含要操作的数据表名称、分组的字段、求和的字段以及其他相关筛选条件等内容（具体取决于业务逻辑和实际应用场景）。
|
|
|
* 返回值是一个 List<Map<String, Object>> 类型的列表，列表中的每个 Map 表示一组分组求和后的统计结果信息，
|
|
|
* 其内部的键值对可以是分组字段以及对应的求和结果等内容，方便后续对分组求和数据进行处理和展示等操作。
|
|
|
* @param params 用于控制新的级联字典表分组求和操作的参数集合
|
|
|
* @return 新的级联字典表分组求和后的统计结果列表，每个元素为一组分组求和相关的信息 Map
|
|
|
*/
|
|
|
List<Map<String, Object>> newSelectGroupSum(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 新的级联字典表的 分组条数统计统计方法方法
|
|
|
* @param params
|
|
|
* @return
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 新的级联字典表的分组条数统计方法。
|
|
|
* 接收参数 params（Map<String, Object> 类型），这个参数用于明确分组统计条数操作的具体条件，
|
|
|
* 像涉及的数据表、按照哪些字段进行分组、可能的筛选条件等信息都会通过 params 传递进来（具体由业务逻辑决定）。
|
|
|
* 方法返回一个 List<Map<String, Object>> 类型的列表，里面的每一个 Map 对应一组分组统计总条数的结果信息，
|
|
|
* 例如可能包含分组字段以及对应的记录条数等键值对内容，以满足不同业务场景下对分组统计条数结果的使用需求。
|
|
|
* @param params 用于控制新的级联字典表分组条数统计操作的参数集合
|
|
|
* @return 新的级联字典表分组条数统计后的结果列表，每个元素为一组分组统计条数相关的信息 Map
|
|
|
*/
|
|
|
List<Map<String, Object>> newSelectGroupCount(Map<String, Object> params);
|
|
|
|
|
|
|
|
|
/**
|
|
|
* 当前表的日期分组求和
|
|
|
* @param params
|
|
|
* @return
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 当前表的日期分组求和方法。
|
|
|
* 接收一个 Map<String, Object> 类型的参数 params，该参数会传入当前表进行日期分组求和操作所需要的各项设置信息，
|
|
|
* 比如要操作的表名、用于分组的日期字段（以及日期格式化相关配置等，可能在方法内部进一步处理）、求和的目标字段以及其他限定条件等（具体依据业务逻辑而定）。
|
|
|
* 方法返回值为 List<Map<String, Object>> 类型的列表，其中每个 Map 代表一组按照日期分组求和后的统计结果数据，
|
|
|
* 例如可能包含日期分组标识（如具体的年、月、日等形式，取决于业务对日期的处理方式）以及对应的求和数值等键值对内容，便于后续基于日期分组求和结果进行数据展示或其他处理。
|
|
|
* @param params 用于控制当前表日期分组求和操作的参数集合
|
|
|
* @return 当前表日期分组求和后的统计结果列表，每个元素为一组日期分组求和相关的信息 Map
|
|
|
*/
|
|
|
List<Map<String, Object>> newSelectDateGroupSum(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 查询字典表的分组统计总条数
|
|
|
* @param params
|
|
|
* @return
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 查询字典表的分组统计总条数方法。
|
|
|
* 同样以 Map<String, Object> 类型的 params 参数来控制具体的统计操作，params 中涵盖了诸如要查询的字典表名称、分组依据的字段以及其他相关筛选条件等信息（由业务场景决定具体内容）。
|
|
|
* 该方法返回的是 List<Map<String, Object>> 类型的列表，列表里的每个 Map 对应一组字典表分组统计总条数的结果情况，
|
|
|
* 通常会包含分组字段以及该分组下的记录总条数等键值对，方便在不同业务需求下对字典表分组统计的结果进行使用和展示。
|
|
|
* @param params 用于控制查询字典表分组统计总条数操作的参数集合
|
|
|
* @return 查询字典表分组统计总条数后的结果列表，每个元素为一组分组统计总条数相关的信息 Map
|
|
|
*/
|
|
|
List<Map<String, Object>> newSelectDateGroupCount(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 增加字段值
|
|
|
* @param params
|
|
|
* @return
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 此接口（推测所在接口定义了一系列用于对数据字段进行操作的方法，这里展示的是其中部分方法，需结合完整接口定义来综合理解），
|
|
|
* 提供了针对数据字段进行值变更相关的操作功能，通过传入不同的参数来控制具体的操作逻辑以及操作的目标字段等信息，
|
|
|
* 并且以整型（int）返回值来表示操作的执行情况或者受影响的记录数量等（具体含义取决于各方法业务逻辑）。
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 增加字段值的方法。
|
|
|
* 接收一个 Map<String, Object> 类型的参数 params，该参数用于指定增加字段值操作的相关条件及目标字段等信息。
|
|
|
* 例如，params 中可能包含要操作的数据表名称、需要增加数值的具体字段名、增加的数值大小、以及可能的筛选条件（用于确定对哪些记录的字段值进行增加操作）等内容，
|
|
|
* 具体的键值对含义取决于业务场景的具体需求。
|
|
|
* 返回值为整型（int），其意义可能是成功增加数值的记录条数，或者表示操作执行是否成功的某种状态码（具体由该方法在业务逻辑中的定义决定）。
|
|
|
* @param params 用于控制增加字段值操作的参数集合
|
|
|
* @return 整型值，可能表示受影响的记录数量或者操作执行的状态标识等情况
|
|
|
*/
|
|
|
int plusCloumNumber(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 减少字段值
|
|
|
* @param params
|
|
|
* @return
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 减少字段值的方法。
|
|
|
* 同样接收 Map<String, Object> 类型的参数 params，这个参数在此处用于明确减少字段值操作的具体细节，
|
|
|
* 像要操作的数据表、待减少数值的目标字段、减少的数值量以及相关筛选条件（限定对哪些记录执行字段值减少操作）等信息会通过 params 传入（具体依据业务逻辑而定）。
|
|
|
* 方法返回一个整型（int）值，该值的含义大概率与操作的执行结果相关，比如成功减少数值的记录数量，或者用于标识操作是否顺利完成的一个状态值（取决于具体业务对该方法返回值的定义）。
|
|
|
* @param params 用于控制减少字段值操作的参数集合
|
|
|
* @return 整型值，可用于表示受影响的记录数量或者操作执行的状态情况
|
|
|
*/
|
|
|
int reduceCloumNumber(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 修改字段值
|
|
|
* @param params
|
|
|
* @return
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 修改字段值的方法。
|
|
|
* 它以 Map<String, Object> 类型的 params 参数来控制具体的修改操作逻辑，params 里面会包含诸如要操作的数据表名称、需要修改值的目标字段、修改后的新值、
|
|
|
* 以及用于筛选出要修改记录的条件等关键信息（具体内容由业务场景所规定）。
|
|
|
* 该方法返回的整型（int）值通常用于反馈修改操作的执行情况，可能代表成功修改的记录条数，或者是用于指示操作是否成功完成的一个状态标识（取决于该方法在业务逻辑中的具体定义）。
|
|
|
* @param params 用于控制修改字段值操作的参数集合
|
|
|
* @return 整型值，一般表示受影响的记录数量或者操作执行的状态标识等情况
|
|
|
*/
|
|
|
int updateCloumValue(Map<String, Object> params);
|
|
|
|
|
|
|
|
|
/**
|
|
|
* 饼状图
|
|
|
* -- 饼状图 查询当前表
|
|
|
-- 查询字典表【月】
|
|
|
-- 统计 -- 查询某个月的每个类型的订单销售数量
|
|
|
-- 求和 -- 查询某个月的每个类型的订单销售额
|
|
|
-- 查询某个字符串【月】
|
|
|
-- 统计 -- 查询某个月的每个员工的订单销售数量
|
|
|
-- 求和 -- 查询某个月的每个员工的订单销售额
|
|
|
-- 查询时间【年】
|
|
|
-- 统计 -- 查询每个月的订单销售数量
|
|
|
-- 求和 -- 查询每个月的订单销售额
|
|
|
-- 饼状图 查询级联表
|
|
|
-- 查询字典表
|
|
|
-- 统计 -- 查询某个月的每个类型的订单销售数量
|
|
|
-- 求和 -- 查询某个月的每个类型的订单销售额
|
|
|
-- 查询某个字符串
|
|
|
-- 统计 -- 查询某个月的每个员工的订单销售数量
|
|
|
-- 求和 -- 查询某个月的每个员工的订单销售额
|
|
|
-- 查询时间
|
|
|
-- 统计 -- 统计每个月的订单销售数量
|
|
|
-- 求和 -- 查询每个月的订单销售额
|
|
|
*/
|
|
|
|
|
|
|
|
|
/**
|
|
|
* 柱状图
|
|
|
-- 柱状图 查询当前表
|
|
|
-- 某个【年，月】
|
|
|
-- 当前表 2 级联表 1
|
|
|
-- 统计
|
|
|
-- 【日期，字符串，下拉框】
|
|
|
-- 求和
|
|
|
-- 【日期，字符串，下拉框】
|
|
|
-- 柱状图 查询级联表
|
|
|
-- 某个【年，月】
|
|
|
-- 统计
|
|
|
-- 【日期，字符串，下拉框】
|
|
|
-- 求和
|
|
|
-- 【日期，字符串，下拉框】
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 柱状图求和
|
|
|
* @param params
|
|
|
* @return
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 此接口（推测属于某个与数据统计及图表相关业务逻辑对应的接口，此处展示的是其中部分方法，需结合完整接口来全面理解）定义了用于生成柱状图相关数据的方法，
|
|
|
* 分别提供了柱状图求和以及柱状图统计的功能，通过接收包含不同配置信息的参数，来确定具体的统计逻辑以及生成符合柱状图展示需求的数据结构，
|
|
|
* 并以包含多个 Map<String, Object> 的列表形式返回相应的统计结果数据，方便后续用于柱状图的渲染展示等操作。
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 柱状图求和方法。
|
|
|
* 接收一个 Map<String, Object> 类型的参数 params，该参数用于传递与柱状图求和操作相关的各种配置及数据信息，
|
|
|
* 例如可能包含要统计的数据表名称、用于分组的字段（比如按照不同类别、时间段等进行分组）、求和的目标字段（确定对哪些数据进行求和计算）、
|
|
|
* 以及可能涉及到的其他筛选条件（限定参与求和计算的数据范围）等内容，具体的键值对含义取决于具体的业务场景和柱状图展示需求。
|
|
|
* 返回值为 List<Map<String, Object>> 类型的列表，列表中的每个 Map 表示一组柱状图求和后的统计结果信息，
|
|
|
* 比如可能包含分组字段对应的标识（如具体的分类名称、日期等）以及对应的求和数值等键值对内容，这些结果数据可用于构建柱状图中不同分组下的求和展示部分，
|
|
|
* 以直观呈现各分组的数据总和情况。
|
|
|
* @param params 用于控制柱状图求和操作的参数集合
|
|
|
* @return 柱状图求和后的统计结果列表，每个元素为一组求和相关的信息 Map，用于后续柱状图展示
|
|
|
*/
|
|
|
List<Map<String, Object>> barSum(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 柱状图统计
|
|
|
* @param params
|
|
|
* @return
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 柱状图统计方法。
|
|
|
* 同样以 Map<String, Object> 类型的参数 params 来控制具体的统计操作逻辑，params 中涵盖了诸如要操作的数据表信息、分组依据的字段、统计的具体规则（比如计数、平均值等统计方式，具体取决于业务实现）、
|
|
|
* 以及其他相关的筛选条件（用于精准确定参与统计的数据范围）等关键信息，其具体内容由业务场景所决定，旨在满足不同柱状图统计需求。
|
|
|
* 该方法返回的是 List<Map<String, Object>> 类型的列表，其中每个 Map 对应一组柱状图统计后的结果信息，
|
|
|
* 像可能包含分组标识以及对应的统计数值（例如分组下的记录条数、平均值等，具体根据统计方式而定）等键值对，这些结果数据可用于在柱状图中展示相应的统计情况，
|
|
|
* 帮助用户直观了解数据分布及特征等信息。
|
|
|
* @param params 用于控制柱状图统计操作的参数集合
|
|
|
* @return 柱状图统计后的结果列表，每个元素为一组统计相关的信息 Map，便于后续柱状图的构建展示
|
|
|
*/
|
|
|
List<Map<String, Object>> barCount(Map<String, Object> params);
|
|
|
|
|
|
|
|
|
|
|
|
}
|
