文档注释调整 github issues/741 新增 Lambda 类构造函数使用注释

mybatis-plus-core/src/main/java/com/baomidou/mybatisplus/core/conditions/Wrapper.java

@@ -15,6 +15,8 @@
  */
 package com.baomidou.mybatisplus.core.conditions;
 
+import java.util.Objects;
+
 import com.baomidou.mybatisplus.core.conditions.segments.MergeSegments;
 import com.baomidou.mybatisplus.core.metadata.TableFieldInfo;
 import com.baomidou.mybatisplus.core.metadata.TableInfo;
@@ -23,8 +25,6 @@ import com.baomidou.mybatisplus.core.toolkit.ReflectionKit;
 import com.baomidou.mybatisplus.core.toolkit.StringUtils;
 import com.baomidou.mybatisplus.core.toolkit.TableInfoHelper;
 
-import java.util.Objects;
-
 /**
  * <p>
  * 条件构造抽象类
@@ -59,13 +59,13 @@ public abstract class Wrapper<T> implements ISqlSegment {
     public abstract MergeSegments getExpression();
 
     /**
-     * 获取自定义SQL 简化自定义XML复杂情况
-     * 使用方法
-     * `自定义sql` + ${ew.customSqlSegment}
+     * 获取自定义SQL 简化自定义XML复杂情况<br/>
+     * 使用方法<br/>
+     * `自定义sql` + ${ew.customSqlSegment}<br/>
      * <p>1.逻辑删除需要自己拼接条件 (之前自定义也同样)</p>
      * <p>2.不支持wrapper中附带实体的情况 (wrapper自带实体会更麻烦)</p>
-     * <p>3.用法 ${ew.customSqlSegment} (不需要where标签包裹,切记!)</>
-     * <p>4.ew是wrapper定义别名,可自行替换</>
+     * <p>3.用法 ${ew.customSqlSegment} (不需要where标签包裹,切记!)</p>
+     * <p>4.ew是wrapper定义别名,可自行替换</p>
      */
     public abstract String getCustomSqlSegment();
 

mybatis-plus-core/src/main/java/com/baomidou/mybatisplus/core/conditions/interfaces/Compare.java

@@ -45,7 +45,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * map 所有非空属性等于 =
+     * </p>
      *
      * @param condition   执行条件
      * @param params      map 类型的参数, key 是字段名, value 是字段值
@@ -69,7 +71,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
-     * 字段过滤接口，传入多参数时允许对参数进行过滤
+     * <p>
+     * 字段过滤接口，传入多参数时允许对参数进行过滤<br/>
+     * </p>
      *
      * @param condition   执行条件
      * @param filter      返回 true 来允许字段传入比对条件中
@@ -87,7 +91,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * 等于 =
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -104,7 +110,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * 不等于 <>
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -121,7 +129,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * 大于 >
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -138,7 +148,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * 大于等于 >=
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -155,7 +167,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * 小于 <
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -172,7 +186,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * 小于等于 <=
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -189,7 +205,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * BETWEEN 值1 AND 值2
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -207,7 +225,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * NOT BETWEEN 值1 AND 值2
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -225,7 +245,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * LIKE '%值%'
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -242,7 +264,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * NOT LIKE '%值%'
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -259,7 +283,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * LIKE '%值'
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段
@@ -276,7 +302,9 @@ public interface Compare<Children, R> extends Serializable {
     }
 
     /**
+     * <p>
      * LIKE '值%'
+     * </p>
      *
      * @param condition 执行条件
      * @param column    字段

mybatis-plus-core/src/main/java/com/baomidou/mybatisplus/core/conditions/interfaces/Nested.java

@@ -37,8 +37,10 @@ public interface Nested<Param, Children> extends Serializable {
     }
 
     /**
-     * AND 嵌套
-     * 例: and(i -> i.eq("name", "李白").ne("status", "活着"))
+     * <p>
+     * AND 嵌套<br/>
+     * 例: and(i -> i.eq("name", "李白").ne("status", "活着"))<br/>
+     * </p>
      *
      * @param condition 执行条件
      * @param func      函数
@@ -54,8 +56,10 @@ public interface Nested<Param, Children> extends Serializable {
     }
 
     /**
-     * OR 嵌套
-     * 例: or(i -> i.eq("name", "李白").ne("status", "活着"))
+     * <p>
+     * OR 嵌套<br/>
+     * 例: or(i -> i.eq("name", "李白").ne("status", "活着"))<br/>
+     * </p>
      *
      * @param condition 执行条件
      * @param func      函数
@@ -71,8 +75,10 @@ public interface Nested<Param, Children> extends Serializable {
     }
 
     /**
-     * 正常嵌套 不带 AND 或者 OR
+     * <p>
+     * 正常嵌套 不带 AND 或者 OR<br/>
      * 例: nested(i -> i.eq("name", "李白").ne("status", "活着"))
+     * </p>
      *
      * @param condition 执行条件
      * @param func      函数

mybatis-plus-core/src/main/java/com/baomidou/mybatisplus/core/conditions/query/LambdaQueryWrapper.java

@@ -15,6 +15,10 @@
  */
 package com.baomidou.mybatisplus.core.conditions.query;
 
