org.github.foxnic.web.system.service.ITenantService Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of service-system Show documentation
Show all versions of service-system Show documentation
System Service Module Of Foxnic-Web
package org.github.foxnic.web.system.service;
import com.github.foxnic.api.transter.Result;
import com.github.foxnic.dao.data.PagedList;
import com.github.foxnic.dao.data.SaveMode;
import com.github.foxnic.dao.entity.ISimpleIdService;
import com.github.foxnic.dao.entity.ReferCause;
import com.github.foxnic.sql.expr.ConditionExpr;
import com.github.foxnic.sql.expr.OrderBy;
import com.github.foxnic.sql.meta.DBField;
import org.github.foxnic.web.domain.system.Tenant;
import org.github.foxnic.web.domain.system.TenantVO;
import java.util.List;
import java.util.Map;
/**
*
* 租户服务接口
*
* @author 李方捷 , [email protected]
* @since 2022-10-28 14:38:52
*/
public interface ITenantService extends ISimpleIdService {
/**
* 添加，如果语句错误，则抛出异常
* @param tenant 数据对象
* @return 插入是否成功
* */
Result insert(Tenant tenant);
/**
* 添加，根据 throwsException 参数抛出异常或返回 Result 对象
*
* @param tenant 数据对象
* @param throwsException 是否抛出异常，如果不抛出异常，则返回一个失败的 Result 对象
* @return 结果 , 如果失败返回 false，成功返回 true
*/
Result insert(Tenant tenant,boolean throwsException);
/**
* 批量插入实体，事务内
* @param tenantList 实体数据清单
* @return 插入是否成功
* */
Result insertList(List tenantList);
/**
* 按主键删除租户
*
* @param id 主键
* @return 删除是否成功
*/
Result deleteByIdPhysical(String id);
/**
* 按主键删除租户
*
* @param id 主键
* @return 删除是否成功
*/
Result deleteByIdLogical(String id);
/**
* 批量物理删除，仅支持单字段主键表
* @param ids 主键清单
* @return 是否删除成功
* */
Result deleteByIdsPhysical(List ids);
/**
* 批量逻辑删除，仅支持单字段主键表
* @param ids 主键清单
* @return 是否删除成功
* */
Result deleteByIdsLogical(List ids);
/**
* 按主键更新租户
*
* @param id 主键
* @return 是否更新成功
*/
boolean update(DBField field,Object value , String id);
/**
* 更新，如果执行错误，则抛出异常
* @param tenant 数据对象
* @param mode 保存模式
* @return 保存是否成功
* */
Result update(Tenant tenant , SaveMode mode);
/**
* 更新，根据 throwsException 参数抛出异常或返回 Result 对象
*
* @param tenant 数据对象
* @param mode SaveMode,数据更新的模式
* @param throwsException 是否抛出异常，如果不抛出异常，则返回一个失败的 Result 对象
* @return 结果
*/
Result update(Tenant tenant , SaveMode mode,boolean throwsException);
/**
* 更新实体集，事务内
* @param tenantList 数据对象列表
* @param mode 保存模式
* @return 保存是否成功
* */
Result updateList(List tenantList, SaveMode mode);
/**
* 保存实体，根据 throwsException 参数抛出异常或返回 Result 对象
* @param tenant 实体数据
* @param mode 保存模式
* @param throwsException 是否抛出异常，如果不抛出异常，则返回一个失败的 Result 对象
* @return 保存是否成功
* */
Result save(Tenant tenant , SaveMode mode,boolean throwsException);
/**
* 保存实体，如果语句错误，则抛出异常
* @param tenant 实体数据
* @param mode 保存模式
* @return 保存是否成功
* */
Result save(Tenant tenant , SaveMode mode);
/**
* 保存实体，如果主键值不为null，则更新，否则插入
* @param tenantList 实体数据清单
* @param mode 保存模式
* @return 保存是否成功
* */
Result saveList(List tenantList , SaveMode mode);
/**
* 检查实体中的数据字段是否已经存在 . 判断 主键值不同，但指定字段的值相同的记录是否存在
* @param tenant 实体对象
* @param field 字段清单，至少指定一个
* @return 是否已经存在
* */
boolean checkExists(Tenant tenant,DBField... field);
/**
* 按主键获取租户
*
* @param id 主键
* @return Tenant 数据对象
*/
Tenant getById(String id);
/**
* 按 id 获取多个对象
* @param ids 主键清单
* @return 实体集
* */
List queryListByIds(List ids);
/**
* 按 id 列表查询 Map
* @param ids 主键清单
* */
Map queryMapByIds(List ids);
/**
* 检查 实体 是否已经存在 , 判断 主键值不同，但指定字段的值相同的记录是否存在
*
* @param tenant 数据对象
* @return 判断结果
*/
Boolean checkExists(Tenant tenant);
/**
* 根据实体数构建默认的条件表达式, 不支持 Join 其它表
* @param sample 数据样例
* @return ConditionExpr 条件表达式
* */
ConditionExpr buildQueryCondition(Tenant sample);
/**
* 根据实体数构建默认的条件表达式, 不支持 Join 其它表
* @param sample 数据样例
* @param tableAliase 数据表别名
* @return ConditionExpr 条件表达式
* */
ConditionExpr buildQueryCondition(Tenant sample,String tableAliase);
/**
* 查询实体集合，默认情况下，字符串使用模糊匹配，非字符串使用精确匹配
* @param sample 查询条件
* @return 查询结果
* */
List queryList(TenantVO sample);
/**
* 查询实体集合，默认情况下，字符串使用模糊匹配，非字符串使用精确匹配
* @param sample 查询条件
* @param condition 其它条件
* @param orderBy 排序
* @return 查询结果
* */
List queryList(Tenant sample,ConditionExpr condition,OrderBy orderBy);
/**
* 查询实体集合，默认情况下，字符串使用模糊匹配，非字符串使用精确匹配
* @param sample 查询条件
* @param orderBy 排序
* @return 查询结果
* */
List queryList(Tenant sample,OrderBy orderBy);
/**
* 查询实体集合，默认情况下，字符串使用模糊匹配，非字符串使用精确匹配
* @param sample 查询条件
* @param condition 其它条件
* @return 查询结果
* */
List queryList(Tenant sample,ConditionExpr condition);
/**
* 查询单个实体
* @param sample 查询条件
* @return 查询结果
* */
Tenant queryEntity(Tenant sample);
/**
* 分页查询实体集
* @param sample 查询条件
* @param pageSize 分页条数
* @param pageIndex 页码
* @return 查询结果
* */
PagedList queryPagedList(TenantVO sample,int pageSize,int pageIndex);
/**
* 分页查询实体集
* @param sample 查询条件
* @param pageSize 分页条数
* @param pageIndex 页码
* @param condition 其它条件
* @param orderBy 排序
* @return 查询结果
* */
PagedList queryPagedList(Tenant sample,ConditionExpr condition,OrderBy orderBy,int pageSize,int pageIndex);
/**
* 分页查询实体集
* @param sample 查询条件
* @param pageSize 分页条数
* @param pageIndex 页码
* @param condition 其它条件
* @return 查询结果
* */
PagedList queryPagedList(Tenant sample,ConditionExpr condition,int pageSize,int pageIndex);
/**
* 分页查询实体集
* @param sample 查询条件
* @param pageSize 分页条数
* @param pageIndex 页码
* @param orderBy 排序
* @return 查询结果
* */
PagedList queryPagedList(Tenant sample,OrderBy orderBy,int pageSize,int pageIndex);
/**
* 查询指定字段的数据清单
* @param 元素类型
* @param field 字段
* @param type 元素类型
* @param condition 条件表达式
* @return 列数据
* */
List queryValues(DBField field,Class type, ConditionExpr condition);
/**
* 查询指定字段的数据清单
* @param 元素类型
* @param field 字段
* @param type 元素类型
* @param condition 条件表达式
* @param ps 参数清单
* @return 列数据
* */
List queryValues(DBField field, Class type, String condition,Object... ps);
}