IService (Mybatis-Flex)

类型参数:

T - 实体类（Entity）类型
```
public interface IService<T>
```
由 Mybatis-Flex 提供的顶级增强 Service 接口。

从以下版本开始:

2023-05-01

作者:

王帅

字段概要

字段
限定符和类型字段和说明

static int DEFAULT_BATCH_SIZE

字段
限定符和类型	字段和说明
`static int`	`DEFAULT_BATCH_SIZE`

方法概要

所有方法实例方法抽象方法默认方法
限定符和类型	方法和说明
`default long`	`count()` 查询所有数据数量。
`default long`	`count(QueryCondition condition)` 根据查询条件查询数据数量。
`default long`	`count(QueryWrapper query)` 根据查询条件查询数据数量。
`default boolean`	`exists(QueryCondition condition)` 根据查询条件判断数据是否存在。
`default boolean`	`exists(QueryWrapper query)` 根据查询条件判断数据是否存在。
`default Optional<T>`	`getByEntityIdOpt(T entity)` 根据实体主键查询数据。
`default T`	`getById(Serializable id)` 根据数据主键查询一条数据。
`default Optional<T>`	`getByIdOpt(Serializable id)` 根据数据主键查询一条数据。
`BaseMapper<T>`	`getMapper()` 获取对应实体类（Entity）的基础映射类（BaseMapper）。
`default Object`	`getObj(QueryWrapper query)` 查询结果集中第一列，且第一条数据。
`default <R> R`	`getObjAs(QueryWrapper query, Class<R> asType)` 查询结果集中第一列，且第一条数据，并转换为指定类型，比如 `Long`, `String` 等。
`default <R> Optional<R>`	`getObjAsOpt(QueryWrapper query, Class<R> asType)` 查询结果集中第一列，且第一条数据，并转换为指定类型，比如 `Long`, `String` 等，封装为 `Optional` 返回。
`default Optional<Object>`	`getObjOpt(QueryWrapper query)` 查询结果集中第一列，且第一条数据，并封装为 `Optional` 返回。
`default T`	`getOne(QueryCondition condition)` 根据查询条件查询一条数据。
`default T`	`getOne(QueryWrapper query)` 根据查询条件查询一条数据。
`default <R> R`	`getOneAs(QueryWrapper query, Class<R> asType)` 根据查询条件查询一条数据，并通过 asType 进行接收。
`default <R> Optional<R>`	`getOneAsOpt(QueryWrapper query, Class<R> asType)` 根据查询条件查询一条数据。
`default T`	`getOneByEntityId(T entity)` 根据实体主键查询数据。
`default Optional<T>`	`getOneOpt(QueryCondition condition)` 根据查询条件查询一条数据。
`default Optional<T>`	`getOneOpt(QueryWrapper query)` 根据查询条件查询一条数据。
`default List<T>`	`list()` 查询所有数据。
`default List<T>`	`list(QueryCondition condition)` 根据查询条件查询数据集合。
`default List<T>`	`list(QueryWrapper query)` 根据查询条件查询数据集合。
`default <R> List<R>`	`listAs(QueryWrapper query, Class<R> asType)` 根据查询条件查询数据集合，并通过 asType 进行接收。
`default List<T>`	`listByIds(Collection<? extends Serializable> ids)` 根据数据主键查询数据集合。
`default List<T>`	`listByMap(Map<String,Object> query)` 根据 `Map` 构建查询条件查询数据集合。
`default List<Object>`	`objList(QueryWrapper query)` 查询结果集中第一列所有数据。
`default <R> List<R>`	`objListAs(QueryWrapper query, Class<R> asType)` 查询结果集中第一列所有数据，并转换为指定类型，比如 `Long`, `String` 等。
`default Page<T>`	`page(Page<T> page)` 分页查询所有数据。
`default Page<T>`	`page(Page<T> page, QueryCondition condition)` 根据查询条件分页查询数据。
`default Page<T>`	`page(Page<T> page, QueryWrapper query)` 根据查询条件分页查询数据。
`default <R> Page<R>`	`pageAs(Page<R> page, QueryWrapper query, Class<R> asType)` 根据查询条件分页查询数据，并通过 asType 进行接收。
`default QueryWrapper`	`query()` 默认 `QueryWrapper` 构建。
`default QueryChain<T>`	`queryChain()` 链式查询。
`default boolean`	`remove(QueryCondition condition)` 根据查询条件删除数据。
`default boolean`	`remove(QueryWrapper query)` 根据查询条件删除数据。
`default boolean`	`removeById(Serializable id)` 根据数据主键删除数据。
`default boolean`	`removeById(T entity)` 根据实体主键删除数据。
`default boolean`	`removeByIds(Collection<? extends Serializable> ids)` 根据数据主键批量删除数据。
`default boolean`	`removeByMap(Map<String,Object> query)` 根据 `Map` 构建查询条件删除数据。
`default boolean`	`save(T entity)` 保存实体类对象数据。
`default boolean`	`saveBatch(Collection<T> entities)` 批量保存实体类对象数据。
`default boolean`	`saveBatch(Collection<T> entities, int batchSize)` 批量保存实体类对象数据。
`default boolean`	`saveOrUpdate(T entity)` 保存或者更新实体类对象数据。
`default boolean`	`saveOrUpdateBatch(Collection<T> entities)` 保存或者更新实体类对象数据。
`default boolean`	`saveOrUpdateBatch(Collection<T> entities, int batchSize)` 保存或者更新实体类对象数据。
`default boolean`	`update(T entity, Map<String,Object> query)` 根据 `Map` 构建查询条件更新数据。
`default boolean`	`update(T entity, QueryCondition condition)` 根据查询条件更新数据。
`default boolean`	`update(T entity, QueryWrapper query)` 根据查询条件更新数据。
`default boolean`	`updateBatch(Collection<T> entities)` 根据数据主键批量更新数据
`default boolean`	`updateBatch(Collection<T> entities, boolean ignoreNulls)` 根据数据主键批量更新数据
`default boolean`	`updateBatch(Collection<T> entities, int batchSize)` 根据数据主键批量更新数据
`default boolean`	`updateBatch(Collection<T> entities, int batchSize, boolean ignoreNulls)` 根据数据主键批量更新数据
`default boolean`	`updateById(T entity)` 根据数据主键更新数据。
`default boolean`	`updateById(T entity, boolean ignoreNulls)` 根据主键更新数据
`default UpdateChain<T>`	`updateChain()` 链式更新。

