一、service層
【添加數據:(增)】
default boolean save(T entity); // 調用 BaseMapper 的 insert 方法,用於添加一條數據。
boolean saveBatch(Collection<T> entityList, int batchSize); // 批量插入數據
注:
entityList 表示實體對象集合
batchSize 表示一次批量插入的數據量,默認為 1000
【添加或修改數據:(增或改)】
boolean saveOrUpdate(T entity); // id 若存在,則修改, id 不存在則新增數據
default boolean saveOrUpdate(T entity, Wrapper<T> updateWrapper); // 先根據條件嘗試更新,然后再執行 saveOrUpdate 操作
boolean saveOrUpdateBatch(Collection<T> entityList, int batchSize); // 批量插入並修改數據
【刪除數據:(刪)】
default boolean removeById(Serializable id); // 調用 BaseMapper 的 deleteById 方法,根據 id 刪除數據。
default boolean removeByMap(Map<String, Object> columnMap); // 調用 BaseMapper 的 deleteByMap 方法,根據 map 定義字段的條件刪除
default boolean remove(Wrapper<T> queryWrapper); // 調用 BaseMapper 的 delete 方法,根據實體類定義的 條件刪除對象。
default boolean removeByIds(Collection<? extends Serializable> idList); // 用 BaseMapper 的 deleteBatchIds 方法, 進行批量刪除。
【修改數據:(改)】
default boolean updateById(T entity); // 調用 BaseMapper 的 updateById 方法,根據 ID 選擇修改。
default boolean update(T entity, Wrapper<T> updateWrapper); // 調用 BaseMapper 的 update 方法,根據 updateWrapper 條件修改實體對象。
boolean updateBatchById(Collection<T> entityList, int batchSize); // 批量更新數據
【查找數據:(查)】
default T getById(Serializable id); // 調用 BaseMapper 的 selectById 方法,根據 主鍵 ID 返回數據。
default List<T> listByIds(Collection<? extends Serializable> idList); // 調用 BaseMapper 的 selectBatchIds 方法,批量查詢數據。
default List<T> listByMap(Map<String, Object> columnMap); // 調用 BaseMapper 的 selectByMap 方法,根據表字段條件查詢
default T getOne(Wrapper<T> queryWrapper); // 返回一條記錄(實體類保存)。
Map<String, Object> getMap(Wrapper<T> queryWrapper); // 返回一條記錄(map 保存)。
default int count(Wrapper<T> queryWrapper); // 根據條件返回 記錄數。
default List<T> list(); // 返回所有數據。
default List<T> list(Wrapper<T> queryWrapper); // 調用 BaseMapper 的 selectList 方法,查詢所有記錄(返回 entity 集合)。
default List<Map<String, Object>> listMaps(Wrapper<T> queryWrapper); // 調用 BaseMapper 的 selectMaps 方法,查詢所有記錄(返回 map 集合)。
default List<Object> listObjs(); // 返回全部記錄,但只返回第一個字段的值。
default <E extends IPage<T>> E page(E page, Wrapper<T> queryWrapper); // 調用 BaseMapper 的 selectPage 方法,分頁查詢
default <E extends IPage<Map<String, Object>>> E pageMaps(E page, Wrapper<T> queryWrapper); // 調用 BaseMapper 的 selectMapsPage 方法,分頁查詢
注:
get 用於返回一條記錄。
list 用於返回多條記錄。
count 用於返回記錄總數。
page 用於分頁查詢。
【鏈式調用:】
default QueryChainWrapper<T> query(); // 普通鏈式查詢
default LambdaQueryChainWrapper<T> lambdaQuery(); // 支持 Lambda 表達式的修改
default UpdateChainWrapper<T> update(); // 普通鏈式修改
default LambdaUpdateChainWrapper<T> lambdaUpdate(); // 支持 Lambda 表達式的修改
注:
query 表示查詢
update 表示修改
Lambda 表示內部支持 Lambda 寫法。
形如:
query().eq("column", value).one();
lambdaQuery().eq(Entity::getId, value).list();
update().eq("column", value).remove();
lambdaUpdate().eq(Entity::getId, value).update(entity);
二、dao層
【添加數據:(增)】
int insert(T entity); // 插入一條記錄
注:
T 表示任意實體類型
entity 表示實體對象
【刪除數據:(刪)】
int deleteById(Serializable id); // 根據主鍵 ID 刪除
int deleteByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap); // 根據 map 定義字段的條件刪除
int delete(@Param(Constants.WRAPPER) Wrapper<T> wrapper); // 根據實體類定義的 條件刪除對象
int deleteBatchIds(@Param(Constants.COLLECTION) Collection<? extends Serializable> idList); // 進行批量刪除
注:
id 表示 主鍵 ID
columnMap 表示表字段的 map 對象
wrapper 表示實體對象封裝操作類,可以為 null。
idList 表示 主鍵 ID 集合(列表、數組),不能為 null 或 empty
【修改數據:(改)】
int updateById(@Param(Constants.ENTITY) T entity); // 根據 ID 修改實體對象。
int update(@Param(Constants.ENTITY) T entity, @Param(Constants.WRAPPER) Wrapper<T> updateWrapper); // 根據 updateWrapper 條件修改實體對象
注:
update 中的 entity 為 set 條件,可以為 null。
updateWrapper 表示實體對象封裝操作類(可以為 null,里面的 entity 用於生成 where 語句)
【查詢數據:(查)】
T selectById(Serializable id); // 根據 主鍵 ID 查詢數據
List<T> selectBatchIds(@Param(Constants.COLLECTION) Collection<? extends Serializable> idList); // 進行批量查詢
List<T> selectByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap); // 根據表字段條件查詢
T selectOne(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper); // 根據實體類封裝對象 查詢一條記錄
Integer selectCount(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper); // 查詢記錄的總條數
List<T> selectList(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper); // 查詢所有記錄(返回 entity 集合)
List<Map<String, Object>> selectMaps(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper); // 查詢所有記錄(返回 map 集合)
List<Object> selectObjs(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper); // 查詢所有記錄(但只保存第一個字段的值)
<E extends IPage<T>> E selectPage(E page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper); // 查詢所有記錄(返回 entity 集合),分頁
<E extends IPage<Map<String, Object>>> E selectMapsPage(E page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper); // 查詢所有記錄(返回 map 集合),分頁
注:
queryWrapper 表示實體對象封裝操作類(可以為 null)
page 表示分頁查詢條件