public interface UserService extends IService<User> {}

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {}

// 插入一條記錄（選擇字段，策略插入）
boolean save(T entity);

// 插入（批量）
boolean saveBatch(Collection<T> entityList);

// 插入（批量，限制數(shù)量）
boolean saveBatch(Collection<T> entityList, int batchSize);

// TableId 注解存在更新記錄，否則插入一條記錄
boolean saveOrUpdate(T entity);

// 根據(jù) updateWrapper 嘗試更新，否則繼續(xù)執(zhí)行 saveOrUpdate(T) 方法
boolean saveOrUpdate(T entity, Wrapper<T> updateWrapper);

// 批量修改插入
boolean saveOrUpdateBatch(Collection<T> entityList);

// 批量修改插入
boolean saveOrUpdateBatch(Collection<T> entityList, int batchSize);

// 根據(jù) entity 條件，刪除記錄
boolean remove(Wrapper<T> queryWrapper);

// 根據(jù) ID 刪除
boolean removeById(Serializable id);

// 根據(jù) columnMap 條件，刪除記錄
boolean removeByMap(Map<String, Object> columnMap);

// 刪除（根據(jù)ID 批量刪除）
boolean removeByIds(Collection<? extends Serializable> idList);

// 根據(jù) UpdateWrapper 條件更新記錄，需要設置sqlset
boolean update(Wrapper<T> updateWrapper);

// 根據(jù) whereWrapper 條件，更新記錄
boolean update(T updateEntity, Wrapper<T> whereWrapper);

// 根據(jù) ID 選擇修改
boolean updateById(T entity);

// 根據(jù)ID 批量更新
boolean updateBatchById(Collection<T> entityList);

// 根據(jù)ID 批量更新
boolean updateBatchById(Collection<T> entityList, int batchSize);

// 根據(jù) ID 查詢
T getById(Serializable id);

// 根據(jù) Wrapper，查詢一條記錄。結果集如果是多個會拋出異常，隨機取一條加上限制條件 wrapper.last("LIMIT 1")
T getOne(Wrapper<T> queryWrapper);

// 根據(jù) Wrapper，查詢一條記錄，這個是方法返回結果不止一條則會拋出異常，如果想默認取第一條結果，可以給這方法傳第二個參數(shù)為false。
T getOne(Wrapper<T> queryWrapper, boolean throwEx);

// 根據(jù) Wrapper，查詢一條記錄
Map<String, Object> getMap(Wrapper<T> queryWrapper);

// 根據(jù) Wrapper，查詢一條記錄
// mapper：轉換函數(shù)，用于將查詢結果中的每個對象轉換為指定的對象類型。
<V> V getObj(Wrapper<T> queryWrapper, Function<? super Object, V> mapper);

// 查詢所有
List<T> list();

// 查詢列表
List<T> list(Wrapper<T> queryWrapper);

// 查詢（根據(jù) ID 批量查詢）
Collection<T> listByIds(Collection<? extends Serializable> idList);

// 查詢（根據(jù) columnMap 條件）
Collection<T> listByMap(Map<String, Object> columnMap);

// 查詢所有列表
List<Map<String, Object>> listMaps();

// 查詢列表
List<Map<String, Object>> listMaps(Wrapper<T> queryWrapper);

// 查詢全部記錄
List<Object> listObjs();

// 查詢全部記錄
<V> List<V> listObjs(Function<? super Object, V> mapper);

// 根據(jù) Wrapper 條件，查詢全部記錄
List<Object> listObjs(Wrapper<T> queryWrapper);

// 根據(jù) Wrapper 條件，查詢全部記錄
// mapper：轉換函數(shù)，用于將查詢結果中的每個對象轉換為指定的對象類型。
<V> List<V> listObjs(Wrapper<T> queryWrapper, Function<? super Object, V> mapper);

// 查詢總記錄數(shù)
int count();

// 根據(jù) Wrapper 條件，查詢總記錄數(shù)
int count(Wrapper<T> queryWrapper);

