Module bus.base
Package org.miaixz.bus.base.service

Interface BaseService<T>

Type Parameters:
T - 实体类型
All Superinterfaces:
org.miaixz.bus.core.basic.service.Service
public interface BaseService<T>
基础服务接口，继承BasicService，指定主键类型为String
Since:
Java 17+
Author:
Kimi Liu

  • Method Summary

    Modifier and Type
    Method
    Description
    default org.miaixz.bus.mapper.binding.condition.Condition<T>
    condition()
    通用：获取条件对象
    long
    count(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
    通用：根据条件查询总数
    long
    count(T entity)
    通用：根据实体条件查询总数
    long
    delete(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
    通用：根据条件批量删除
    long
    delete(T entity)
    通用：删除实体
    <F> long
    deleteByFieldList(org.miaixz.bus.mapper.binding.function.Fn<T,F> field, Collection<F> fieldValueList)
    通用：根据指定字段集合删除
    long
    deleteById(String id)
    通用：根据主键删除
    long
    deleteByIds(Collection<String> ids)
    通用：根据多个主键集合删除
    Object
    insert(T entity)
    通用：插入实体（所有字段）
    List<T>
    insertBatch(List<T> list)
    通用：批量插入实体（所有字段）
    List<T>
    insertBatchSelective(List<T> list)
    通用：批量插入实体（非空字段）
    Object
    insertOrUpdate(T entity)
    通用：插入或更新实体（所有字段）
    Object
    insertOrUpdateSelective(T entity)
    通用：插入或更新实体（非空字段）
    Object
    insertSelective(T entity)
    通用：插入实体（非空字段）
    org.miaixz.bus.core.basic.entity.Result<T>
    page(T entity)
    通用：分页查询
    boolean
    pkHasValue(T entity)
    通用：检查实体主键是否有值
    long
    remove(T entity)
    通用：逻辑删除实体
    List<T>
    selectAll()
    通用：查询所有记录
    <F> List<T>
    selectByFieldList(org.miaixz.bus.mapper.binding.function.Fn<T,F> field, Collection<F> fieldValueList)
    通用：根据指定字段集合查询
    Object
    selectById(String id)
    通用：根据主键查询
    Object
    selectFirst(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
    通用：根据条件查询单条记录
    List<T>
    selectList(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
    通用：根据条件查询列表
    List<T>
    selectList(T entity)
    通用：根据实体条件查询列表
    Object
    selectOne(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
    通用：根据条件查询单条记录
    Object
    selectOne(T entity)
    通用：根据实体条件查询单条记录
    Object
    update(T entity)
    通用：更新实体（所有字段）
    long
    update(T entity, org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
    通用：根据条件批量更新（所有字段）
    Object
    update(T entity, org.miaixz.bus.mapper.binding.function.Fn<T,Object>... fields)
    通用：更新实体（指定字段）
    Object
    updateSelective(T entity)
    通用：更新实体（非空字段）
    long
    updateSelective(T entity, org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
    通用：根据条件批量更新（非空字段）
    Object
    updateSelective(T entity, org.miaixz.bus.mapper.binding.function.Fn<T,Object>... fields)
    通用：更新实体（非空字段，强制更新指定字段）
    org.miaixz.bus.mapper.binding.condition.ConditionWrapper<T,String>
    wrapper()
    通用：获取条件包装器

  • Method Details

    • insert

      Object insert(T entity)
      通用：插入实体（所有字段）
      Parameters:
      entity - 实体类
      Returns:
      保存后的实体

    • insertSelective

      Object insertSelective(T entity)
      通用：插入实体（非空字段）
      Parameters:
      entity - 实体类
      Returns:
      保存后的实体

    • insertBatch

      List<T> insertBatch(List<T> list)
      通用：批量插入实体（所有字段）
      Parameters:
      list - 实体列表
      Returns:
      保存后的实体列表

    • insertBatchSelective

      List<T> insertBatchSelective(List<T> list)
      通用：批量插入实体（非空字段）
      Parameters:
      list - 实体列表
      Returns:
      保存后的实体列表

    • update

      Object update(T entity)
      通用：更新实体（所有字段）
      Parameters:
      entity - 实体类
      Returns:
      更新后的实体

    • update

      Object update(T entity, org.miaixz.bus.mapper.binding.function.Fn<T,Object>... fields)
      通用：更新实体（指定字段）
      Parameters:
      entity - 实体类
      fields - 需要更新的字段
      Returns:
      更新后的实体

    • updateSelective

      Object updateSelective(T entity)
      通用：更新实体（非空字段）
      Parameters:
      entity - 实体类
      Returns:
      更新后的实体

    • updateSelective

      Object updateSelective(T entity, org.miaixz.bus.mapper.binding.function.Fn<T,Object>... fields)
      通用：更新实体（非空字段，强制更新指定字段）
      Parameters:
      entity - 实体类
      fields - 强制更新的字段
      Returns:
      更新后的实体

    • insertOrUpdate

      Object insertOrUpdate(T entity)
      通用：插入或更新实体（所有字段）
      Parameters:
      entity - 实体类
      Returns:
      保存或更新后的实体

    • insertOrUpdateSelective

      Object insertOrUpdateSelective(T entity)
      通用：插入或更新实体（非空字段）
      Parameters:
      entity - 实体类
      Returns:
      保存或更新后的实体

    • remove

      long remove(T entity)
      通用：逻辑删除实体
      Parameters:
      entity - 要删除的实体
      Returns:
      受影响的行数

    • delete

      long delete(T entity)
      通用：删除实体
      Parameters:
      entity - 实体类
      Returns:
      删除的记录数，大于0表示成功

    • deleteById

      long deleteById(String id)
      通用：根据主键删除
      Parameters:
      id - 主键
      Returns:
      删除的记录数，1表示成功

    • deleteByIds

      long deleteByIds(Collection<String> ids)
      通用：根据多个主键集合删除
      Parameters:
      ids - 主键集合
      Returns:
      删除的记录数

    • deleteByFieldList

      <F> long deleteByFieldList(org.miaixz.bus.mapper.binding.function.Fn<T,F> field, Collection<F> fieldValueList)
      通用：根据指定字段集合删除
      Type Parameters:
      F - 字段值类型
      Parameters:
      field - 字段
      fieldValueList - 字段值集合
      Returns:
      删除的记录数

    • selectById

      Object selectById(String id)
      通用：根据主键查询
      Parameters:
      id - 主键
      Returns:
      实体，未找到返回null

    • selectOne

      Object selectOne(T entity)
      通用：根据实体条件查询单条记录
      Parameters:
      entity - 实体类
      Returns:
      实体，未找到返回null

    • selectList

      List<T> selectList(T entity)
      通用：根据实体条件查询列表
      Parameters:
      entity - 实体类
      Returns:
      实体列表

    • selectByFieldList

      <F> List<T> selectByFieldList(org.miaixz.bus.mapper.binding.function.Fn<T,F> field, Collection<F> fieldValueList)
      通用：根据指定字段集合查询
      Type Parameters:
      F - 字段值类型
      Parameters:
      field - 字段
      fieldValueList - 字段值集合
      Returns:
      实体列表

    • selectAll

      List<T> selectAll()
      通用：查询所有记录
      Returns:
      实体列表

    • count

      long count(T entity)
      通用：根据实体条件查询总数
      Parameters:
      entity - 实体类
      Returns:
      记录总数

    • condition

      default org.miaixz.bus.mapper.binding.condition.Condition<T> condition()
      通用：获取条件对象
      Returns:
      条件对象

    • delete

      long delete(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
      通用：根据条件批量删除
      Parameters:
      condition - 查询条件
      Returns:
      删除的记录数，大于0表示成功

    • update

      long update(T entity, org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
      通用：根据条件批量更新（所有字段）
      Parameters:
      entity - 实体类
      condition - 查询条件
      Returns:
      更新的记录数，大于0表示成功

    • updateSelective

      long updateSelective(T entity, org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
      通用：根据条件批量更新（非空字段）
      Parameters:
      entity - 实体类
      condition - 查询条件
      Returns:
      更新的记录数，大于0 STRUCTURE表示成功

    • selectOne

      Object selectOne(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
      通用：根据条件查询单条记录
      Parameters:
      condition - 查询条件
      Returns:
      实体，未找到返回null

    • selectFirst

      Object selectFirst(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
      通用：根据条件查询单条记录
      Parameters:
      condition - 查询条件
      Returns:
      实体

    • selectList

      List<T> selectList(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
      通用：根据条件查询列表
      Parameters:
      condition - 查询条件
      Returns:
      实体列表

    • count

      long count(org.miaixz.bus.mapper.binding.condition.Condition<T> condition)
      通用：根据条件查询总数
      Parameters:
      condition - 查询条件
      Returns:
      记录总数

    • pkHasValue

      boolean pkHasValue(T entity)
      通用：检查实体主键是否有值
      Parameters:
      entity - 实体类
      Returns:
      true表示有值，false表示为空

    • page

      org.miaixz.bus.core.basic.entity.Result<T> page(T entity)
      通用：分页查询
      Parameters:
      entity - 实体类（包含分页和排序参数）
      Returns:
      分页结果，包含记录列表和总数

    • wrapper

      org.miaixz.bus.mapper.binding.condition.ConditionWrapper<T,String> wrapper()
      通用：获取条件包装器
      Returns:
      条件包装器