java分页的实现，插件PageHelper的使用及原理

java分页的实现，插件PageHelper的使用及原理
https://blog.csdn.net/qq_25498677/article/details/69675664

如果你只希望知道PageHelper的用法，直接去github查看官网文档 Mybatis-PageHelper.

 

1.关于分页。

在web项目中，分页是一个常见的功能。在我刚学完javaweb的时候在没有用任何框架的情况下做过分页，代码非常的冗余、难看，后台每个POJO类的增删改查里都需要写：（pageSize为每页大小，pageNum为查询的页数）

 

getList(int pageSize,int pageNum); 
getTotal();

 

而前端也要写多个jsp，一个分页就对应了一个jsp。导致不管是前后台，代码都大量重复，实在是太不优雅了。

 

2.PageHelper的优缺点。

PageHelper做的是什么呢？它封装了分页的后台部分，说得更简单点，就是你不需要每个POJO类的增删改查里都包括那两个方法了，它帮你做了。你只需要有一个selectAll的方法，它会根据你使用的数据库来将你selectAll的sql改装成一个分页查询的sql，并顺带生成一个查询总数的sql。

如图，对应不同的数据库有不同的方言，如常见的Mysql，分页关键字是limit，它就是这样组装你的sql。

 

@Override
    public String getPageSql(String sql, Page page, CacheKey pageKey) {
        StringBuilder sqlBuilder = new StringBuilder(sql.length() + 14);
        sqlBuilder.append(sql);
        if (page.getStartRow() == 0) {
            sqlBuilder.append(" LIMIT ");
            sqlBuilder.append(page.getPageSize());
        } else {
            sqlBuilder.append(" LIMIT ");
            sqlBuilder.append(page.getStartRow());
            sqlBuilder.append(",");
            sqlBuilder.append(page.getPageSize());
            pageKey.update(page.getStartRow());
        }
        pageKey.update(page.getPageSize());
        return sqlBuilder.toString();
    }

 

 

 

PageHelper不仅帮你分页查询了数据，在返回时直接返回Page对象，里更是封装了许多分页信息。但是在前后台json数据交互时，由于Page对象继承自ArrayList，json不会保留其分页信息，所以在使用时往往是这样使用的：

 

@Override
	public PageInfo<TopicPost> selectAllPublicTopicPost(int pageNum) {
		int pageSize = 10;
		PageInfo<TopicPost> topicPostList = new PageInfo<TopicPost>();//主题帖表
		try {
			PageHelper.startPage(pageNum, pageSize);
			topicPostList =  ((Page<TopicPost>)topicPostDao.daoSelectAllPublicTopicPost()).toPageInfo();
		} catch (Exception e) {
			log.error("查询状态正常的主题帖失败！"+e.toString());
			e.printStackTrace();
		}
		return topicPostList;
	}

即将查询出来的Page转为PageInfo(没有继承ArrayList),将你的PageInfo<Object>返回给前台就可以了。

 

 

至此，我们可以看到PageHelper的优缺点。

优点：封装分页sql，使我们不需要每个地方都去写分页的查询语句；同时，使我们select的sql语句向下兼容，换了数据库也不需要更改sql代码；

缺点：自带的Page对象转json时会丢失分页数据；而转为PageInfo对象时分页信息过多（这一点作者已在github上说明，建议自己实现PageInfo）

 

3.前端的实现。

在拿到后台传来的数据后，前端要做的要不少。考虑一个这样的分页： 

<<  <  1  2  3  4  5  >  >>   难点在中间的五个数字，通常情况下PageNum（当前你浏览的页数）在中间，每当翻页时五个数字都会发生变化，但如果总页数较小或者PageNum较小时则不一定发生变动，同时还需要注意总页数小于5的问题。

<< 为到第一页

<   为上一页

 firstNum 通常为PageNum - 2

 secondNum 通常为PageNum - 1

 thirdNum 通常为PageNum

 fourthNum 通常为PageNum + 1

 fifthNum 通常为PageNum + 2

>   为下一页

>>为最后一页

直接看代码：

 

