com.diboot.core.service.BaseService Maven / Gradle / Ivy
/*
* Copyright (c) 2015-2020, www.dibo.ltd ([email protected]).
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
package com.diboot.core.service;
import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.toolkit.support.SFunction;
import com.baomidou.mybatisplus.extension.conditions.query.LambdaQueryChainWrapper;
import com.baomidou.mybatisplus.extension.conditions.query.QueryChainWrapper;
import com.baomidou.mybatisplus.extension.conditions.update.LambdaUpdateChainWrapper;
import com.baomidou.mybatisplus.extension.conditions.update.UpdateChainWrapper;
import com.diboot.core.dto.SortParamDTO;
import com.diboot.core.util.ISetter;
import com.diboot.core.vo.LabelValue;
import com.diboot.core.vo.Pagination;
import org.springframework.lang.Nullable;
import java.io.Serializable;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.function.Consumer;
/**
* 基础服务Service
* @author [email protected]
* @version 2.0
* @date 2019/01/01
*/
public interface BaseService extends GeneralService{
/**
* 获取对应 entity 的 BaseMapper
*
* @return BaseMapper
*/
BaseMapper getMapper();
/**
* 构建mybatis-plus的query
* @return
*/
QueryChainWrapper query();
/**
* 构建mybatis-plus的lambdaQuery
* @return
*/
LambdaQueryChainWrapper lambdaQuery();
/**
* 构建mybatis-plus的update
* @return
*/
UpdateChainWrapper update();
/**
* 构建mybatis-plus的lambdaUpdate
* @return
*/
LambdaUpdateChainWrapper lambdaUpdate();
/**
* 获取Entity实体
* @param id 主键
* @return entity
*/
T getEntity(Serializable id);
/**
* 添加entity 及 其关联子项entities
* @param entity 主表entity
* @param relatedEntities 关联表entities
* @param relatedEntitySetter 关联Entity类的setter
* @return
*/
boolean createEntityAndRelatedEntities(T entity, List relatedEntities, ISetter relatedEntitySetter);
/**
* 添加entity的关联子项entities （1-n）
* @param entityId 主表entity id
* @param relatedEntities 关联表entities
* @param relatedEntitySetter 关联Entity类的setter
* @return
*/
boolean createRelatedEntities(Serializable entityId, List relatedEntities, ISetter relatedEntitySetter);
/**
* 添加entity的关联子项entity（1-1）
* @param entityId 主表entity id
* @param relatedEntity 关联表entity
* @param relatedEntitySetter 关联Entity类的setter
* @return
*/
boolean createRelatedEntity(Serializable entityId, RE relatedEntity, ISetter relatedEntitySetter);
/**
* 创建或更新n-n关联
* （在主对象的service中调用，不依赖中间表service实现中间表操作）
*
* @param driverIdGetter 驱动对象getter
* @param driverId 驱动对象ID
* @param followerIdGetter 从动对象getter
* @param followerIdList 从动对象id集合
* @return
*/
boolean createOrUpdateN2NRelations(SFunction driverIdGetter, Object driverId,
SFunction followerIdGetter, Collection followerIdList);
/**
* 创建或更新n-n关联
* （在主对象的service中调用，不依赖中间表service实现中间表操作）
*
* 可自定附加条件、参数
*
* @param driverIdGetter 驱动对象getter
* @param driverId 驱动对象ID
* @param followerIdGetter 从动对象getter
* @param followerIdList 从动对象id集合
* @param queryConsumer 附加查询条件
* @param setConsumer 附加插入参数
* @param 关联对象类型
* @return
*/
boolean createOrUpdateN2NRelations(SFunction driverIdGetter, Object driverId,
SFunction followerIdGetter, Collection followerIdList,
Consumer> queryConsumer, Consumer setConsumer);
/**
* 更新Entity实体（更新符合条件的所有非空字段）
* @param entity
* @param updateCriteria
* @return
*/
boolean updateEntity(T entity, Wrapper updateCriteria);
/**
* 更新Entity实体（仅更新updateWrapper.set指定的字段）
* @param updateWrapper
* @return
*/
boolean updateEntity(Wrapper updateWrapper);
/**
* 更新entity 及 其关联子项entities
* @param entity 主表entity
* @param relatedEntities 关联表entities
* @param relatedEntitySetter 关联Entity类的setter
* @return
*/
boolean updateEntityAndRelatedEntities(T entity, List relatedEntities, ISetter relatedEntitySetter);
/**
* 更新entity的关联子项entities（1—n）
* @param entityId 主表entity id
* @param relatedEntities 关联表entities
* @param relatedEntitySetter 关联Entity类的setter
* @return
*/
boolean updateRelatedEntities(Serializable entityId, List relatedEntities, ISetter relatedEntitySetter);
/**
* 更新entity的关联子项entity （1-1）
* @param entityId 主表entity id
* @param relatedEntity 关联表entity
* @param relatedEntitySetter 关联Entity类的setter
* @return
*/
boolean updateRelatedEntity(Serializable entityId, RE relatedEntity, ISetter relatedEntitySetter);
/**
* 删除entity 及 其关联子项entities
* @param id 待删除entity的主键
* @param relatedEntityClass 待删除关联Entity类
* @param relatedEntitySetter 待删除类的setter方法
* @return
*/
boolean deleteEntityAndRelatedEntities(Serializable id, Class relatedEntityClass, ISetter relatedEntitySetter);
/**
* 删除entity 的关联子项entities（1-n）
* @param entityIds 待删除entity的主键/主键ids
* @param relatedEntityClass 待删除关联Entity类
* @param relatedEntitySetter 待删除类的setter方法
* @return
*/
boolean deleteRelatedEntities(Object entityIds, Class relatedEntityClass, ISetter relatedEntitySetter);
/**
* 删除entity 的关联子项entity（1-1）
* @param entityIds 待删除entity的主键/主键ids
* @param relatedEntityClass 待删除关联Entity类
* @param relatedEntitySetter 待删除类的setter方法
* @return
*/
boolean deleteRelatedEntity(Object entityIds, Class relatedEntityClass, ISetter relatedEntitySetter);
/**
* 按条件删除实体
* @param queryWrapper
* @return
* @throws Exception
*/
boolean deleteEntities(Wrapper queryWrapper);
/**
* 删除
* @param id
* @return
*/
boolean deleteEntity(Serializable id);
/**
* 根据指定字段及匹配值删除实体
* @param fieldKey 字段名
* @param fieldVal 字段值
* @return true:成功, false:失败
*/
boolean deleteEntity(String fieldKey, Object fieldVal);
/**
* 批量删除指定id的实体
* @param entityIds
* @return
* @throws Exception
*/
boolean deleteEntities(Collection entityIds);
/**
* 根据指定字段及值的条件删除匹配记录
* @param fldGetterFn
* @param fieldValue
* @return
* @param
* @param
*/
boolean deleteEntities(SFunction fldGetterFn, Object fieldValue);
/**
* 获取符合条件的entity记录总数
* @return
*/
long getEntityListCount(Wrapper queryWrapper);
/**
* 获取指定条件的Entity集合
* @param queryWrapper
* @return
* @throws Exception
*/
List getEntityList(Wrapper queryWrapper);
/**
* 获取指定条件的Entity集合
* @param queryWrapper
* @param pagination
* @return
* @throws Exception
*/
List getEntityList(Wrapper queryWrapper, Pagination pagination);
/**
* 获取指定条件的Entity集合
* @param ids
* @return
*/
List getEntityListByIds(List ids);
/**
* 获取entity某个属性值
* @param idVal id值
* @param getterFn 返回属性getter
* @return
*/
FT getValueOfField(Serializable idVal, SFunction getterFn);
/**
* 获取entity某个属性值
* @param idFieldFn 查询字段
* @param idVal 查询字段值
* @param getterFn 返回属性getter
* @return
*/
FT getValueOfField(SFunction idFieldFn, Serializable idVal, SFunction getterFn);
/**
* 获取entity某个属性值
*
* @param queryWrapper
* @param getterFn
* @return
* @param
*/
FT getValueOfField(LambdaQueryWrapper queryWrapper, SFunction getterFn);
/**
* 获取指定条件的Entity ID集合
* @param queryWrapper
* @param getterFn
* @return
* @throws Exception
*/
List getValuesOfField(Wrapper queryWrapper, SFunction getterFn);
/**
* 获取指定ID集合，获取映射map
*
* @param idFieldFn
* @param idValList
* @param getterFn
* @return
* @param
* @param
*/
Map getValueMapOfField(SFunction idFieldFn, List idValList, SFunction getterFn);
/**
* 获取指定数量的entity记录
* @param queryWrapper
* @param limitCount
* @return
* @throws Exception
*/
List getEntityListLimit(Wrapper queryWrapper, int limitCount);
/**
* 获取符合条件的一个Entity实体
* @param queryWrapper
* @return entity
*/
T getSingleEntity(Wrapper queryWrapper);
/**
* 是否存在符合条件的记录
* @param getterFn entity的getter方法
* @param value 需要检查的值
* @return
*/
boolean exists(SFunction getterFn, Object value);
/**
* 是否存在符合条件的记录
* @param queryWrapper
* @return
*/
boolean exists(Wrapper queryWrapper);
/**
* 检查值是否唯一
* @param getterFn
* @param value
* @param id
* @return
*/
boolean isValueUnique(SFunction getterFn, Object value, Serializable id);
/**
* 检查值是否唯一
* @param field
* @param value
* @param id
* @return
*/
boolean isValueUnique(String field, Object value, Serializable id);
/**
* 获取指定属性的Map列表
* @param queryWrapper
* @return
*/
List> getMapList(Wrapper queryWrapper);
/**
* 获取指定属性的Map列表
* @param queryWrapper
* @param pagination
* @return
*/
List> getMapList(Wrapper queryWrapper, Pagination pagination);
/***
* 获取键值对的列表，用于构建select下拉选项等
*
* @param queryWrapper
* @return
*/
List getLabelValueList(Wrapper queryWrapper);
/**
* 获取id-指定name的映射map
* @param entityIds
* @param getterFn
* @param
* @return
*/
Map getId2NameMap(List entityIds, SFunction getterFn);
/**
* 获取指定条件的id-Entity 映射map
* @param getterFns
* @return
*/
Map getId2EntityMap(List entityIds, SFunction... getterFns);
/**
* 获取Map
* @param queryWrapper
* @return
*/
Map getMap(Wrapper queryWrapper);
/**
* 根据查询条件获取vo列表
* @param queryWrapper
* @param pagination
* @return
* @throws Exception
*/
List getViewObjectList(Wrapper queryWrapper, Pagination pagination, Class voClass);
/**
* 根据查询条件获取vo树形结构
* @param rootNodeId
* @param voClass
* @param getParentIdsPath
* @param getSortId
* @return
* @throws Exception
*/
List getViewObjectTree(Serializable rootNodeId, Class voClass, SFunction getParentIdsPath, @Nullable SFunction> getSortId);
/**
* 获取View Object对象
* @param id 主键
* @param voClass vo类
* @return entity
*/
VO getViewObject(Serializable id, Class voClass);
/**
* 获取View Object对象
*
* @param queryWrapper
* @param voClass
* @return
* @param
*/
VO getViewObject(Wrapper queryWrapper, Class voClass);
/**
* 获取View Object对象
* @param fieldKey 字段名
* @param fieldValue 字段值
* @param voClass vo类
* @return entity
*/
VO getViewObject(String fieldKey, Object fieldValue, Class voClass);
/**
* list 排序
*
* @param sortParam 排序参数
* @param sortField 排序字段
* @return 排序结果；是否成功
*/
boolean sort(SortParamDTO sortParam, SFunction sortField);
/**
* tree 排序
*
* @param sortField 排序字段
* @param parentIdField 父级ID字段
* @param parentIdsField 父级IDs字段（记录层级关系的字段）
* @return 排序结果；是否成功
*/
boolean sort(SortParamDTO sortParam, SFunction sortField, SFunction parentIdField, SFunction parentIdsField);
}