- 字段详细资料
  - DEFAULT_BATCH_SIZE
```
static final int DEFAULT_BATCH_SIZE
```
    另请参阅:
    
    常量字段值
- 方法详细资料
  - getMapper
```
BaseMapper<T> getMapper()
```
    获取对应实体类（Entity）的基础映射类（BaseMapper）。
    
    返回:
    
    基础映射类（BaseMapper）
  - save
```
default boolean save(T entity)
```
    保存实体类对象数据。
    
    参数:
    
    entity - 实体类对象
    
    返回:
    
    true 保存成功，false 保存失败。
  - saveBatch
```
default boolean saveBatch(Collection<T> entities)
```
    批量保存实体类对象数据。
    
    参数:
    
    entities - 实体类对象
    
    返回:
    
    true 保存成功，false 保存失败。
  - saveBatch
```
default boolean saveBatch(Collection<T> entities,
                          int batchSize)
```
    批量保存实体类对象数据。
    
    参数:
    
    entities - 实体类对象
    
    batchSize - 每次保存切分的数量
    
    返回:
    
    true 保存成功，false 保存失败。
  - saveOrUpdate
```
default boolean saveOrUpdate(T entity)
```
    保存或者更新实体类对象数据。
    
    参数:
    
    entity - 实体类对象
    
    返回:
    
    true 保存或更新成功，false 保存或更新失败。
  - saveOrUpdateBatch
```
default boolean saveOrUpdateBatch(Collection<T> entities)
```
    保存或者更新实体类对象数据。
    
    参数:
    
    entities - 实体类对象
    
    返回:
    
    true 保存或更新成功，false 保存或更新失败。
  - saveOrUpdateBatch
