CRUD接口

Service CRUD 接口

说明:

• 通用 Service CRUD 封装IService接口，进一步封装 CRUD 采用 get 查询单行 remove 删除 list 查询集合 page 分页
• 泛型 T 为任意实体对象
• 建议如果存在自定义通用 Service 方法的可能，请创建自己的 IBaseService 继承 Mongo-Plus 提供的基类

注意事项：

• 在插入或修改二进制文件时，推荐使用org.bson.types.Binary，Mongo驱动原生类，支持非常好，MongoPlus提供了一个工具类：com.anwen.mongo.toolkit.BinaryConvertHandler，提供了一些较为常用的操作，如将File转为Binary等等

Sql

// 查询sql，传入值为json，如果不是json则无法解析
List<T> sql(String sql)

• 示例

List<User> userList service.sql("{'user_name':{'$eq':'张三'}}");
userList.forEach(System.out::println);

Save

// 插入一条记录（选择字段，策略插入）
boolean save(T entity);
// 插入（批量）
boolean saveBatch(Collection<T> entityList);

参数说明

类型	参数名	描述
T	entity	实体对象
Collection<T>	entityList	实体对象集合

SaveOrUpdate

// TableId 注解存在更新记录，否插入一条记录
boolean saveOrUpdate(T entity);
// 批量修改插入
boolean saveOrUpdateBatch(Collection<T> entityList);

参数说明

类型	参数名	描述
T	entity	实体对象
Collection<T>	entityList	实体对象集合

Remove

// 根据 queryWrapper 设置的条件，删除记录
boolean remove(UpdateChainWrapper<T, ?> updateChainWrapper);
// 根据 ID 删除
boolean removeById(Serializable id);
// 根据 columnMap 条件，删除记录
boolean removeByColumn(String column,Object value);
// 删除（根据ID 批量删除）
boolean removeByIds(Collection<? extends Serializable> idList);

参数说明

类型	参数名	描述
UpdateChainWrapper<T>	updateChainWrapper	实体封装操作类 UpdateWrapper
Serializable	id	主键 ID
column<String, Object>	column	表字段
Collection<? extends Serializable>	idList	主键 ID 列表

Update

// 根据 UpdateWrapper 条件，更新记录 需要设置sqlset
boolean update(UpdateChainWrapper<T, ?> updateChainWrapper);
// 根据 ID 选择修改
boolean updateById(T entity);
// 根据ID 批量更新
boolean updateBatchById(Collection<T> entityList);
// 根据ID 批量更新
boolean updateBatchById(Collection<T> entityList);

参数说明

类型	参数名	描述
UpdateChainWrapper<T>	updateChainWrapper	实体对象封装操作类 UpdateWrapper
T	entity	实体对象
Collection<T>	entityList	实体对象集合

Get

// 根据 ID 查询
T getById(Serializable id);
// 根据ID集合查询
List<T> getById(Collection<Serializable> ids)
// 根据 QueryChainWrapper，查询一条记录。结果集，如果是多个会抛出异常
T one(QueryChainWrapper<T,?> queryChainWrapper);
// 根据 QueryChainWrapper，查询一条记录。结果集，如果是多个会取第一条返回
T limitOne(QueryChainWrapper<T,?> queryChainWrapper);

参数说明

类型	参数名	描述
Serializable	id	主键 ID
QueryChainWrapper<T>	QueryChainWrapper	实体对象封装操作类 QueryChainWrapper

List

// 查询所有
List<T> list();
// 查询列表，根据条件
List<T> list(QueryChainWrapper<T,?> queryChainWrapper);

参数说明

类型	参数名	描述
Wrapper<T>	queryWrapper	实体对象封装操作类 QueryChainWrapper

Page

// 无条件分页查询
IPage<T> page(PageParam pageParam);
// 条件分页查询
IPage<T> page(QueryChainWrapper<T,?> queryChainWrapper, PageParam pageParam);

参数说明

类型	参数名	描述
IPage<T>	page	翻页对象
QueryChainWrapper<T>	queryWrapper	实体对象封装操作类 QueryChainWrapper

Count

// 查询总记录数
int count();
// 根据 Wrapper 条件，查询总记录数
int count(QueryChainWrapper<T,?> queryChainWrapper);

参数说明

类型	参数名	描述
QueryChainWrapper<T>	queryWrapper	实体对象封装操作类 QueryChainWrapper

Chain

query

// 链式查询 lambda 式。注意：不支持 Kotlin
LambdaQueryChainWrapper<T> lambdaQuery();

// 示例：
lambdaQuery().eq(Entity::getId, value).list();

update

// 链式更改 lambda 式。注意：不支持 Kotlin
LambdaUpdateChainWrapper<T> lambdaUpdate();

// 示例：
lambdaUpdate().eq(Entity::getId, value).update(entity);