diff --git a/src/org/redkale/source/DataSource.java b/src/org/redkale/source/DataSource.java index 519158b7e..9717cf9d1 100644 --- a/src/org/redkale/source/DataSource.java +++ b/src/org/redkale/source/DataSource.java @@ -13,6 +13,8 @@ import java.util.function.Consumer; import org.redkale.util.*; /** + * + * DataSource 为数据库或内存数据库的数据源,提供类似JPA、Hibernate的接口与功能。 * *
* 详情见: http://redkale.org diff --git a/src/org/redkale/source/FilterBean.java b/src/org/redkale/source/FilterBean.java index a8d1baa90..1368af025 100644 --- a/src/org/redkale/source/FilterBean.java +++ b/src/org/redkale/source/FilterBean.java @@ -7,6 +7,8 @@ package org.redkale.source; /** + * + * 不被标记为@javax.persistence.Transient 的字段均视为过滤条件 * *
详情见: http://redkale.org * @author zhangjx diff --git a/src/org/redkale/source/FilterColumn.java b/src/org/redkale/source/FilterColumn.java index b668edfbd..f4089a9dd 100644 --- a/src/org/redkale/source/FilterColumn.java +++ b/src/org/redkale/source/FilterColumn.java @@ -10,6 +10,7 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.*; /** + * 过滤字段标记 * *
* 详情见: http://redkale.org diff --git a/src/org/redkale/source/FilterExpress.java b/src/org/redkale/source/FilterExpress.java index dc2be48b1..9a5857b4c 100644 --- a/src/org/redkale/source/FilterExpress.java +++ b/src/org/redkale/source/FilterExpress.java @@ -6,6 +6,7 @@ package org.redkale.source; /** + * 函数表达式, 均与SQL定义中的表达式相同 * *
* 详情见: http://redkale.org diff --git a/src/org/redkale/source/FilterFunc.java b/src/org/redkale/source/FilterFunc.java index 8b45be5ab..a0a539a19 100644 --- a/src/org/redkale/source/FilterFunc.java +++ b/src/org/redkale/source/FilterFunc.java @@ -6,17 +6,20 @@ package org.redkale.source; /** + * 常见的SQL聚合函数 + * + *
+ * 详情见: http://redkale.org * - *
详情见: http://redkale.org * @author zhangjx */ public enum FilterFunc { - AVG, - COUNT, - DISTINCTCOUNT, - MAX, - MIN, - SUM; + AVG, //平均值 + COUNT, //总数 + DISTINCTCOUNT, //去重总数 + MAX, //最大值 + MIN, //最小值 + SUM; //求和 public String getColumn(String col) { if (this == DISTINCTCOUNT) return "COUNT(DISTINCT " + col + ")"; diff --git a/src/org/redkale/source/FilterGroup.java b/src/org/redkale/source/FilterGroup.java index 12769658e..e324a522f 100644 --- a/src/org/redkale/source/FilterGroup.java +++ b/src/org/redkale/source/FilterGroup.java @@ -51,7 +51,7 @@ import java.lang.annotation.*; * * 转换的SQL语句为: WHERE id = ? AND ((desc LIKE ? AND name LIKE ?) OR (age = ? OR birthday = ?)) * 因为默认是AND关系, @FilterGroup("") 等价于 @FilterGroup("[AND]") - * 所以示例二的@FilterGroup("[OR]g1.[AND]subg1") 可以简化为 @FilterGroup("[OR]g1") + * 所以示例二的@FilterGroup("[OR]g1.[AND]subg1") 可以简化为 @FilterGroup("[OR]g1.subg1") */ /** *
diff --git a/src/org/redkale/source/FilterNode.java b/src/org/redkale/source/FilterNode.java
index ba9db47e9..3c9d15a0a 100644
--- a/src/org/redkale/source/FilterNode.java
+++ b/src/org/redkale/source/FilterNode.java
@@ -13,9 +13,11 @@ import static org.redkale.source.FilterExpress.*;
import org.redkale.util.Attribute;
/**
- * 注意: 在调用 createSQLExpress 之前必须先调用 createSQLJoin 在调用 createPredicate 之前必须先调用 isCacheUseable
- *
- *
+ * 注意:
* 详情见: http://redkale.org
+ * 在调用 createSQLExpress 之前必须先调用 createSQLJoin
+ * 在调用 createPredicate 之前必须先调用 isCacheUseable
+ *
+ *
* 详情见: http://redkale.org
*
* @author zhangjx
@@ -143,10 +145,11 @@ public class FilterNode {
/**
* 该方法需要重载
*
- * @param
+ * 例如: col / 10 = 3 、MOD(col, 8) > 0 这些都不是单独一个数值能表达的,因此需要FilterValue 才构建 8 、 > 、0 组合值.
*
*