接口 BaseMapper<T>

  • 所有超级接口:
    Mapper<T>

    public interface BaseMapper<T>
    extends Mapper<T>
    Mapper 继承该接口后,无需编写 mapper.xml 文件,即可获得CRUD功能

    这个 Mapper 支持 id 泛型

    从以下版本开始:
    2016-01-23
    作者:
    hubin
    • 方法概要

      所有方法 实例方法 抽象方法 默认方法 
      修饰符和类型 方法 说明
      int delete​(Wrapper<T> queryWrapper)
      根据 entity 条件,删除记录
      int deleteBatchIds​(java.util.Collection<?> idList)
      删除(根据ID或实体 批量删除)
      int deleteById​(java.io.Serializable id)
      根据 ID 删除
      int deleteById​(T entity)
      根据实体(ID)删除
      int deleteByMap​(java.util.Map<java.lang.String,​java.lang.Object> columnMap)
      根据 columnMap 条件,删除记录
      default boolean exists​(Wrapper<T> queryWrapper)
      根据 Wrapper 条件,判断是否存在记录
      int insert​(T entity)
      插入一条记录
      java.util.List<T> selectBatchIds​(java.util.Collection<? extends java.io.Serializable> idList)
      查询(根据ID 批量查询)
      T selectById​(java.io.Serializable id)
      根据 ID 查询
      java.util.List<T> selectByMap​(java.util.Map<java.lang.String,​java.lang.Object> columnMap)
      查询(根据 columnMap 条件)
      java.lang.Long selectCount​(Wrapper<T> queryWrapper)
      根据 Wrapper 条件,查询总记录数
      java.util.List<T> selectList​(Wrapper<T> queryWrapper)
      根据 entity 条件,查询全部记录
      java.util.List<java.util.Map<java.lang.String,​java.lang.Object>> selectMaps​(Wrapper<T> queryWrapper)
      根据 Wrapper 条件,查询全部记录
      <P extends IPage<java.util.Map<java.lang.String,​java.lang.Object>>>
      P
      selectMapsPage​(P page, Wrapper<T> queryWrapper)
      根据 Wrapper 条件,查询全部记录(并翻页)
      java.util.List<java.lang.Object> selectObjs​(Wrapper<T> queryWrapper)
      根据 Wrapper 条件,查询全部记录
      default T selectOne​(Wrapper<T> queryWrapper)
      根据 entity 条件,查询一条记录
      <P extends IPage<T>>
      P
      selectPage​(P page, Wrapper<T> queryWrapper)
      根据 entity 条件,查询全部记录(并翻页)
      int update​(T entity, Wrapper<T> updateWrapper)
      根据 whereEntity 条件,更新记录
      int updateById​(T entity)
      根据 ID 修改
    • 方法详细资料

      • insert

        int insert​(T entity)
        插入一条记录
        参数:
        entity - 实体对象
      • deleteById

        int deleteById​(java.io.Serializable id)
        根据 ID 删除
        参数:
        id - 主键ID
      • deleteById

        int deleteById​(T entity)
        根据实体(ID)删除
        参数:
        entity - 实体对象
        从以下版本开始:
        3.4.4
      • deleteByMap

        int deleteByMap​(@Param("cm")
                        java.util.Map<java.lang.String,​java.lang.Object> columnMap)
        根据 columnMap 条件,删除记录
        参数:
        columnMap - 表字段 map 对象
      • delete

        int delete​(@Param("ew")
                   Wrapper<T> queryWrapper)
        根据 entity 条件,删除记录
        参数:
        queryWrapper - 实体对象封装操作类(可以为 null,里面的 entity 用于生成 where 语句)
      • deleteBatchIds

        int deleteBatchIds​(@Param("coll")
                           java.util.Collection<?> idList)
        删除(根据ID或实体 批量删除)
        参数:
        idList - 主键ID列表或实体列表(不能为 null 以及 empty)
      • updateById

        int updateById​(@Param("et")
                       T entity)
        根据 ID 修改
        参数:
        entity - 实体对象
      • update

        int update​(@Param("et")
                   T entity,
                   @Param("ew")
                   Wrapper<T> updateWrapper)
        根据 whereEntity 条件,更新记录
        参数:
        entity - 实体对象 (set 条件值,可以为 null)
        updateWrapper - 实体对象封装操作类(可以为 null,里面的 entity 用于生成 where 语句)
      • selectById

        T selectById​(java.io.Serializable id)
        根据 ID 查询
        参数:
        id - 主键ID
      • selectBatchIds

        java.util.List<T> selectBatchIds​(@Param("coll")
                                         java.util.Collection<? extends java.io.Serializable> idList)
        查询(根据ID 批量查询)
        参数:
        idList - 主键ID列表(不能为 null 以及 empty)
      • selectByMap

        java.util.List<T> selectByMap​(@Param("cm")
                                      java.util.Map<java.lang.String,​java.lang.Object> columnMap)
        查询(根据 columnMap 条件)
        参数:
        columnMap - 表字段 map 对象
      • selectOne

        default T selectOne​(@Param("ew")
                            Wrapper<T> queryWrapper)
        根据 entity 条件,查询一条记录

        查询一条记录,例如 qw.last("limit 1") 限制取一条记录, 注意:多条数据会报异常

        参数:
        queryWrapper - 实体对象封装操作类(可以为 null)
      • exists

        default boolean exists​(Wrapper<T> queryWrapper)
        根据 Wrapper 条件,判断是否存在记录
        参数:
        queryWrapper - 实体对象封装操作类
        返回:
      • selectCount

        java.lang.Long selectCount​(@Param("ew")
                                   Wrapper<T> queryWrapper)
        根据 Wrapper 条件,查询总记录数
        参数:
        queryWrapper - 实体对象封装操作类(可以为 null)
      • selectList

        java.util.List<T> selectList​(@Param("ew")
                                     Wrapper<T> queryWrapper)
        根据 entity 条件,查询全部记录
        参数:
        queryWrapper - 实体对象封装操作类(可以为 null)
      • selectMaps

        java.util.List<java.util.Map<java.lang.String,​java.lang.Object>> selectMaps​(@Param("ew")
                                                                                          Wrapper<T> queryWrapper)
        根据 Wrapper 条件,查询全部记录
        参数:
        queryWrapper - 实体对象封装操作类(可以为 null)
      • selectObjs

        java.util.List<java.lang.Object> selectObjs​(@Param("ew")
                                                    Wrapper<T> queryWrapper)
        根据 Wrapper 条件,查询全部记录

        注意: 只返回第一个字段的值

        参数:
        queryWrapper - 实体对象封装操作类(可以为 null)
      • selectPage

        <P extends IPage<T>> P selectPage​(P page,
                                          @Param("ew")
                                          Wrapper<T> queryWrapper)
        根据 entity 条件,查询全部记录(并翻页)
        参数:
        page - 分页查询条件(可以为 RowBounds.DEFAULT)
        queryWrapper - 实体对象封装操作类(可以为 null)
      • selectMapsPage

        <P extends IPage<java.util.Map<java.lang.String,​java.lang.Object>>> P selectMapsPage​(P page,
                                                                                                   @Param("ew")
                                                                                                   Wrapper<T> queryWrapper)
        根据 Wrapper 条件,查询全部记录(并翻页)
        参数:
        page - 分页查询条件
        queryWrapper - 实体对象封装操作类