diff --git a/docs/zh/base/service.md b/docs/zh/base/service.md index 2abe59c7..91bb75f0 100644 --- a/docs/zh/base/service.md +++ b/docs/zh/base/service.md @@ -20,15 +20,15 @@ public interface IAccountService extends IService { ```java @Component -public class AccountServiceImpl extends ServiceImpl +public class AccountServiceImpl extends ServiceImpl implements IAccountService { - + @Override public List customMethod() { // 返回 id >= 100 的数据 return list(ACCOUNT.ID.ge(100)); } - + } ``` @@ -63,8 +63,8 @@ public class AccountServiceImpl extends ServiceImpl - **update(entity, map)**:根据 `Map<字段名,值>` 组成的条件更新数据,实体类可以没有主键(如果有也会被忽略),实体类的 null 属性,会自动被忽略。 - **update(entity, query)**:根据 `QueryWrapper` 构建的条件更新数据,实体类可以没有主键(如果有也会被忽略),实体类的 null 属性,会自动被忽略。 - **update(entity, condition)**:根据 `QueryCondition` 构建的条件更新数据,实体类可以没有主键(如果有也会被忽略),实体类的 null 属性,会自动被忽略。 -- **updateBatch(entities, ignoreNulls)**:批量保存多条数据,要求主键值不能为空,否则会抛出异常;可以选择数据为 null 的字段是否更新到数据库。 -- **updateBatch(entities, size, ignoreNulls)**:批量保存多条数据,按指定数量切分,要求主键值不能为空,否则会抛出异常;可以选择数据为 null 的字段是否更新到数据库。 +- **updateBatch(entities)**:批量保存多条数据,要求主键值不能为空,否则会抛出异常;同时,数据为 null 的字段不会更新到数据库。 +- **updateBatch(entities, size)**:批量保存多条数据,按指定数量切分,要求主键值不能为空,否则会抛出异常;同时,数据为 null 的字段不会更新到数据库。。 ## 查询数据 @@ -117,4 +117,4 @@ public class AccountServiceImpl extends ServiceImpl ## 其他方法 - **getMapper()**:获取对应的 `BaseMapper` 接口。 -- **query()**:获取默认的 `QueryWrapper` 类。 +- **query()**:获取默认的 `QueryWrapper` 类。 \ No newline at end of file diff --git a/mybatis-flex-core/src/main/java/com/mybatisflex/core/service/IService.java b/mybatis-flex-core/src/main/java/com/mybatisflex/core/service/IService.java index 613745e1..2e952d0a 100644 --- a/mybatis-flex-core/src/main/java/com/mybatisflex/core/service/IService.java +++ b/mybatis-flex-core/src/main/java/com/mybatisflex/core/service/IService.java @@ -262,14 +262,11 @@ public interface IService { *

根据数据主键批量更新数据 * * @param entities 实体类对象集合 - * @param ignoreNulls 是否忽略空字段 - * {@code true} 表示忽略实体类中为 {@code null} 的字段,不更新这些字段。 - * {@code false} 表示不忽略空字段,允许将对应字段更新为 {@code null}。 * @return boolean {@code true} 更新成功,{@code false} 更新失败。 - * @apiNote 若 {@code ignoreNulls} 为 {@code true},实体类中为 {@code null} 的属性不会更新到数据库。 + * @apiNote 若实体类属性数据为 {@code null},该属性不会新到数据库。 */ - default boolean updateBatch(Collection entities, Boolean ignoreNulls) { - return updateBatch(entities, DEFAULT_BATCH_SIZE, ignoreNulls); + default boolean updateBatch(Collection entities) { + return updateBatch(entities, DEFAULT_BATCH_SIZE); } /** @@ -277,15 +274,12 @@ public interface IService { * * @param entities 实体类对象集合 * @param batchSize 每批次更新数量 - * @param ignoreNulls 是否忽略空字段 - * {@code true} 表示忽略实体类中为 {@code null} 的字段,不更新这些字段。 - * {@code false} 表示不忽略空字段,允许将对应字段更新为 {@code null}。 * @return {@code true} 更新成功,{@code false} 更新失败。 - * @apiNote 若 {@code ignoreNulls} 为 {@code true},实体类中为 {@code null} 的属性不会更新到数据库。 + * @apiNote 若实体类属性数据为 {@code null},该属性不会新到数据库。 */ - default boolean updateBatch(Collection entities, int batchSize, boolean ignoreNulls) { + default boolean updateBatch(Collection entities, int batchSize) { Class> usefulClass = (Class>) ClassUtil.getUsefulClass(getMapper().getClass()); - return SqlUtil.toBool(Db.executeBatch(entities, batchSize, usefulClass, (mapper, entity) -> mapper.update(entity, ignoreNulls))); + return SqlUtil.toBool(Db.executeBatch(entities, batchSize, usefulClass, BaseMapper::update)); } // ===== 查询(查)操作 =====