+import java.util.Map;
+import java.util.concurrent.atomic.AtomicInteger;
+import java.util.function.Predicate;
+
 import com.baomidou.mybatisplus.core.conditions.AbstractLambdaWrapper;
 import com.baomidou.mybatisplus.core.conditions.SharedString;
 import com.baomidou.mybatisplus.core.conditions.segments.MergeSegments;
@@ -23,10 +27,6 @@ import com.baomidou.mybatisplus.core.toolkit.ArrayUtils;
 import com.baomidou.mybatisplus.core.toolkit.TableInfoHelper;
 import com.baomidou.mybatisplus.core.toolkit.support.SFunction;
 
-import java.util.Map;
-import java.util.concurrent.atomic.AtomicInteger;
-import java.util.function.Predicate;
-
 /**
  * <p>
  * Lambda 语法使用 Wrapper
@@ -40,19 +40,36 @@ public class LambdaQueryWrapper<T> extends AbstractLambdaWrapper<T, LambdaQueryW
     implements Query<LambdaQueryWrapper<T>, T, SFunction<T, ?>> {
 
     /**
+     * <p>
      * 查询字段
+     * </p>
      */
     private SharedString sqlSelect = new SharedString();
 
+    /**
+     * <p>
+     * 不建议直接 new 该实例，使用 Wrappers.lambdaQuery(entity)
+     * </p>
+     */
     public LambdaQueryWrapper() {
         this(null);
     }
 
+    /**
+     * <p>
+     * 不建议直接 new 该实例，使用 Wrappers.lambdaQuery(entity)
+     * </p>
+     */
     public LambdaQueryWrapper(T entity) {
         super.setEntity(entity);
         super.initNeed();
     }
 
