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 條件更新記錄，需要設(shè)置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，查詢一條記錄。結(jié)果集如果是多個(gè)會(huì)拋出異常，隨機(jī)取一條加上限制條件 wrapper.last("LIMIT 1")
T getOne(Wrapper<T> queryWrapper);

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

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

// 根據(jù) Wrapper，查詢一條記錄
// mapper：轉(zhuǎn)換函數(shù)，用于將查詢結(jié)果中的每個(gè)對(duì)象轉(zhuǎn)換為指定的對(duì)象類型。
<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);

// 查詢?nèi)坑涗?
List<Object> listObjs();

// 查詢?nèi)坑涗?
<V> List<V> listObjs(Function<? super Object, V> mapper);

// 根據(jù) Wrapper 條件，查詢?nèi)坑涗?
List<Object> listObjs(Wrapper<T> queryWrapper);

// 根據(jù) Wrapper 條件，查詢?nèi)坑涗?
// mapper：轉(zhuǎn)換函數(shù)，用于將查詢結(jié)果中的每個(gè)對(duì)象轉(zhuǎn)換為指定的對(duì)象類型。
<V> List<V> listObjs(Wrapper<T> queryWrapper, Function<? super Object, V> mapper);

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

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

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

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

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

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