```
default boolean saveOrUpdateBatch(Collection<T> entities,
                                  int batchSize)
```
    保存或者更新实体类对象数据。
    
    参数:
    
    entities - 实体类对象
    
    batchSize - 每次操作切分的数量
    
    返回:
    
    true 保存或更新成功，false 保存或更新失败。
  - remove
```
default boolean remove(QueryWrapper query)
```
    根据查询条件删除数据。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    true 删除成功，false 删除失败。
  - remove
```
default boolean remove(QueryCondition condition)
```
    根据查询条件删除数据。
    
    参数:
    
    condition - 查询条件
    
    返回:
    
    true 删除成功，false 删除失败。
  - removeById
```
default boolean removeById(T entity)
```
    根据实体主键删除数据。
    
    参数:
    
    entity - 实体类对象
    
    返回:
    
    true 删除成功，false 删除失败。
  - removeById
```
default boolean removeById(Serializable id)
```
    根据数据主键删除数据。
    
    参数:
    
    id - 数据主键
    
    返回:
    
    true 删除成功，false 删除失败。
  - removeByIds
```
default boolean removeByIds(Collection<? extends Serializable> ids)
```
    根据数据主键批量删除数据。
    
    参数:
    
    ids - 数据主键
    
    返回:
    
    true 删除成功，false 删除失败。
  - removeByMap
```
default boolean removeByMap(Map<String,Object> query)
```
    根据 Map 构建查询条件删除数据。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    true 删除成功，false 删除失败。
  - updateById
```
default boolean updateById(T entity)
```
    根据数据主键更新数据。
    
    参数:
    
    entity - 实体类对象
    
    返回:
    
    true 更新成功，false 更新失败。
  - updateById
```
default boolean updateById(T entity,
                           boolean ignoreNulls)
```
    根据主键更新数据
    
    参数:
    
    entity - 实体对象
    
    ignoreNulls - 是否忽略 null 值
    
    返回:
    
    true 更新成功，false 更新失败。
  - update
```
default boolean update(T entity,
                       Map<String,Object> query)
```
    根据 Map 构建查询条件更新数据。
    
    参数:
    
    entity - 实体类对象
    
    query - 查询条件
    
    返回:
    
    true 更新成功，false 更新失败。
  - update
```
default boolean update(T entity,
                       QueryWrapper query)
```
    根据查询条件更新数据。
    
    参数:
    
    entity - 实体类对象
    
    query - 查询条件
    
    返回:
    
    true 更新成功，false 更新失败。
  - update
```
default boolean update(T entity,
                       QueryCondition condition)
```
    根据查询条件更新数据。
    
    参数:
    
    entity - 实体类对象
    
    condition - 查询条件
    
    返回:
    
    true 更新成功，false 更新失败。
  - updateBatch
```
default boolean updateBatch(Collection<T> entities)
```
    根据数据主键批量更新数据
    
    参数:
    
    entities - 实体类对象集合
    
    返回:
    
    boolean true 更新成功，false 更新失败。
  - updateBatch
```
default boolean updateBatch(Collection<T> entities,
                            boolean ignoreNulls)
```
    根据数据主键批量更新数据
    
    参数:
    
    entities - 实体类对象集合
    
    ignoreNulls - 是否忽略空字段 true 表示忽略实体类中为 null 的字段，不更新这些字段。 false 表示不忽略空字段，允许将对应字段更新为 null。
    
    返回:
    
    boolean true 更新成功，false 更新失败。
  - updateBatch
```
default boolean updateBatch(Collection<T> entities,
                            int batchSize)
```
    根据数据主键批量更新数据
    
    参数:
    
    entities - 实体类对象集合
    
    batchSize - 每批次更新数量
    
    返回:
    
    true 更新成功，false 更新失败。
  - updateBatch
