diff --git a/src/org/redkale/source/ColumnExpress.java b/src/org/redkale/source/ColumnExpress.java index ce36db0e5..ef06ed9f3 100644 --- a/src/org/redkale/source/ColumnExpress.java +++ b/src/org/redkale/source/ColumnExpress.java @@ -14,9 +14,24 @@ package org.redkale.source; * @author zhangjx */ public enum ColumnExpress { - MOV, //直接赋值 col = val - INC, //追加值 col = col + val - MUL, //乘值 col = col * val - AND, //与值 col = col & val - ORR; //或值 col = col | val + /** + * 直接赋值 col = val + */ + MOV, + /** + * 追加值 col = col + val + */ + INC, + /** + * 乘值 col = col * val + */ + MUL, + /** + * 与值 col = col & val + */ + AND, //与值 col = col & val + /** + * 或值 col = col | val + */ + ORR; } diff --git a/src/org/redkale/source/ColumnValue.java b/src/org/redkale/source/ColumnValue.java index 3403d866d..1636713cd 100644 --- a/src/org/redkale/source/ColumnValue.java +++ b/src/org/redkale/source/ColumnValue.java @@ -38,26 +38,74 @@ public class ColumnValue { this.value = value; } + /** + * 同 mov 操作 + * + * @param column 字段名 + * @param value 字段值 + * + * @return ColumnValue + */ public static ColumnValue create(String column, Serializable value) { return new ColumnValue(column, value); } + /** + * 返回 {column} = {value} 操作 + * + * @param column 字段名 + * @param value 字段值 + * + * @return ColumnValue + */ public static ColumnValue mov(String column, Serializable value) { return new ColumnValue(column, MOV, value); } + /** + * 返回 {column} = {column} + {value} 操作 + * + * @param column 字段名 + * @param value 字段值 + * + * @return ColumnValue + */ public static ColumnValue inc(String column, Serializable value) { return new ColumnValue(column, INC, value); } + /** + * 返回 {column} = {column} * {value} 操作 + * + * @param column 字段名 + * @param value 字段值 + * + * @return ColumnValue + */ public static ColumnValue mul(String column, Serializable value) { return new ColumnValue(column, MUL, value); } + /** + * 返回 {column} = {column} & {value} 操作 + * + * @param column 字段名 + * @param value 字段值 + * + * @return ColumnValue + */ public static ColumnValue and(String column, Serializable value) { return new ColumnValue(column, AND, value); } + /** + * 返回 {column} = {column} | {value} 操作 + * + * @param column 字段名 + * @param value 字段值 + * + * @return ColumnValue + */ public static ColumnValue orr(String column, Serializable value) { return new ColumnValue(column, ORR, value); } diff --git a/src/org/redkale/source/DataDefaultSource.java b/src/org/redkale/source/DataDefaultSource.java index d569aa739..fc5858588 100644 --- a/src/org/redkale/source/DataDefaultSource.java +++ b/src/org/redkale/source/DataDefaultSource.java @@ -66,9 +66,6 @@ public final class DataDefaultSource implements DataSource, Function Map formatMap(final Class clazz, final Collection list) { - Map map = new LinkedHashMap<>(); - if (list == null || list.isEmpty()) return map; - final Attribute attr = (Attribute) loadEntityInfo(clazz).getPrimary(); - for (T t : list) { - map.put(attr.get(t), t); - } - return map; - } - /** * 根据指定字段值查询对象集合 * diff --git a/src/org/redkale/source/DataSource.java b/src/org/redkale/source/DataSource.java index 136886f12..6d31c48c9 100644 --- a/src/org/redkale/source/DataSource.java +++ b/src/org/redkale/source/DataSource.java @@ -25,7 +25,7 @@ public interface DataSource { //----------------------insert----------------------------- /** - * 新增对象， 必须是Entity对象 + * 新增记录， 必须是Entity对象
* * @param 泛型 * @param values Entity对象 @@ -34,77 +34,167 @@ public interface DataSource { //-------------------------delete-------------------------- /** - * 删除对象， 必须是Entity对象 + * 删除指定主键值的记录， 必须是Entity对象
+ * 等价SQL: DELETE FROM {table} WHERE {primary} IN {values.id}
* * @param 泛型 * @param values Entity对象 * - * @return 删除的数据条数 + * @return 影响的记录条数 */ public int delete(final T... values); /** - * 根据主键值删除数据 - * 等价SQL: DELETE FROM WHERE {primary} IN {ids} + * 删除指定主键值的记录
+ * 等价SQL: DELETE FROM {table} WHERE {primary} IN {ids}
* - * @param Entity类的泛型 + * @param Entity泛型 * @param clazz Entity类 * @param ids 主键值 * - * @return 删除的数据条数 + * @return 影响的记录条数 */ public int delete(final Class clazz, final Serializable... ids); + /** + * 删除符合过滤条件的记录
+ * 等价SQL: DELETE FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param node 过滤条件 + * + * @return 影响的记录条数 + */ public int delete(final Class clazz, final FilterNode node); /** - * 根据过滤条件删除指定行数的数据 - * Flipper中offset字段将被忽略 + * 删除符合过滤条件且指定最大影响条数的记录
+ * Flipper中offset字段将被忽略
+ * 等价SQL: DELETE FROM {table} WHERE {filter node} ORDER BY {flipper.sort} LIMIT {flipper.limit}
* - * @param Entity类的泛型 + * @param Entity泛型 * @param clazz Entity类 * @param flipper 翻页对象 * @param node 过滤条件 * - * @return 影响的行数 + * @return 影响的记录条数 */ public int delete(final Class clazz, final Flipper flipper, final FilterNode node); //------------------------update--------------------------- /** - * 更新对象， 必须是Entity对象 + * 更新记录， 必须是Entity对象
+ * 等价SQL:
+ * UPDATE {table} SET column1 = value1, column2 = value2, ··· WHERE {primary} = {id1}
+ * UPDATE {table} SET column1 = value1, column2 = value2, ··· WHERE {primary} = {id2}
+ * ···
* * @param 泛型 * @param values Entity对象 * - * @return 更新的数据条数 + * @return 影响的记录条数 */ public int update(final T... values); + /** + * 更新单个记录的单个字段
+ * 等价SQL: UPDATE {table} SET {column} = {value} WHERE {primary} = {id}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param id 主键 + * @param column 待更新的字段名 + * @param value 更新值 + * + * @return 影响的记录条数 + */ public int updateColumn(final Class clazz, final Serializable id, final String column, final Serializable value); + /** + * 更新符合过滤条件记录的单个字段
+ * 等价SQL: UPDATE {table} SET {column} = {value} WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param column 待更新的字段名 + * @param value 更新值 + * @param node 过滤条件 + * + * @return 影响的记录条数 + */ public int updateColumn(final Class clazz, final String column, final Serializable value, final FilterNode node); + /** + * 更新指定主键值记录的部分字段
+ * 字段赋值操作选项见 ColumnExpress
+ * 等价SQL: UPDATE {table} SET {column1} = {value1}, {column2} += {value2}, {column3} *= {value3}, ··· WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param id 主键 + * @param values 更新字段 + * + * @return 影响的记录条数 + */ public int updateColumn(final Class clazz, final Serializable id, final ColumnValue... values); + /** + * 更新符合过滤条件记录的部分字段
+ * 字段赋值操作选项见 ColumnExpress
+ * 注意：Entity类中标记为@Column(updatable=false)不会被更新
+ * 等价SQL: UPDATE {table} SET {column1} = {value1}, {column2} += {value2}, {column3} *= {value3}, ··· WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param node 过滤条件 + * @param values 更新字段 + * + * @return 影响的记录条数 + */ public int updateColumn(final Class clazz, final FilterNode node, final ColumnValue... values); /** - * 更新符合条件的记录的指定字段 - * Flipper中offset字段将被忽略 + * 更新符合过滤条件的记录的指定字段
+ * Flipper中offset字段将被忽略
+ * 注意：Entity类中标记为@Column(updatable=false)不会被更新
+ * 等价SQL: UPDATE {table} SET {column1} = {value1}, {column2} += {value2}, {column3} *= {value3}, ··· WHERE {filter node} ORDER BY {flipper.sort} LIMIT {flipper.limit}
* - * @param Entity类的泛型 + * @param Entity泛型 * @param clazz Entity类 * @param node 过滤条件 * @param flipper 翻页对象 * @param values 更新字段 * - * @return 影响的行数 + * @return 影响的记录条数 */ public int updateColumn(final Class clazz, final FilterNode node, final Flipper flipper, final ColumnValue... values); + /** + * 更新单个记录的指定字段
+ * 注意：Entity类中标记为@Column(updatable=false)不会被更新
+ * 等价SQL: UPDATE {table} SET {column1} = {value1}, {column2} += {value2}, {column3} *= {value3}, ··· WHERE {primary} = {bean.id}
+ * + * @param Entity泛型 + * @param bean 待更新的Entity对象 + * @param columns 需更新的字段名 + * + * @return 影响的记录条数 + */ public int updateColumn(final T bean, final String... columns); + /** + * 更新符合过滤条件记录的指定字段
+ * 注意：Entity类中标记为@Column(updatable=false)不会被更新
+ * 等价SQL: UPDATE {table} SET {column1} = {value1}, {column2} += {value2}, {column3} *= {value3}, ··· WHERE {filter node}
+ * + * @param Entity泛型 + * @param bean 待更新的Entity对象 + * @param node 过滤条件 + * @param columns 需更新的字段名 + * + * @return 影响的记录条数 + */ public int updateColumn(final T bean, final FilterNode node, final String... columns); /** @@ -136,35 +226,191 @@ public interface DataSource { //############################################# 查询接口 ############################################# //-----------------------getXXXXResult----------------------------- + /** + * 获取符合过滤条件记录的聚合结果, 无结果返回null
+ * 等价SQL: SELECT FUNC{column} FROM {table}
+ * 如 getNumberResult(Record.class, FilterFunc.COUNT, null) 等价于: SELECT COUNT(*) FROM {table}
+ * + * @param entityClass Entity类 + * @param func 聚合函数 + * @param column 指定字段 + * + * @return 聚合结果 + */ public Number getNumberResult(final Class entityClass, final FilterFunc func, final String column); + /** + * 获取符合过滤条件记录的聚合结果, 无结果返回null
+ * 等价SQL: SELECT FUNC{column} FROM {table} WHERE {filter bean}
+ * 如 getNumberResult(Record.class, FilterFunc.COUNT, null, (FilterBean)null) 等价于: SELECT COUNT(*) FROM {table}
+ * + * @param entityClass Entity类 + * @param func 聚合函数 + * @param column 指定字段 + * @param bean 过滤条件 + * + * @return 聚合结果 + */ public Number getNumberResult(final Class entityClass, final FilterFunc func, final String column, final FilterBean bean); + /** + * 获取符合过滤条件记录的聚合结果, 无结果返回null
+ * 等价SQL: SELECT FUNC{column} FROM {table} WHERE {filter node}
+ * 如 getNumberResult(Record.class, FilterFunc.MAX, "createtime", (FilterNode)null) 等价于: SELECT MAX(createtime) FROM {table}
+ * + * @param entityClass Entity类 + * @param func 聚合函数 + * @param column 指定字段 + * @param node 过滤条件 + * + * @return 聚合结果 + */ public Number getNumberResult(final Class entityClass, final FilterFunc func, final String column, final FilterNode node); + /** + * 获取符合过滤条件记录的聚合结果, 无结果返回默认值
+ * 等价SQL: SELECT FUNC{column} FROM {table}
+ * 如 getNumberResult(Record.class, FilterFunc.MAX, "createtime") 等价于: SELECT MAX(createtime) FROM {table}
+ * + * @param entityClass Entity类 + * @param func 聚合函数 + * @param defVal 默认值 + * @param column 指定字段 + * + * @return 聚合结果 + */ public Number getNumberResult(final Class entityClass, final FilterFunc func, final Number defVal, final String column); + /** + * 获取符合过滤条件记录的聚合结果, 无结果返回默认值
+ * 等价SQL: SELECT FUNC{column} FROM {table} WHERE {filter bean}
+ * 如 getNumberResult(Record.class, FilterFunc.MAX, "createtime", (FilterNode)null) 等价于: SELECT MAX(createtime) FROM {table}
+ * + * @param entityClass Entity类 + * @param func 聚合函数 + * @param defVal 默认值 + * @param column 指定字段 + * @param bean 过滤条件 + * + * @return 聚合结果 + */ public Number getNumberResult(final Class entityClass, final FilterFunc func, final Number defVal, final String column, final FilterBean bean); + /** + * 获取符合过滤条件记录的聚合结果, 无结果返回默认值
+ * 等价SQL: SELECT FUNC{column} FROM {table} WHERE {filter node}
+ * 如 getNumberResult(Record.class, FilterFunc.MAX, "createtime", (FilterNode)null) 等价于: SELECT MAX(createtime) FROM {table}
+ * + * @param entityClass Entity类 + * @param func 聚合函数 + * @param defVal 默认值 + * @param column 指定字段 + * @param node 过滤条件 + * + * @return 聚合结果 + */ public Number getNumberResult(final Class entityClass, final FilterFunc func, final Number defVal, final String column, final FilterNode node); + /** + * 获取符合过滤条件记录的聚合结果Map
+ * 等价SQL: SELECT FUNC1{column1}, FUNC2{column2}, ··· FROM {table}
+ * 如 getNumberMap(Record.class, new FilterFuncColumn(FilterFunc.MAX, "createtime")) 等价于: SELECT MAX(createtime) FROM {table}
+ * + * @param Number + * @param entityClass Entity类 + * @param columns 聚合字段 + * + * @return 聚合结果Map + */ public Map getNumberMap(final Class entityClass, final FilterFuncColumn... columns); + /** + * 获取符合过滤条件记录的聚合结果Map
+ * 等价SQL: SELECT FUNC1{column1}, FUNC2{column2}, ··· FROM {table} WHERE {filter bean}
+ * 如 getNumberMap(Record.class, (FilterBean)null, new FilterFuncColumn(FilterFunc.MAX, "createtime")) 等价于: SELECT MAX(createtime) FROM {table}
+ * + * @param Number + * @param entityClass Entity类 + * @param bean 过滤条件 + * @param columns 聚合字段 + * + * @return 聚合结果Map + */ public Map getNumberMap(final Class entityClass, final FilterBean bean, final FilterFuncColumn... columns); + /** + * 获取符合过滤条件记录的聚合结果Map
+ * 等价SQL: SELECT FUNC1{column1}, FUNC2{column2}, ··· FROM {table} WHERE {filter node}
+ * 如 getNumberMap(Record.class, (FilterNode)null, new FilterFuncColumn(FilterFunc.MAX, "createtime")) 等价于: SELECT MAX(createtime) FROM {table}
+ * + * @param Number + * @param entityClass Entity类 + * @param node 过滤条件 + * @param columns 聚合字段 + * + * @return 聚合结果Map + */ public Map getNumberMap(final Class entityClass, final FilterNode node, final FilterFuncColumn... columns); + /** + * 查询符合过滤条件记录的GROUP BY聚合结果Map
+ * 等价SQL: SELECT keyColumn, FUNC{funcColumn} FROM {table} GROUP BY {keyColumn}
+ * 如 queryColumnMap(Record.class, "name", FilterFunc.MAX, "createtime") 等价于: SELECT name, MAX(createtime) FROM record GROUP BY name
+ * + * @param Entity泛型 + * @param Key字段的数据类型 + * @param Number + * @param entityClass Entity类 + * @param keyColumn Key字段 + * @param func 聚合函数 + * @param funcColumn 聚合字段 + * + * @return 聚合结果Map + */ public Map queryColumnMap(final Class entityClass, final String keyColumn, final FilterFunc func, final String funcColumn); + /** + * 查询符合过滤条件记录的GROUP BY聚合结果Map
+ * 等价SQL: SELECT keyColumn, FUNC{funcColumn} FROM {table} WHERE {filter bean} GROUP BY {keyColumn}
+ * 如 queryColumnMap(Record.class, "name", FilterFunc.MAX, "createtime", (FilterBean)null) 等价于: SELECT name, MAX(createtime) FROM record GROUP BY name
+ * + * @param Entity泛型 + * @param Key字段的数据类型 + * @param Number + * @param entityClass Entity类 + * @param keyColumn Key字段 + * @param func 聚合函数 + * @param funcColumn 聚合字段 + * @param bean 过滤条件 + * + * @return 聚合结果Map + */ public Map queryColumnMap(final Class entityClass, final String keyColumn, final FilterFunc func, final String funcColumn, final FilterBean bean); + /** + * 查询符合过滤条件记录的GROUP BY聚合结果Map
+ * 等价SQL: SELECT keyColumn, FUNC{funcColumn} FROM {table} WHERE {filter node} GROUP BY {keyColumn}
+ * 如 queryColumnMap(Record.class, "name", FilterFunc.MAX, "createtime", (FilterNode)null) 等价于: SELECT name, MAX(createtime) FROM record GROUP BY name
+ * + * @param Entity泛型 + * @param Key字段的数据类型 + * @param Number + * @param entityClass Entity类 + * @param keyColumn Key字段 + * @param func 聚合函数 + * @param funcColumn 聚合字段 + * @param node 过滤条件 + * + * @return 聚合结果Map + */ public Map queryColumnMap(final Class entityClass, final String keyColumn, final FilterFunc func, final String funcColumn, final FilterNode node); //-----------------------find---------------------------- /** - * 根据主键获取对象 + * 获取指定主键值的单个记录, 返回null表示不存在值
+ * 等价SQL: SELECT * FROM {table} WHERE {primary} = {id}
* - * @param 泛型 + * @param Entity泛型 * @param clazz Entity类 * @param pk 主键值 * @@ -172,43 +418,207 @@ public interface DataSource { */ public T find(final Class clazz, final Serializable pk); + /** + * 获取指定主键值的单个记录, 返回null表示不存在值
+ * 等价SQL: SELECT {column1},{column2}, ··· FROM {table} WHERE {primary} = {id}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param selects 指定字段 + * @param pk 主键值 + * + * @return Entity对象 + */ public T find(final Class clazz, final SelectColumn selects, final Serializable pk); + /** + * 获取符合过滤条件单个记录, 返回null表示不存在值
+ * 等价SQL: SELECT * FROM {table} WHERE {column} = {key}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param column 过滤字段名 + * @param key 过滤字段值 + * + * @return Entity对象 + */ public T find(final Class clazz, final String column, final Serializable key); + /** + * 获取符合过滤条件单个记录, 返回null表示不存在值
+ * 等价SQL: SELECT * FROM {table} WHERE {filter bean}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param bean 过滤条件 + * + * @return Entity对象 + */ public T find(final Class clazz, final FilterBean bean); + /** + * 获取符合过滤条件单个记录, 返回null表示不存在值
+ * 等价SQL: SELECT * FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param node 过滤条件 + * + * @return Entity对象 + */ public T find(final Class clazz, final FilterNode node); + /** + * 获取符合过滤条件单个记录, 返回null表示不存在值
+ * 等价SQL: SELECT {column1},{column2}, ··· FROM {table} WHERE {filter bean}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param selects 指定字段 + * @param bean 过滤条件 + * + * @return Entity对象 + */ public T find(final Class clazz, final SelectColumn selects, final FilterBean bean); + /** + * 获取符合过滤条件单个记录, 返回null表示不存在值
+ * 等价SQL: SELECT {column1},{column2}, ··· FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param selects 指定字段 + * @param node 过滤条件 + * + * @return Entity对象 + */ public T find(final Class clazz, final SelectColumn selects, final FilterNode node); + /** + * 获取符合过滤条件单个记录的单个字段值, 返回null表示不存在值
+ * 等价SQL: SELECT {column} FROM {table} WHERE {primary} = {id}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param column 字段名 + * @param pk 主键值 + * + * @return Entity对象 + */ public Serializable findColumn(final Class clazz, final String column, final Serializable pk); + /** + * 获取符合过滤条件单个记录的单个字段值, 返回null表示不存在值
+ * 等价SQL: SELECT {column} FROM {table} WHERE {filter bean}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param column 字段名 + * @param bean 过滤条件 + * + * @return 字段值 + */ public Serializable findColumn(final Class clazz, final String column, final FilterBean bean); + /** + * 获取符合过滤条件单个记录的单个字段值, 返回null表示不存在值
+ * 等价SQL: SELECT {column} FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param column 字段名 + * @param node 过滤条件 + * + * @return 字段值 + */ public Serializable findColumn(final Class clazz, final String column, final FilterNode node); + /** + * 获取符合过滤条件单个记录的单个字段值, 不存在值则返回默认值
+ * 等价SQL: SELECT {column} FROM {table} WHERE {primary} = {id}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param column 字段名 + * @param defValue 默认值 + * @param pk 主键值 + * + * @return 字段值 + */ public Serializable findColumn(final Class clazz, final String column, final Serializable defValue, final Serializable pk); + /** + * 获取符合过滤条件单个记录的单个字段值, 不存在值则返回默认值
+ * 等价SQL: SELECT {column} FROM {table} WHERE {filter bean}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param column 字段名 + * @param defValue 默认值 + * @param bean 过滤条件 + * + * @return 字段值 + */ public Serializable findColumn(final Class clazz, final String column, final Serializable defValue, final FilterBean bean); + /** + * 获取符合过滤条件单个记录的单个字段值, 不存在值则返回默认值
+ * 等价SQL: SELECT {column} FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param column 字段名 + * @param defValue 默认值 + * @param node 过滤条件 + * + * @return 字段值 + */ public Serializable findColumn(final Class clazz, final String column, final Serializable defValue, final FilterNode node); + /** + * 判断是否存在主键值的记录
+ * 等价SQL: SELECT COUNT(*) FROM {table} WHERE {primary} = {id}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param pk 主键值 + * + * @return 是否存在 + */ public boolean exists(final Class clazz, final Serializable pk); + /** + * 判断是否存在符合过滤条件的记录
+ * 等价SQL: SELECT COUNT(*) FROM {table} WHERE {filter bean}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param bean 过滤条件 + * + * @return 是否存在 + */ public boolean exists(final Class clazz, final FilterBean bean); + /** + * 判断是否存在符合过滤条件的记录
+ * 等价SQL: SELECT COUNT(*) FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param node 过滤条件 + * + * @return 是否存在 + */ public boolean exists(final Class clazz, final FilterNode node); //-----------------------list set---------------------------- /** - * 根据指定字段值查询对象某个字段的集合 + * 查询符合过滤条件记录的某个字段Set集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {column} = {key}
* * @param Entity泛型 * @param 字段类型 - * @param selectedColumn 字段名 + * @param selectedColumn 指定字段 * @param clazz Entity类 * @param column 过滤字段名 * @param key 过滤字段值 @@ -217,89 +627,327 @@ public interface DataSource { */ public HashSet queryColumnSet(final String selectedColumn, final Class clazz, final String column, final Serializable key); - public HashSet queryColumnSet(final String selectedColumn, final Class clazz, final FilterBean bean); - - public HashSet queryColumnSet(final String selectedColumn, final Class clazz, final FilterNode node); - - public List queryColumnList(final String selectedColumn, final Class clazz, final String column, final Serializable key); - - public List queryColumnList(final String selectedColumn, final Class clazz, final FilterBean bean); - - public List queryColumnList(final String selectedColumn, final Class clazz, final FilterNode node); - - public List queryColumnList(final String selectedColumn, final Class clazz, final Flipper flipper, final FilterBean bean); - - public List queryColumnList(final String selectedColumn, final Class clazz, final Flipper flipper, final FilterNode node); - /** - * 根据指定参数查询对象某个字段的集合 + * 查询符合过滤条件记录的某个字段Set集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {filter bean}
* * @param Entity泛型 * @param 字段类型 - * @param selectedColumn 字段名 + * @param selectedColumn 指定字段 + * @param clazz Entity类 + * @param bean 过滤条件 + * + * @return 字段值的集合 + */ + public HashSet queryColumnSet(final String selectedColumn, final Class clazz, final FilterBean bean); + + /** + * 查询符合过滤条件记录的某个字段Set集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param 字段类型 + * @param selectedColumn 指定字段 + * @param clazz Entity类 + * @param node 过滤条件 + * + * @return 字段值的集合 + */ + public HashSet queryColumnSet(final String selectedColumn, final Class clazz, final FilterNode node); + + /** + * 查询符合过滤条件记录的某个字段List集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {column} = {key}
+ * + * @param Entity泛型 + * @param 字段类型 + * @param selectedColumn 指定字段 + * @param clazz Entity类 + * @param column 过滤字段名 + * @param key 过滤字段值 + * + * @return 字段值的集合 + */ + public List queryColumnList(final String selectedColumn, final Class clazz, final String column, final Serializable key); + + /** + * 查询符合过滤条件记录的某个字段List集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {filter bean}
+ * + * @param Entity泛型 + * @param 字段类型 + * @param selectedColumn 指定字段 + * @param clazz Entity类 + * @param bean 过滤条件 + * + * @return 字段值的集合 + */ + public List queryColumnList(final String selectedColumn, final Class clazz, final FilterBean bean); + + /** + * 查询符合过滤条件记录的某个字段List集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param 字段类型 + * @param selectedColumn 指定字段 + * @param clazz Entity类 + * @param node 过滤条件 + * + * @return 字段值的集合 + */ + public List queryColumnList(final String selectedColumn, final Class clazz, final FilterNode node); + + /** + * 查询符合过滤条件记录的某个字段List集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {filter bean} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param 字段类型 + * @param selectedColumn 指定字段 * @param clazz Entity类 * @param flipper 翻页对象 - * @param bean 过滤Bean + * @param bean 过滤条件 * - * @return 结果集合 + * @return 字段值的集合 + */ + public List queryColumnList(final String selectedColumn, final Class clazz, final Flipper flipper, final FilterBean bean); + + /** + * 查询符合过滤条件记录的某个字段List集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {filter node} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param 字段类型 + * @param selectedColumn 指定字段 + * @param clazz Entity类 + * @param flipper 翻页对象 + * @param node 过滤条件 + * + * @return 字段值的集合 + */ + public List queryColumnList(final String selectedColumn, final Class clazz, final Flipper flipper, final FilterNode node); + + /** + * 查询符合过滤条件记录的某个字段Sheet集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {filter node} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param 字段类型 + * @param selectedColumn 指定字段 + * @param clazz Entity类 + * @param flipper 翻页对象 + * @param bean 过滤条件 + * + * @return 字段值的集合 */ public Sheet queryColumnSheet(final String selectedColumn, final Class clazz, final Flipper flipper, final FilterBean bean); + /** + * 查询符合过滤条件记录的某个字段Sheet集合
+ * 等价SQL: SELECT {selectedColumn} FROM {table} WHERE {filter bean} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param 字段类型 + * @param selectedColumn 指定字段 + * @param clazz Entity类 + * @param flipper 翻页对象 + * @param node 过滤条件 + * + * @return 字段值的集合 + */ public Sheet queryColumnSheet(final String selectedColumn, final Class clazz, final Flipper flipper, final FilterNode node); /** - * 根据指定字段值查询对象集合 + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT * FROM {table} WHERE {column} = {key} ORDER BY {flipper.sort} LIMIT {flipper.limit}
* * @param Entity泛型 * @param clazz Entity类 * @param column 过滤字段名 * @param key 过滤字段值 * - * @return Entity的List + * @return Entity的集合 */ public List queryList(final Class clazz, final String column, final Serializable key); + /** + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT * FROM {table} WHERE {filter bean}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param bean 过滤条件 + * + * @return Entity的集合 + */ public List queryList(final Class clazz, final FilterBean bean); + /** + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT * FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param node 过滤条件 + * + * @return Entity的集合 + */ public List queryList(final Class clazz, final FilterNode node); + /** + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT {column1},{column2}, ··· FROM {table} WHERE {filter bean}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param selects 指定字段 + * @param bean 过滤条件 + * + * @return Entity的集合 + */ public List queryList(final Class clazz, final SelectColumn selects, final FilterBean bean); + /** + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT {column1},{column2}, ··· FROM {table} WHERE {filter node}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param selects 指定字段 + * @param node 过滤条件 + * + * @return Entity的集合 + */ public List queryList(final Class clazz, final SelectColumn selects, final FilterNode node); + /** + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT * FROM {table} WHERE {column} = {key} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param flipper 翻页对象 + * @param column 过滤字段名 + * @param key 过滤字段值 + * + * @return Entity的集合 + */ public List queryList(final Class clazz, final Flipper flipper, final String column, final Serializable key); + /** + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT * FROM {table} WHERE {filter bean} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param flipper 翻页对象 + * @param bean 过滤条件 + * + * @return Entity的集合 + */ public List queryList(final Class clazz, final Flipper flipper, final FilterBean bean); + /** + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT * FROM {table} WHERE {filter node} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param flipper 翻页对象 + * @param node 过滤条件 + * + * @return Entity的集合 + */ public List queryList(final Class clazz, final Flipper flipper, final FilterNode node); + /** + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT {column1},{column2}, ··· FROM {table} WHERE {filter bean} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param selects 指定字段 + * @param flipper 翻页对象 + * @param bean 过滤条件 + * + * @return Entity的集合 + */ public List queryList(final Class clazz, final SelectColumn selects, final Flipper flipper, final FilterBean bean); + /** + * 查询符合过滤条件记录的List集合
+ * 等价SQL: SELECT {column1},{column2}, ··· FROM {table} WHERE {filter node} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param selects 指定字段 + * @param flipper 翻页对象 + * @param node 过滤条件 + * + * @return Entity的集合 + */ public List queryList(final Class clazz, final SelectColumn selects, final Flipper flipper, final FilterNode node); //-----------------------sheet---------------------------- /** - * 根据指定参数查询对象某个对象的集合页 - *

+ * 查询符合过滤条件记录的Sheet集合
+ * 等价SQL: SELECT * FROM {table} WHERE {filter bean} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * * @param Entity泛型 * @param clazz Entity类 * @param flipper 翻页对象 - * @param bean 过滤Bean + * @param bean 过滤条件 * - * @return Entity的Sheet + * @return Entity的集合 */ public Sheet querySheet(final Class clazz, final Flipper flipper, final FilterBean bean); + /** + * 查询符合过滤条件记录的Sheet集合
+ * 等价SQL: SELECT * FROM {table} WHERE {filter node} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param flipper 翻页对象 + * @param node 过滤条件 + * + * @return Entity的集合 + */ public Sheet querySheet(final Class clazz, final Flipper flipper, final FilterNode node); + /** + * 查询符合过滤条件记录的Sheet集合
+ * 等价SQL: SELECT {column1},{column2}, ··· FROM {table} WHERE {filter bean} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param selects 指定字段 + * @param flipper 翻页对象 + * @param bean 过滤条件 + * + * @return Entity的集合 + */ public Sheet querySheet(final Class clazz, final SelectColumn selects, final Flipper flipper, final FilterBean bean); + /** + * 查询符合过滤条件记录的Sheet集合
+ * 等价SQL: SELECT {column1},{column2}, ··· FROM {table} WHERE {filter node} ORDER BY {flipper.sort} LIMIT {flipper.limit}
+ * + * @param Entity泛型 + * @param clazz Entity类 + * @param selects 指定字段 + * @param flipper 翻页对象 + * @param node 过滤条件 + * + * @return Entity的集合 + */ public Sheet querySheet(final Class clazz, final SelectColumn selects, final Flipper flipper, final FilterNode node); //-----------------------direct---------------------------- /** - * 直接本地执行SQL语句进行查询，远程模式不可用 - * 通常用于复杂的关联查询 + * 直接本地执行SQL语句进行查询，远程模式不可用
+ * 通常用于复杂的关联查询
* * @param sql SQL语句 * @param consumer 回调函数 @@ -307,8 +955,8 @@ public interface DataSource { public void directQuery(String sql, final Consumer consumer); /** - * 直接本地执行SQL语句进行增删改操作，远程模式不可用 - * 通常用于复杂的更新操作 + * 直接本地执行SQL语句进行增删改操作，远程模式不可用
+ * 通常用于复杂的更新操作
* * @param sqls SQL语句 *