Browse Source

修正并补充注释

donganbang 1 năm trước cách đây
mục cha
commit
2c2740b019

+ 10 - 4
mybatis-plus-core/src/main/java/com/baomidou/mybatisplus/core/conditions/interfaces/Func.java

@@ -76,8 +76,8 @@ public interface Func<Children, R> extends Serializable {
      * 字段 IN (value.get(0), value.get(1), ...)
      * <p>例: in("id", Arrays.asList(1, 2, 3, 4, 5))</p>
      *
-     * <li> 注意!集合为空若存在逻辑错误,请在 condition 条件中判断 </li>
-     * <li> 如果集合为 empty 则不会进行 sql 拼接 </li>
+     * <li> 注意!当集合为 空或null 时, sql会拼接为:WHERE (字段名 IN ()), 执行时报错</li>
+     * <li> 若要在特定条件下不拼接, 可在 condition 条件中判断 </li>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -97,8 +97,8 @@ public interface Func<Children, R> extends Serializable {
      * 字段 IN (v0, v1, ...)
      * <p>例: in("id", 1, 2, 3, 4, 5)</p>
      *
-     * <li> 注意!数组为空若存在逻辑错误,请在 condition 条件中判断 </li>
-     * <li> 如果动态数组为 empty 则不会进行 sql 拼接 </li>
+     * <li> 注意!当数组为 空或null 时, sql会拼接为:WHERE (字段名 IN ()), 执行时报错</li>
+     * <li> 若要在特定条件下不拼接, 可在 condition 条件中判断 </li>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -118,6 +118,9 @@ public interface Func<Children, R> extends Serializable {
      * 字段 NOT IN (value.get(0), value.get(1), ...)
      * <p>例: notIn("id", Arrays.asList(1, 2, 3, 4, 5))</p>
      *
+     * <li> 注意!当集合为 空或null 时, sql会拼接为:WHERE (字段名 NOT IN ()), 执行时报错</li>
+     * <li> 若要在特定条件下不拼接, 可在 condition 条件中判断 </li>
+     *
      * @param condition 执行条件
      * @param column    字段
      * @param coll      数据集合
@@ -136,6 +139,9 @@ public interface Func<Children, R> extends Serializable {
      * 字段 NOT IN (v0, v1, ...)
      * <p>例: notIn("id", 1, 2, 3, 4, 5)</p>
      *
+     * <li> 注意!当数组为 空或null 时, sql会拼接为:WHERE (字段名 NOT IN ()), 执行时报错</li>
+     * <li> 若要在特定条件下不拼接, 可在 condition 条件中判断 </li>
+     *
      * @param condition 执行条件
      * @param column    字段
      * @param values    数据数组