```
default boolean updateBatch(Collection<T> entities,
                            int batchSize,
                            boolean ignoreNulls)
```
    根据数据主键批量更新数据
    
    参数:
    
    entities - 实体类对象集合
    
    batchSize - 每批次更新数量
    
    ignoreNulls - 是否忽略空字段 true 表示忽略实体类中为 null 的字段，不更新这些字段。 false 表示不忽略空字段，允许将对应字段更新为 null。
    
    返回:
    
    true 更新成功，false 更新失败。
  - getById
```
default T getById(Serializable id)
```
    根据数据主键查询一条数据。
    
    参数:
    
    id - 数据主键
    
    返回:
    
    查询结果数据
  - getOneByEntityId
```
default T getOneByEntityId(T entity)
```
    根据实体主键查询数据。
    
    参数:
    
    entity - 实体对象，必须包含有主键
    
    返回:
    
    查询结果数据
  - getByEntityIdOpt
```
default Optional<T> getByEntityIdOpt(T entity)
```
    根据实体主键查询数据。
    
    参数:
    
    entity - 实体对象，必须包含有主键
    
    返回:
    
    查询结果数据
  - getByIdOpt
```
default Optional<T> getByIdOpt(Serializable id)
```
    根据数据主键查询一条数据。
    
    参数:
    
    id - 数据主键
    
    返回:
    
    查询结果数据
  - getOne
```
default T getOne(QueryWrapper query)
```
    根据查询条件查询一条数据。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    查询结果数据
  - getOneOpt
```
default Optional<T> getOneOpt(QueryWrapper query)
```
    根据查询条件查询一条数据。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    查询结果数据
  - getOneAs
```
default <R> R getOneAs(QueryWrapper query,
                       Class<R> asType)
```
    根据查询条件查询一条数据，并通过 asType 进行接收。
    
    参数:
    
    query - 查询条件
    
    asType - 接收的数据类型
    
    返回:
    
    查询结果数据
  - getOneAsOpt
```
default <R> Optional<R> getOneAsOpt(QueryWrapper query,
                                    Class<R> asType)
```
    根据查询条件查询一条数据。
    
    参数:
    
    query - 查询条件
    
    asType - 接收的数据类型
    
    返回:
    
    查询结果数据
  - getOne
```
default T getOne(QueryCondition condition)
```
    根据查询条件查询一条数据。
    
    参数:
    
    condition - 查询条件
    
    返回:
    
    查询结果数据
  - getOneOpt
```
default Optional<T> getOneOpt(QueryCondition condition)
```
    根据查询条件查询一条数据。
    
    参数:
    
    condition - 查询条件
    
    返回:
    
    查询结果数据
  - getObj
```
default Object getObj(QueryWrapper query)
```
    查询结果集中第一列，且第一条数据。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    数据值
  - getObjOpt
```
default Optional<Object> getObjOpt(QueryWrapper query)
```
    查询结果集中第一列，且第一条数据，并封装为 Optional 返回。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    数据值
  - getObjAs
```
default <R> R getObjAs(QueryWrapper query,
                       Class<R> asType)
```
    查询结果集中第一列，且第一条数据，并转换为指定类型，比如 Long, String 等。
    
    参数:
    
    query - 查询条件
    
    asType - 接收的数据类型
    
    返回:
    
    数据值
  - getObjAsOpt
```
default <R> Optional<R> getObjAsOpt(QueryWrapper query,
                                    Class<R> asType)
```
    查询结果集中第一列，且第一条数据，并转换为指定类型，比如 Long, String 等，封装为 Optional 返回。
    
    参数:
    
    query - 查询条件
    
    asType - 接收的数据类型
    
    返回:
    
    数据值
  - objList
```
default List<Object> objList(QueryWrapper query)
```
    查询结果集中第一列所有数据。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    数据列表
  - objListAs
```
default <R> List<R> objListAs(QueryWrapper query,
                              Class<R> asType)
```
    查询结果集中第一列所有数据，并转换为指定类型，比如 Long, String 等。
    
    参数:
    
    query - 查询条件
    
    asType - 接收的数据类型
    
    返回:
    
    数据列表
  - list
```
default List<T> list()
```
    查询所有数据。
    
    返回:
    
    所有数据
  - list