//查看所有状态正常的主题帖
function selectAllPublicTopicPost(pageNum){
	var url = "/guestbook/rs/topicpost/selectallpublictopicpost"; 
	var json = JSON.stringify(pageNum);
	$.ajax({
	    url:url,
	    type:'POST',
	    async:true,
	    data: json,
	    contentType:"application/json",
	    dataType:'json',
	    success:function(data,textStatus,jqXHR){
	    	var firstNum = pageNum - 2;
	    	var secondNum = pageNum -1;
	    	var thirdNum = pageNum;
	    	var fourthNum = pageNum + 1;
	    	var fifthNum = pageNum + 2;
	    	var prePage = pageNum - 1;
	    	var nextPage = pageNum + 1;
	    	
	    	if(pageNum < 4 || data.pages < 6){
	    		firstNum = 1;
		    	secondNum = 2;
		    	thirdNum = 3;
		    	fourthNum = 4;
		    	fifthNum = 5;
	    	}
	    	else if(pageNum > data.pages-2){
	    		firstNum = data.pages-4;
		    	secondNum = data.pages-3;
		    	thirdNum = data.pages-2;
		    	fourthNum = data.pages-1;
		    	fifthNum = data.pages;
	    	}
	    	if(data.isFirstPage){
	    		prePage = 1;
	    	}
	    	if(data.isLastPage ){
	    		nextPage = data.pages;
	    	}
	    	var index_page = "<li><a onclick='selectAllPublicTopicPost(1)' aria-label='Previous'><span aria-hidden='true'><<</span></a></li>"
		    			  	+"<li><a onclick='selectAllPublicTopicPost("+prePage+")' aria-label='Previous'><span aria-hidden='true'><</span></a></li>"
		    			  	+"<li><a onclick='selectAllPublicTopicPost("+firstNum+")'>"+firstNum+"</a></li>";
		    			  	if(secondNum <= data.pages){
		    			  		index_page = index_page + "<li><a onclick='selectAllPublicTopicPost("+secondNum+")'>"+secondNum+"</a></li>";
		    			  	}
		    			  	if(thirdNum <= data.pages){
		    			  		index_page = index_page + "<li><a onclick='selectAllPublicTopicPost("+thirdNum+")'>"+thirdNum+"</a></li>";
		    			  	}
		    			  	if(fourthNum <= data.pages){
		    			  		index_page = index_page + "<li><a onclick='selectAllPublicTopicPost("+fourthNum+")'>"+fourthNum+"</a></li>";
		    			  	}
		    			  	if(fifthNum <= data.pages){
		    			  		index_page = index_page + "<li><a onclick='selectAllPublicTopicPost("+fifthNum+")'>"+fifthNum+"</a></li>";
		    			  	}
		    			  	index_page = index_page +"<li><a onclick='selectAllPublicTopicPost("+nextPage+")' aria-label='Next'><span aria-hidden='true'>></span></a></li>"
		    			  	+"<li><a onclick='selectAllPublicTopicPost("+data.pages+")' aria-label='Next'><span aria-hidden='true'>>></span></a></li>";
	    	$("#index_page").html(index_page);
	    	//以下内容不重要
	    	var tp = "";
	        jQuery.each( data.list,function(i,item){
	        	tp = tp + "<div class='col-lg-4'><a href='/guestbook/contents.html?topicPostId="
	             	+item.id
	                +"' target='_blank'>"
	                +item.title
	                +"</a></div><div class='col-lg-2'>"
	                +item.keyword
	                +"</div><div class='col-lg-2'>"
	                +vagueTime(new Date(item.time).toLocaleString())
	                +"</div><div class='col-lg-2'><a href='/guestbook/cust_info.html?uid=" 
	                +item.userId
	                +"' target='_blank'>"
	                +item.userName
	                +"</a></div><div class='col-lg-1'>"
	                +item.replyNumber
	                +"<br/><br/></div>";
            });
	        $("#topic_list").html(tp);       
	    }
	})
}

这样就是一个完整的分页的前后台实现，但前端依然是每一个分页都要去写这么一大段代码，还有改善空间。

 

 

4.综合解决方案。

后台：采用PageHelper查询出来的Page转为PageInfo，如果需求的查询功能比较简单或者对性能要求高，自己照着PageInfo实现一个MyPageInfo，其中只要自己需要的属性、方法即可。

前端：写一个page.js提供一个getPageArr的方法，对传来的做PageNum做处理，返回一个数组，即firstNum至fifthNum，当然，要注意数据库不到5页的返回哦。这样的话前端也避免了冗余代码。