// 無條件分頁查詢
IPage<T> page(IPage<T> page);

// 條件分頁查詢
IPage<T> page(IPage<T> page, Wrapper<T> queryWrapper);

// 無條件分頁查詢
IPage<Map<String, Object>> pageMaps(IPage<T> page);

// 條件分頁查詢
IPage<Map<String, Object>> pageMaps(IPage<T> page, Wrapper<T> queryWrapper);

public class Page<T> implements IPage<T> {
    private static final long serialVersionUID = 8545996863226528798L;
    protected List<T> records;
    protected long total;
    protected long size;
    protected long current;
    protected List<OrderItem> orders;
    protected boolean optimizeCountSql;
    protected boolean searchCount;
    protected boolean optimizeJoinOfCountSql;
    protected String countId;
    protected Long maxLimit;
/* 以下省略 */
}

@SpringBootTest
public class ProductMapperTest {
    // 自動注入 productMapper 接口對應的實現(xiàn)類對象
    @Autowired
    private ProductMapper productMapper;
    @Test
    public void testPageQuery(){
        // 創(chuàng)建分頁查詢相關參數(shù) page，泛型為 Product，表示查詢到的結果對應的實體類為Product
        Page<Product> page = new Page<>();
        // 設置分頁查詢顯示第二頁的數(shù)據(jù)，實際開發(fā)過程中該參數(shù)有前端傳遞
        page.setCurrent(2);
        // 設置分頁查詢每頁顯示四條數(shù)據(jù)，實際開發(fā)過程中該參數(shù)有前端傳遞
        page.setSize(4);
        // 創(chuàng)建排序字段集合，不想排序不加即可，實際開發(fā)過程中一般都會要求按照時間降序排序
        List<OrderItem> orders = new ArrayList<>();
        // 按照價格排序，排序方式為降序，ASC為True表示升序，false表示降序，第一個參數(shù)表示數(shù)據(jù)庫中的列名
        orders.add(new OrderItem("price",false));
        // 按照生產時間排序，排序方式為降序
        orders.add(new OrderItem("production_date",false));
        // 將排序對象集合加入分頁查詢對象Page中
        page.setOrders(orders);
        // 執(zhí)行分頁查詢，可以創(chuàng)建一個Page對象接受查詢結果，
        // 也可以用查詢條件參數(shù)page，但其實最后結果都是同一個
        page = productMapper.selectPage(page, null);
        // 可以新創(chuàng)建一個Page對象，就像下面這樣
        Page<Product> productPage = productMapper.selectPage(page,null);
        // 輸出分頁查詢結果顯示當前的哪一頁
        System.out.println(page.getCurrent());
        // 輸出分頁查詢結果的總數(shù)據(jù)條數(shù)
        System.out.println(page.getTotal());
        // 輸出分頁查詢結果的數(shù)據(jù)集合
        System.out.println(page.getRecords());
        // 輸出分頁查詢結果的每頁顯示條數(shù)
        System.out.println(page.getSize());
        // 判斷剛才分頁查詢的兩個結果對象是否為同一個
        System.out.println(page == productPage);
        // 輸出第一個分頁查詢對象內存地址
        System.out.println(page);
        // 輸出第二個分頁查詢對象內存地址
        System.out.println(productPage);
    }
}

// 鏈式查詢 普通
QueryChainWrapper<T> query();

// 鏈式查詢 lambda 式。注意：不支持 Kotlin
LambdaQueryChainWrapper<T> lambdaQuery();

// 示例：
// eq 指定條件
query().eq("column", value).one();
lambdaQuery().eq(Entity::getId, value).list();

// 鏈式更改 普通
UpdateChainWrapper<T> update();

// 鏈式更改 lambda 式。注意：不支持 Kotlin
LambdaUpdateChainWrapper<T> lambdaUpdate();

// 示例：
// eq 指定條件
update().eq("column", value).remove();
lambdaUpdate().eq(Entity::getId, value).update(entity);