Mybatis分页插件PageHelper简单使用

Mybatis分页插件PageHelper简单使用

一个好的讲解mybatis的博客地址http://www.jianshu.com/nb/5226994

引言

对于使用Mybatis时，最头痛的就是写分页，需要先写一个查询count的select语句，然后再写一个真正分页查询的语句，当查询条件多了之后，会发现真不想花双倍的时间写count和select，

如下就是项目在没有使用分页插件的时候的语句

<!-- 根据查询条件获取查询获得的数据量 -->
    <select id="size" parameterType="Map" resultType="Long">
        select count(*) from help_assist_student
        <where>
            <if test="stuId != null and stuId != ''">
                AND stu_id like
                CONCAT(CONCAT('%',
                #{stuId,jdbcType=VARCHAR}),'%')
            </if>
            <if test="name != null and name != ''">
                AND name like
                CONCAT(CONCAT('%',
                #{name,jdbcType=VARCHAR}),'%')
            </if>
            <if test="deptId != null">
                AND dept_id in
                <foreach item="item" index="index" collection="deptId" open="("
                    separator="," close=")">
                    #{item}
                </foreach>
            </if>
            <if test="bankName != null">
                AND bank_name in
                <foreach item="item" index="index" collection="bankName"
                    open="(" separator="," close=")">
                    #{item}
                </foreach>
            </if>
        </where>
    </select>
    <!-- 分页查询获取获取信息 -->
    <select id="selectByPageAndSelections" parameterType="cn.edu.uestc.smgt.common.QueryBase"
        resultMap="BaseResultMap">
        select * from help_assist_student
        <where>
            <if test="parameters.stuId != null and parameters.stuId != ''">
                AND stu_id like
                CONCAT(CONCAT('%',
                #{parameters.stuId,jdbcType=VARCHAR}),'%')
            </if>
            <if test="parameters.name != null and parameters.name != ''">
                AND name like
                CONCAT(CONCAT('%',
                #{parameters.name,jdbcType=VARCHAR}),'%')
            </if>
            <if test="parameters.deptId != null">
                AND dept_id in
                <foreach item="item" index="index" collection="parameters.deptId"
                    open="(" separator="," close=")">
                    #{item}
                </foreach>
            </if>
            <if test="parameters.bankName != null">
                AND bank_name in
                <foreach item="item" index="index" collection="parameters.bankName"
                    open="(" separator="," close=")">
                    #{item}
                </foreach>
            </if>
        </where>
        order by dept_id,stu_id
        limit #{firstRow},#{pageSize}
    </select>

可以发现，重复的代码太多，虽然说复制粘贴简单的很，但是文件的长度在成倍的增加，以后翻阅代码的时候头都能大了。

于是希望只写一个select语句，count由插件根据select语句自动完成。找啊找啊，发现PageHelperhttps://github.com/pagehelper/Mybatis-PageHelper 符合要求,于是就简单的写了一个测试项目

1，配置分页插件：

直接从官网上copy的如下：

Config PageHelper

1. Using in mybatis-config.xml

<!–
In the configuration file,
plugins location must meet the requirements as the following order:
properties?, settings?,
typeAliases?, typeHandlers?,
objectFactory?,objectWrapperFactory?,
plugins?,
environments?, databaseIdProvider?, mappers?
–>
<plugins>
<plugin interceptor=“com.github.pagehelper.PageInterceptor”>
<!– config params as the following –>
<property name=“param1” value=“value1”/>
</plugin>
</plugins>
2. Using in Spring application.xml

config org.mybatis.spring.SqlSessionFactoryBean as following:

<bean id=“sqlSessionFactory” class=“org.mybatis.spring.SqlSessionFactoryBean”>
<!– other configuration –>
<property name=“plugins”>
<array>
<bean class=“com.github.pagehelper.PageInterceptor”>
<property name=“properties”>
<!– config params as the following –>
<value>
param1=value1
</value>
</property>
</bean>
</array>
</property>
</bean>

我使用第一中方法：

<!-- 配置分页插件 -->
    <plugins>
        <plugin interceptor="com.github.pagehelper.PageInterceptor">
            <!-- 设置数据库类型 Oracle,Mysql,MariaDB,SQLite,Hsqldb,PostgreSQL六种数据库-->
            <property name="helperDialect" value="mysql"/>
        </plugin>
    </plugins>

其余的关于mybatis整合spring的内容就不用提了。

2，编写mapper.xml文件

测试工程就不复杂了，简单的查询一个表，没有条件

<select id="selectByPageAndSelections" resultMap="BaseResultMap">
        SELECT *
        FROM doc
        ORDER BY doc_abstract
    </select>

然后在Mapper.java中编写对应的接口

public List<Doc> selectByPageAndSelections();

3，分页

@Service
public class DocServiceImpl implements IDocService {
    @Autowired
    private DocMapper docMapper;
@Override
</span><span style="color: #0000ff">public</span> PageInfo&lt;Doc&gt; selectDocByPage1(<span style="color: #0000ff">int</span> currentPage, <span style="color: #0000ff">int</span><span style="color: #000000"> pageSize) {
    PageHelper.startPage(currentPage, pageSize);
    List</span>&lt;Doc&gt; docs =<span style="color: #000000"> docMapper.selectByPageAndSelections();
    PageInfo</span>&lt;Doc&gt; pageInfo = <span style="color: #0000ff">new</span> PageInfo&lt;&gt;<span style="color: #000000">(docs);
    </span><span style="color: #0000ff">return</span><span style="color: #000000"> pageInfo;
}

}

参考文档说明，我使用了PageHelper.startPage(currentPage, pageSize);

我认为这种方式不入侵mapper代码。

其实一开始看到这段代码时候，我觉得应该是内存分页。其实插件对mybatis执行流程进行了增强，添加了limit以及count查询，属于物理分页

再粘贴一下文档说明中的一段话

4. 什么时候会导致不安全的分页？

PageHelper 方法使用了静态的 ThreadLocal 参数，分页参数和线程是绑定的。

只要你可以保证在 PageHelper 方法调用后紧跟 MyBatis 查询方法，这就是安全的。因为 PageHelper 在 finally 代码段中自动清除了 ThreadLocal 存储的对象。

如果代码在进入 Executor 前发生异常，就会导致线程不可用，这属于人为的 Bug（例如接口方法和 XML 中的不匹配，导致找不到 MappedStatement 时）， 这种情况由于线程不可用，也不会导致 ThreadLocal 参数被错误的使用。

但是如果你写出下面这样的代码，就是不安全的用法：

PageHelper.startPage(1, 10);
List<Country> list;
if(param1 != null){
list = countryMapper.selectIf(param1);
} else {
list = new ArrayList<Country>();
}
这种情况下由于 param1 存在 null 的情况，就会导致 PageHelper 生产了一个分页参数，但是没有被消费，这个参数就会一直保留在这个线程上。当这个线程再次被使用时，就可能导致不该分页的方法去消费这个分页参数，这就产生了莫名其妙的分页。

上面这个代码，应该写成下面这个样子：

List<Country> list;
if(param1 != null){
PageHelper.startPage(1, 10);
list = countryMapper.selectIf(param1);
} else {
list = new ArrayList<Country>();
}
这种写法就能保证安全。

如果你对此不放心，你可以手动清理 ThreadLocal 存储的分页参数，可以像下面这样使用：

List<Country> list;
if(param1 != null){
PageHelper.startPage(1, 10);
try{
list = countryMapper.selectAll();
} finally {
PageHelper.clearPage();
}
} else {
list = new ArrayList<Country>();
}
这么写很不好看，而且没有必要。

 

4，结果

controller层中简单的调用然后返回json字符串如下：可以看出，结果基于doc_abstract排序后返回1-10条的数据

结语

 尽量不要重复造轮子。

 

分类: SpringMVC+Spring+Mybaits

好文要顶 关注我 收藏该文

博学善思。。ljd
关注 - 17
粉丝 - 20

+加关注

8

0

« 上一篇： leetcode 98,判断二叉树为BST
» 下一篇： IDEA SQL dialect detection和Duplicated Code检测关闭

	</div>
	<div class="postDesc">posted @ <span id="post-date">2017-04-17 21:48</span> <a href="https://www.cnblogs.com/ljdblog/">博学善思。。ljd</a> 阅读(<span id="post_view_count">102718</span>) 评论(<span id="post_comment_count">4</span>)  <a href="https://i.cnblogs.com/EditPosts.aspx?postid=6725094" rel="nofollow">编辑</a> <a href="#" onclick="AddToWz(6725094);return false;">收藏</a></div>
</div>
<script type="text/javascript">var allowComments=true,cb_blogId=297215,cb_entryId=6725094,cb_blogApp=currentBlogApp,cb_blogUserGuid='2625f29e-2656-e611-9fc1-ac853d9f53cc',cb_entryCreatedDate='2017/4/17 21:48:00';loadViewCount(cb_entryId);var cb_postType=1;</script>