<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>5.3.2</version> <!-- 使用最新版本 -->
</dependency>

<plugins>
    <plugin interceptor="com.github.pagehelper.PageInterceptor">
        <!-- 配置方言，默認(rèn)會自動檢測 -->
        <property name="helperDialect" value="mysql"/>
        <!-- 分頁合理化，頁碼<=0時查詢第一頁，>=最大頁時查詢最后一頁 -->
        <property name="reasonable" value="true"/>
        <!-- 支持通過Mapper接口參數(shù)來傳遞分頁參數(shù) -->
        <property name="supportMethodsArguments" value="true"/>
        <!-- 總是返回PageInfo類型,默認(rèn)檢查到Page參數(shù)不再處理 -->
        <property name="returnPageInfo" value="check"/>
    </plugin>
</plugins>

# PageHelper配置
pagehelper.helper-dialect=mysql
pagehelper.reasonable=true
pagehelper.support-methods-arguments=true
pagehelper.params=count=countSql

// 設(shè)置分頁參數(shù)，查詢第1頁，每頁10條
PageHelper.startPage(1, 10);
// 緊跟著的第一個select方法會被分頁
List<User> users = userMapper.selectAll();
// 用PageInfo對結(jié)果進(jìn)行包裝
PageInfo<User> pageInfo = new PageInfo<>(users);

// 當(dāng)前頁
pageInfo.getPageNum();
// 每頁的數(shù)量
pageInfo.getPageSize();
// 當(dāng)前頁的數(shù)量
pageInfo.getSize();
// 總記錄數(shù)
pageInfo.getTotal();
// 總頁數(shù)
pageInfo.getPages();
// 結(jié)果集
pageInfo.getList();
// 是否為第一頁
pageInfo.isIsFirstPage();
// 是否為最后一頁
pageInfo.isIsLastPage();

// 接口方法
List<User> selectByPage(@Param("name") String name, 
                       @Param("pageNum") int pageNum,
                       @Param("pageSize") int pageSize);

// 調(diào)用方式
userMapper.selectByPage("張三", 1, 10);

RowBounds rowBounds = new RowBounds(0, 10);
List<User> users = userMapper.selectByRowBounds(null, rowBounds);

<select id="selectUserWithRole" resultMap="userWithRoleMap">
    select u.*, r.role_name from user u left join role r on u.role_id = r.id
</select>

<!-- 自定義count查詢 -->
<select id="selectUserWithRole_COUNT" resultType="long">
    select count(1) from user u
</select>

// 確保調(diào)用模式正確
PageHelper.startPage(1, 10);
List<User> list = userMapper.selectAll();

// 錯誤的排序方式
PageHelper.startPage(1, 10);
PageHelper.orderBy("id desc"); // 這行不會生效

// 正確的排序方式
PageHelper.startPage(1, 10, "id desc");

@Bean
@ConfigurationProperties(prefix = "pagehelper")
public Properties pageHelperProperties() {
    return new Properties();
}

@Bean(name = "pageHelperInterceptor")
public PageInterceptor pageHelperInterceptor() {
    PageInterceptor pageInterceptor = new PageInterceptor();
    pageInterceptor.setProperties(pageHelperProperties());
    return pageInterceptor;
}

// 為每個SqlSessionFactory添加插件
@Bean
public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
    SqlSessionFactoryBean factory = new SqlSessionFactoryBean();
    factory.setDataSource(dataSource);
    // 添加其他配置...
    factory.setPlugins(new Interceptor[]{pageHelperInterceptor()});
    return factory.getObject();
}