```
default List<T> list(QueryWrapper query)
```
    根据查询条件查询数据集合。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    数据集合
  - list
```
default List<T> list(QueryCondition condition)
```
    根据查询条件查询数据集合。
    
    参数:
    
    condition - 查询条件
    
    返回:
    
    数据集合
  - listAs
```
default <R> List<R> listAs(QueryWrapper query,
                           Class<R> asType)
```
    根据查询条件查询数据集合，并通过 asType 进行接收。
    
    参数:
    
    query - 查询条件
    
    asType - 接收的数据类型
    
    返回:
    
    数据集合
  - listByIds
```
default List<T> listByIds(Collection<? extends Serializable> ids)
```
    根据数据主键查询数据集合。
    
    参数:
    
    ids - 数据主键
    
    返回:
    
    数据集合
  - listByMap
```
default List<T> listByMap(Map<String,Object> query)
```
    根据 Map 构建查询条件查询数据集合。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    数据集合
  - exists
```
default boolean exists(QueryWrapper query)
```
    根据查询条件判断数据是否存在。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    true 数据存在，false 数据不存在。
  - exists
```
default boolean exists(QueryCondition condition)
```
    根据查询条件判断数据是否存在。
    
    参数:
    
    condition - 查询条件
    
    返回:
    
    true 数据存在，false 数据不存在。
  - count
```
default long count()
```
    查询所有数据数量。
    
    返回:
    
    所有数据数量
  - count
```
default long count(QueryWrapper query)
```
    根据查询条件查询数据数量。
    
    参数:
    
    query - 查询条件
    
    返回:
    
    数据数量
  - count
```
default long count(QueryCondition condition)
```
    根据查询条件查询数据数量。
    
    参数:
    
    condition - 查询条件
    
    返回:
    
    数据数量
  - page
```
default Page<T> page(Page<T> page)
```
    分页查询所有数据。
    
    参数:
    
    page - 分页对象
    
    返回:
    
    分页对象
  - page
```
default Page<T> page(Page<T> page,
                     QueryWrapper query)
```
    根据查询条件分页查询数据。
    
    参数:
    
    page - 分页对象
    
    query - 查询条件
    
    返回:
    
    分页对象
  - page
```
default Page<T> page(Page<T> page,
                     QueryCondition condition)
```
    根据查询条件分页查询数据。
    
    参数:
    
    page - 分页对象
    
    condition - 查询条件
    
    返回:
    
    分页对象
  - pageAs
```
default <R> Page<R> pageAs(Page<R> page,
                           QueryWrapper query,
                           Class<R> asType)
```
    根据查询条件分页查询数据，并通过 asType 进行接收。
    
    参数:
    
    page - 分页对象
    
    query - 查询条件
    
    asType - 接收的数据类型
    
    返回:
    
    分页对象
  - query
```
default QueryWrapper query()
```
    默认 QueryWrapper 构建。
    
    返回:
    
    QueryWrapper 对象
  - queryChain
```
default QueryChain<T> queryChain()
```
    链式查询。
    
    返回:
    
    QueryChain 对象
  - updateChain
```
default UpdateChain<T> updateChain()
```
    链式更新。
    
    返回:
    
    UpdateChain 对象

接口 IService<T>

字段概要

方法概要

字段详细资料

DEFAULT_BATCH_SIZE

方法详细资料

getMapper

save

saveBatch

saveBatch

saveOrUpdate

saveOrUpdateBatch

saveOrUpdateBatch

remove

remove

removeById

removeById

removeByIds

removeByMap

updateById

updateById

update

update

update

updateBatch

updateBatch

updateBatch

updateBatch

getById

getOneByEntityId

getByEntityIdOpt

getByIdOpt

getOne

getOneOpt

getOneAs

getOneAsOpt

getOne

getOneOpt

getObj

getObjOpt

getObjAs

getObjAsOpt

objList

objListAs

list

list

list

listAs

listByIds

listByMap

exists

exists

count

count

count

page

page

page

pageAs

query

queryChain

updateChain