+    /**
+     * <p>
+     * 不建议直接 new 该实例，使用 Wrappers.lambdaQuery(...)
+     * </p>
+     */
     LambdaQueryWrapper(T entity, Class<T> entityClass, SharedString sqlSelect, AtomicInteger paramNameSeq,
                        Map<String, Object> paramNameValuePairs, MergeSegments mergeSegments) {
         super.setEntity(entity);
@@ -89,11 +106,11 @@ public class LambdaQueryWrapper<T> extends AbstractLambdaWrapper<T, LambdaQueryW
      * 过滤查询的字段信息(主键除外!)
      * </p>
      * <p>
-     * 例1: 只要 java 字段名以 "test" 开头的              -> select(i -> i.getProperty().startsWith("test"))
-     * 例2: 只要 java 字段属性是 CharSequence 类型的       -> select(TableFieldInfo::isCharSequence)
-     * 例3: 只要 java 字段没有填充策略的                   -> select(i -> i.getFieldFill() == FieldFill.DEFAULT)
-     * 例4: 要全部字段                                   -> select(i -> true)
-     * 例5: 只要主键字段                                 -> select(i -> false)
+     * 例1: 只要 java 字段名以 "test" 开头的              -> select(i -> i.getProperty().startsWith("test")) <br/>
+     * 例2: 只要 java 字段属性是 CharSequence 类型的       -> select(TableFieldInfo::isCharSequence) <br/>
+     * 例3: 只要 java 字段没有填充策略的                   -> select(i -> i.getFieldFill() == FieldFill.DEFAULT) <br/>
+     * 例4: 要全部字段                                   -> select(i -> true) <br/>
+     * 例5: 只要主键字段                                 -> select(i -> false) <br/>
      * </p>
      *
      * @param predicate 过滤方式
@@ -113,7 +130,7 @@ public class LambdaQueryWrapper<T> extends AbstractLambdaWrapper<T, LambdaQueryW
 
     /**
      * <p>
-     * 用于生成嵌套 sql
+     * 用于生成嵌套 sql <br/>
      * 故 sqlSelect 不向下传递
      * </p>
      */

mybatis-plus-core/src/main/java/com/baomidou/mybatisplus/core/conditions/query/Query.java

@@ -15,11 +15,11 @@
  */
 package com.baomidou.mybatisplus.core.conditions.query;
 
-import com.baomidou.mybatisplus.core.metadata.TableFieldInfo;
-
 import java.io.Serializable;
 import java.util.function.Predicate;
 
+import com.baomidou.mybatisplus.core.metadata.TableFieldInfo;
+
 /**
  * @author miemie
  * @since 2018-12-12
@@ -27,7 +27,9 @@ import java.util.function.Predicate;
 public interface Query<Children, T, R> extends Serializable {
 
     /**
+     * <p>
      * 设置查询字段
+     * </p>
      *
      * @param columns 字段数组
      * @return children
@@ -35,8 +37,12 @@ public interface Query<Children, T, R> extends Serializable {
     Children select(R... columns);
 
     /**
+     * <p>
      * ignore
-     * <li> 注意只有内部有 entity 才能使用该方法 </li>
+     * </p>
+     * <p>
+     * 注意只有内部有 entity 才能使用该方法
+     * </p>
      */
     Children select(Predicate<TableFieldInfo> predicate);
 
@@ -45,11 +51,11 @@ public interface Query<Children, T, R> extends Serializable {
      * 过滤查询的字段信息(主键除外!)
      * </p>
      * <p>
-     * 例1: 只要 java 字段名以 "test" 开头的              -> select(i -> i.getProperty().startsWith("test"))
-     * 例2: 只要 java 字段属性是 CharSequence 类型的       -> select(TableFieldInfo::isCharSequence)
-     * 例3: 只要 java 字段没有填充策略的                   -> select(i -> i.getFieldFill() == FieldFill.DEFAULT)
-     * 例4: 要全部字段                                   -> select(i -> true)
-     * 例5: 只要主键字段                                 -> select(i -> false)
+     * 例1: 只要 java 字段名以 "test" 开头的              -> select(i -> i.getProperty().startsWith("test")) <br/>
+     * 例2: 只要 java 字段属性是 CharSequence 类型的       -> select(TableFieldInfo::isCharSequence) <br/>
+     * 例3: 只要 java 字段没有填充策略的                   -> select(i -> i.getFieldFill() == FieldFill.DEFAULT) <br/>
+     * 例4: 要全部字段                                   -> select(i -> true) <br/>
+     * 例5: 只要主键字段                                 -> select(i -> false) <br/>
      * </p>
      *
      * @param predicate 过滤方式
@@ -58,7 +64,9 @@ public interface Query<Children, T, R> extends Serializable {
     Children select(Class<T> entityClass, Predicate<TableFieldInfo> predicate);
 
     /**
+     * <p>
      * 查询条件 SQL 片段
+     * </p>
      */
     String getSqlSelect();
 }

mybatis-plus-core/src/main/java/com/baomidou/mybatisplus/core/conditions/query/QueryWrapper.java

@@ -15,6 +15,10 @@
  */
 package com.baomidou.mybatisplus.core.conditions.query;
 
+import java.util.Map;
+import java.util.concurrent.atomic.AtomicInteger;
+import java.util.function.Predicate;
+
 import com.baomidou.mybatisplus.core.conditions.AbstractWrapper;
 import com.baomidou.mybatisplus.core.conditions.SharedString;
 import com.baomidou.mybatisplus.core.conditions.segments.MergeSegments;
@@ -23,10 +27,6 @@ import com.baomidou.mybatisplus.core.toolkit.ArrayUtils;
 import com.baomidou.mybatisplus.core.toolkit.StringPool;
 import com.baomidou.mybatisplus.core.toolkit.TableInfoHelper;
 
-import java.util.Map;
-import java.util.concurrent.atomic.AtomicInteger;
-import java.util.function.Predicate;
-
 /**
  * <p>
  * Entity 对象封装操作类
@@ -60,7 +60,9 @@ public class QueryWrapper<T> extends AbstractWrapper<T, String, QueryWrapper<T>>
     }
 
     /**
+     * <p>
      * 非对外公开的构造方法,只用于生产嵌套 sql
+     * </p>
      *
      * @param entityClass 本不应该需要的
      */
@@ -109,7 +111,7 @@ public class QueryWrapper<T> extends AbstractWrapper<T, String, QueryWrapper<T>>
 
     /**
      * <p>
-     * 用于生成嵌套 sql
+     * 用于生成嵌套 sql <br/>
      * 故 sqlSelect 不向下传递
      * </p>
      */

mybatis-plus-core/src/main/java/com/baomidou/mybatisplus/core/conditions/segments/NormalSegmentList.java

@@ -15,13 +15,13 @@
  */
 package com.baomidou.mybatisplus.core.conditions.segments;
 
+import java.util.List;
+import java.util.stream.Collectors;
+
 import com.baomidou.mybatisplus.core.conditions.ISqlSegment;
 import com.baomidou.mybatisplus.core.enums.SqlKeyword;
 import com.baomidou.mybatisplus.core.toolkit.StringPool;
 
-import java.util.List;
-import java.util.stream.Collectors;
-
 /**
  * <p>
  * 普通片段
@@ -34,7 +34,9 @@ import java.util.stream.Collectors;
 public class NormalSegmentList extends AbstractISegmentList {
 
     /**
+     * <p>
      * 是否处理了的上个 not
+     * </p>
      */
     private boolean executeNot = true;
 

mybatis-plus-core/src/main/java/com/baomidou/mybatisplus/core/conditions/update/LambdaUpdateWrapper.java

@@ -15,6 +15,11 @@
  */
 package com.baomidou.mybatisplus.core.conditions.update;
 
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.atomic.AtomicInteger;
+
 import com.baomidou.mybatisplus.core.conditions.AbstractLambdaWrapper;
 import com.baomidou.mybatisplus.core.conditions.segments.MergeSegments;
 import com.baomidou.mybatisplus.core.toolkit.CollectionUtils;
@@ -22,11 +27,6 @@ import com.baomidou.mybatisplus.core.toolkit.StringPool;
 import com.baomidou.mybatisplus.core.toolkit.StringUtils;
 import com.baomidou.mybatisplus.core.toolkit.support.SFunction;
 
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Map;
-import java.util.concurrent.atomic.AtomicInteger;
-
 /**
  * <p>
  * Lambda 更新封装
@@ -44,17 +44,32 @@ public class LambdaUpdateWrapper<T> extends AbstractLambdaWrapper<T, LambdaUpdat
      */
     private final List<String> sqlSet;
 
+    /**
+     * <p>
+     * 不建议直接 new 该实例，使用 Wrappers.lambdaUpdate()
+     * </p>
+     */
     public LambdaUpdateWrapper() {
         // 如果无参构造函数，请注意实体 NULL 情况 SET 必须有否则 SQL 异常
         this(null);
     }
 
+    /**
+     * <p>
+     * 不建议直接 new 该实例，使用 Wrappers.lambdaUpdate(entity)
+     * </p>
+     */
     public LambdaUpdateWrapper(T entity) {
         super.setEntity(entity);
         super.initNeed();
         this.sqlSet = new ArrayList<>();
     }
 
+    /**
+     * <p>
+     * 不建议直接 new 该实例，使用 Wrappers.lambdaUpdate(...)
+     * </p>
+     */
     LambdaUpdateWrapper(T entity, List<String> sqlSet, AtomicInteger paramNameSeq,
                         Map<String, Object> paramNameValuePairs, MergeSegments mergeSegments) {
         super.setEntity(entity);

mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/service/IService.java

@@ -15,6 +15,14 @@
  */
 package com.baomidou.mybatisplus.extension.service;
 
+import java.io.Serializable;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+
+import org.springframework.transaction.annotation.Transactional;
+
 import com.baomidou.mybatisplus.core.conditions.Wrapper;
 import com.baomidou.mybatisplus.core.mapper.BaseMapper;
 import com.baomidou.mybatisplus.core.metadata.IPage;
@@ -24,13 +32,6 @@ import com.baomidou.mybatisplus.extension.service.additional.query.impl.QueryCha
 import com.baomidou.mybatisplus.extension.service.additional.update.impl.LambdaUpdateChainWrapper;
 import com.baomidou.mybatisplus.extension.service.additional.update.impl.UpdateChainWrapper;
 import com.baomidou.mybatisplus.extension.toolkit.SqlHelper;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.io.Serializable;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-import java.util.function.Function;
 
 /**
  * <p>
@@ -407,14 +408,18 @@ public interface IService<T> {
     }
 
     /**
+     * <p>
      * 获取对应 entity 的 BaseMapper
+     * </p>
      *
      * @return BaseMapper
      */
     BaseMapper<T> getBaseMapper();
 
     /**
+     * <p>
      * 链式查询 普通
+     * </p>
      *
      * @return QueryWrapper 的包装类
      */
@@ -423,7 +428,9 @@ public interface IService<T> {
     }
 
     /**
+     * <p>
      * 链式查询 lambda 式
+     * </p>
      *
      * @return LambdaQueryWrapper 的包装类
      */
@@ -432,7 +439,9 @@ public interface IService<T> {
     }
 
     /**
+     * <p>
      * 链式更改 普通
+     * </p>
      *
      * @return UpdateWrapper 的包装类
      */
@@ -441,7 +450,9 @@ public interface IService<T> {
     }
 
     /**
+     * <p>
      * 链式更改 lambda 式
+     * </p>
      *
      * @return LambdaUpdateWrapper 的包装类
      */

mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/service/additional/AbstractChainWrapper.java

@@ -43,12 +43,16 @@ public abstract class AbstractChainWrapper<T, R, Children extends AbstractChainW
 
     protected final Children typedThis = (Children) this;
     /**
+     * <p>
      * 子类所包装的具体 Wrapper 类型
+     * </p>
      */
     protected Param wrapperChildren;
 
     /**
+     * <p>
      * 必须的构造函数
+     * </p>
      */
     public AbstractChainWrapper() {
     }

mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/service/additional/ChainWrapper.java

@@ -28,14 +28,18 @@ import com.baomidou.mybatisplus.core.mapper.BaseMapper;
 public interface ChainWrapper<T> {
 
     /**
+     * <p>
      * 获取 BaseMapper
+     * </p>
      *
      * @return BaseMapper
      */
     BaseMapper<T> getBaseMapper();
 
     /**
+     * <p>
      * 获取最终拿去执行的 Wrapper
+     * </p>
      *
      * @return Wrapper
      */

mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/service/additional/query/ChainQuery.java

@@ -15,12 +15,12 @@
  */
 package com.baomidou.mybatisplus.extension.service.additional.query;
 
+import java.util.List;
+
 import com.baomidou.mybatisplus.core.metadata.IPage;
 import com.baomidou.mybatisplus.extension.service.IService;
 import com.baomidou.mybatisplus.extension.service.additional.ChainWrapper;
 
-import java.util.List;
-
 /**
  * 具有查询方法的定义
  *
@@ -30,7 +30,9 @@ import java.util.List;
 public interface ChainQuery<T> extends ChainWrapper<T> {
 
     /**
+     * <p>
      * 获取集合
+     * </p>
      *
      * @return 集合
      */
@@ -39,7 +41,9 @@ public interface ChainQuery<T> extends ChainWrapper<T> {
     }
 
     /**
+     * <p>
      * 获取单个
+     * </p>
      *
      * @return 单个
      */
@@ -48,7 +52,9 @@ public interface ChainQuery<T> extends ChainWrapper<T> {
     }
 
     /**
+     * <p>
      * 获取 count
+     * </p>
      *
      * @return count
      */
@@ -57,7 +63,9 @@ public interface ChainQuery<T> extends ChainWrapper<T> {
     }
 
     /**
+     * <p>
      * 获取分页数据
+     * </p>
      *
      * @param page 分页条件
      * @return 分页数据

mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/service/additional/query/impl/QueryChainWrapper.java

@@ -26,6 +26,10 @@ import com.baomidou.mybatisplus.extension.service.additional.AbstractChainWrappe
 import com.baomidou.mybatisplus.extension.service.additional.query.ChainQuery;
 
 /**
+ * <p>
+ * Query Chain Wrapper
+ * </p>
+ *
  * @author miemie
  * @since 2018-12-19
  */

mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/service/additional/update/ChainUpdate.java

@@ -18,7 +18,9 @@ package com.baomidou.mybatisplus.extension.service.additional.update;
 import com.baomidou.mybatisplus.extension.service.additional.ChainWrapper;
 
 /**
+ * <p>
  * 具有更新方法的定义
+ * </p>
  *
  * @author miemie
  * @since 2018-12-19
@@ -26,7 +28,9 @@ import com.baomidou.mybatisplus.extension.service.additional.ChainWrapper;
 public interface ChainUpdate<T> extends ChainWrapper<T> {
 
     /**
+     * <p>
      * 更新数据
+     * </p>
      *
      * @return 是否成功
      */
@@ -35,7 +39,9 @@ public interface ChainUpdate<T> extends ChainWrapper<T> {
     }
 
     /**
+     * <p>
      * 更新数据
+     * </p>
      *
      * @param entity 实体类
      * @return 是否成功
@@ -45,7 +51,9 @@ public interface ChainUpdate<T> extends ChainWrapper<T> {
     }
 
     /**
+     * <p>
      * 删除数据
+     * </p>
      *
      * @return 是否成功
      */

mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/service/additional/update/impl/LambdaUpdateChainWrapper.java

@@ -24,6 +24,10 @@ import com.baomidou.mybatisplus.extension.service.additional.AbstractChainWrappe
 import com.baomidou.mybatisplus.extension.service.additional.update.ChainUpdate;
 
 /**
+ * <p>
+ * Lambda Update Chain Wrapper
+ * </p>
+ *
  * @author miemie
  * @since 2018-12-19
  */

mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/service/additional/update/impl/UpdateChainWrapper.java

@@ -23,6 +23,10 @@ import com.baomidou.mybatisplus.extension.service.additional.AbstractChainWrappe
 import com.baomidou.mybatisplus.extension.service.additional.update.ChainUpdate;
 
 /**
+ * <p>
+ * Update Chain Wrapper
+ * </p>
+ *
  * @author miemie
  * @since 2018-12-19
  */

mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/service/impl/ServiceImpl.java

@@ -15,20 +15,6 @@
  */
 package com.baomidou.mybatisplus.extension.service.impl;
 
-import com.baomidou.mybatisplus.core.conditions.Wrapper;
-import com.baomidou.mybatisplus.core.enums.SqlMethod;
-import com.baomidou.mybatisplus.core.mapper.BaseMapper;
-import com.baomidou.mybatisplus.core.metadata.IPage;
-import com.baomidou.mybatisplus.core.metadata.TableInfo;
-import com.baomidou.mybatisplus.core.toolkit.*;
-import com.baomidou.mybatisplus.extension.service.IService;
-import com.baomidou.mybatisplus.extension.toolkit.SqlHelper;
-import org.apache.ibatis.binding.MapperMethod;
-import org.apache.ibatis.session.SqlSession;
-import org.mybatis.spring.SqlSessionUtils;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.transaction.annotation.Transactional;
-
 import java.io.Serializable;
 import java.util.Collection;
 import java.util.List;
@@ -37,6 +23,26 @@ import java.util.Objects;
 import java.util.function.Function;
 import java.util.stream.Collectors;
 
+import org.apache.ibatis.binding.MapperMethod;
+import org.apache.ibatis.session.SqlSession;
+import org.mybatis.spring.SqlSessionUtils;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.baomidou.mybatisplus.core.conditions.Wrapper;
+import com.baomidou.mybatisplus.core.enums.SqlMethod;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.core.metadata.TableInfo;
+import com.baomidou.mybatisplus.core.toolkit.Assert;
+import com.baomidou.mybatisplus.core.toolkit.Constants;
+import com.baomidou.mybatisplus.core.toolkit.GlobalConfigUtils;
+import com.baomidou.mybatisplus.core.toolkit.ReflectionKit;
+import com.baomidou.mybatisplus.core.toolkit.StringUtils;
+import com.baomidou.mybatisplus.core.toolkit.TableInfoHelper;
+import com.baomidou.mybatisplus.extension.service.IService;
+import com.baomidou.mybatisplus.extension.toolkit.SqlHelper;
+
 /**
  * <p>
  * IService 实现类（ 泛型：M 是 mapper 对象，T 是实体 ， PK 是主键泛型 ）
@@ -82,7 +88,9 @@ public class ServiceImpl<M extends BaseMapper<T>, T> implements IService<T> {
     }
 
     /**
+     * <p>
      * 释放sqlSession
+     * </p>
      *
      * @param sqlSession session
      */
@@ -91,7 +99,9 @@ public class ServiceImpl<M extends BaseMapper<T>, T> implements IService<T> {
     }
 
     /**
-     * 获取SqlStatement
+     * <p>
+     * 获取 SqlStatement
+     * </p>
      *
      * @param sqlMethod
      * @return
@@ -106,7 +116,9 @@ public class ServiceImpl<M extends BaseMapper<T>, T> implements IService<T> {
     }
 
     /**
+     * <p>
      * 批量插入
+     * </p>
      *
      * @param entityList
      * @param batchSize