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等等
command
java
// 查询command,传入值为json,如果不是json则无法解析
List<T> queryCommand(String command)
- 示例
java
List<User> userList service.queryCommand("{'user_name':{'$eq':'张三'}}");
userList.forEach(System.out::println);
Save
java
// 插入一条记录(选择字段,策略插入)
boolean save(T entity);
// 插入(批量)
boolean saveBatch(Collection<T> entityList);
参数说明
类型 | 参数名 | 描述 |
---|---|---|
T | entity | 实体对象 |
Collection<T> | entityList | 实体对象集合 |
SaveOrUpdate
java
// ID注解存在更新记录,否插入一条记录
boolean saveOrUpdate(T entity);
//isQueryDatabase设置为true,是否根据ID注解查询数据库,判断是否存在
boolean saveOrUpdate(T entity,boolean isQueryDatabase);
// 批量修改插入
boolean saveOrUpdateBatch(Collection<T> entityList);
//isQueryDatabase设置为true,是否根据ID注解查询数据库,判断是否存在
boolean saveOrUpdateBatch(Collection<T> entityList,boolean isQueryDatabase);
参数说明
类型 | 参数名 | 描述 |
---|---|---|
T | entity | 实体对象 |
Collection<T> | entityList | 实体对象集合 |
Boolean | isQueryDatabase | 是否查询数据库 |
Remove
java
// 根据 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
java
// 根据 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
java
// 根据 ID 查询
T getById(Serializable id);
// 根据ID集合查询
List<T> getById(Collection<Serializable> ids)
// 根据 QueryChainWrapper,查询一条记录。
T one(QueryChainWrapper<T,?> queryChainWrapper);
参数说明
类型 | 参数名 | 描述 |
---|---|---|
Serializable | id | 主键 ID |
QueryChainWrapper<T> | QueryChainWrapper | 实体对象封装操作类 QueryChainWrapper |
List
java
// 查询所有
List<T> list();
// 查询列表,根据条件
List<T> list(QueryChainWrapper<T,?> queryChainWrapper);
参数说明
类型 | 参数名 | 描述 |
---|---|---|
QueryChainWrapper<T> | queryWrapper | 实体对象封装操作类 QueryChainWrapper |
Page
java
// 无条件分页查询
PageResult<T> page(PageParam pageParam);
// 条件分页查询
PageResult<T> page(QueryChainWrapper<T,?> queryChainWrapper, PageParam pageParam);
参数说明
类型 | 参数名 | 描述 |
---|---|---|
IPage<T> | page | 翻页对象 |
QueryChainWrapper<T> | queryWrapper | 实体对象封装操作类 QueryChainWrapper |
Count
java
// 查询总记录数
int count();
// 根据 Wrapper 条件,查询总记录数
int count(QueryChainWrapper<T,?> queryChainWrapper);
参数说明
类型 | 参数名 | 描述 |
---|---|---|
QueryChainWrapper<T> | queryWrapper | 实体对象封装操作类 QueryChainWrapper |
Chain
query
java
// 链式查询 lambda 式。注意:不支持 Kotlin
LambdaQueryChainWrapper<T> lambdaQuery();
// 示例:
lambdaQuery().eq(Entity::getId, value).list();
update
java
// 链式更改 lambda 式。注意:不支持 Kotlin
LambdaUpdateChainWrapper<T> lambdaUpdate();
// 示例:
lambdaUpdate().eq(Entity::getId, value).update(entity);