分页技术框架（Pager-taglib）学习一（页面分页）

一、Pager-taglib简介
   
1、Pager-taglib，支持多种风格的分页显示。实际上她是一个Jsp标签库，为在JSP上显示分页信息而设计的一套标签，通过这些标签的不同的组合，会形成多种不一样的分页页面，风格各异，她自带的DEMO就有八种左右的分页风格（在pager-taglib-2.0.war包下的WEB-INF\jsp
中），包括Google的分页风格。而需要订制自已的风格的分页页面也非常简单。
   2、分页方式有两种：
    一种是：页面分页，即从Action或者其他控制器中得到一个List，在页面上
通过<pg:item>进行自动分页。适合查询结果不大的情况。
    第二种是：数据库分页，即通过把
pageSize,pageNo两参数传给后台进行数据库分页。 适合大量查询。

  
二、Pager-taglib标签详解

1、<pg:pager>标签（分页时我们重点设置的就是这个标签）：这个标签用来设置分页的总体参数，重要参数说明：

url:分页的链接根地址，pager标签会在这个链接上附加分页参数pager.offset,后台可根据这个参数分页，
也可自行在URL上添加参数。

items:总记录数，pager标签正是根据这个值来计算分页参数的。在页面分页时，此参数可以不写，后台会自动计算出分页参数。如果你写的话将以你写的为准。

maxPageItems:每页显示的行数，也即每页显示的记录数，默认为10。 不写此标签，你会发现分页的条数在小于10的时候显示不出来一些数据。当大于10的时候则会出现重复的记录！
如：maxPageItems = "4"

maxIndexPages:在循环输出页码的时候，最大输出多少个页码（也就是最多显示多少个页码），默认是10.如：maxIndexPages="3"

export：这个属性比较重要，这个属性是让标签给你暴露什么变量，当然这些变量是有选择的，如在Pager标签里，可以暴露出来的变量有
pageOffset及pageNumber，即页码偏移量及页码。通过这两个变量名，可以在Jsp或servlet(或者Action)里面从Request里获得。Export属性接受的值还有表达式，

如currentPage=pageNumber表示，把pageNumber的值暴露出来，并赋给一个叫CurrentPage（自定义的）的变量，这个变量将被保存到Request中，在Jsp或servlet中可以得到。通常设为:export="pageOffset,currentPageNumber=pageNumber".这里使用currentPageNumber=pageNumber的原因是pg：pages（不是page）标签输出用于存放每次循环的页码号的变量也叫pageNumber。

scope：将export暴漏出变量，设置器存储范围。取值为：request、session等。默认保存在request范围内。

isOffset：是否允许页面偏移。取值为true、false。如果为true的话，点击页码分页时，分页中的内容是不会有变化的，并且页码可以一直向后延伸（不论是否已到达你的尾页）；设为false的话会正常分页。默认false。

index：设置索引页的动态显示方式。取值为：center（默认）、forward、half-full。具体效果自己设置查看。

说明：当我们选择不同的页号，会动态的出现其他页号，我们称之为二级分页。适用于查询结果较多，分页页数也比较多的情况，这时我们有必要对分页页号再进行分页显示。此时我们可以通过设置maxIndexPages和index两个属性来实现二级分页。

2、<pg:param>：
   
这个标签很有用，用来设置将要加入到URL的参数,将传入后台。使用Name属性指定即可。
  
3、<pg:item>:
    
表示一页中的一项，pager标签库可根据这个项的个数来计算分页参数（pageOffset），通常放在jstl循环中。

  
4、<pg:index>：
   
这个标签说明分页条显示的内容,它可以包含下面这些标记。

 
5、<pg:first>：
   【第一页的标签】重要参数说明：
export变量的意义：
pageUrl - 分页链接URL地址（最重要的export参数，即框架暴漏出的参数）
pageNumber - 页码
firstItem - 首页第一条记录的索引值
lastItem - 首页最后一条记录的索引值

6、<pg:prev>：
   【上一页标签】重要参数说明：
export变量的意义：
pageUrl - 分页链接URL地址（最重要的export参数，即框架暴漏出的参数）

pageNumber - 页码

   
7、<pg:next>
   
【下一页标签】重要参数说明：
export变量的意义：
pageUrl - 分页链接URL地址（最重要的export参数，即框架暴漏出的参数）

pageNumber - 页码

 
8、<pg:last>重要参数说明：
export变量的意义：
pageUrl - 分页链接URL地址（最重要的export参数，即框架暴漏出的参数）

pageNumber - 页码

9、<pg:pages>【这个标签用来循环输出页码信息】重要参数说明：

export变量的意义：
pageUrl - 分页链接URL地址（最重要的export参数，即框架暴漏出的参数）

pageNumber - 页码
firstItem - pageNumber这个页码指定的那一页的第一行的索引值
lastItem - pageNumber这个页码指定的那一页的最后一行的索引值

 
三、页面分页pager-taglib标签的基本结构
 

 
注意：<pg:index>标签主要是分页导航的风格，我们可以自定义（如下面示例中的两个风格，其实也是改编自war包中八种风格的jsp文件），也可以使用在pager-taglib-2.0.war包下的WEB-INF\jsp
八种风格的jsp文件，即使用静态导入或者动态导入的方式。如
    
<pg:index>
     
<%@ include
file="/WEB-INF/jsp/google.jsp"%>
    
</pg:index>

<pg:index>
    
<jsp:include page="/WEB-INF/jsp/pager_conn.jsp"
flush="true"></jsp:include>

</pg:index>
 
静态导入前提：两页面合并后一定要能正确编译（即合并后一定要有6中的两个jsp页面指令，合并前这两个指令分散在哪个页面无所谓）

动态导入前提：要包含的风格文件能够独立编译（即一定要导入5中的两个jsp页面指令）
 值得注意的是：八种风格的jsp文件必须拷到/WEB-INF/jsp/目录下，并且每个jsp文件中的jsp动作指令标签（如<jsp:useBean
>） 要删除。

呵呵，有了这些，我们分页的重点就是设置pg:pager标签的总体属性啦

  四、Pager-taglib页面分页示例

 
1、导入pager-taglib.jar到类路径下

到官网http://jsptags.com/tags/navigation/pager/index.jsp下载pager-taglib-2.0.war。

在pager-taglib-2.0.war包下的WEB-INF\jsp
中包含了此框架默认的8中分页风格。
   2、新建实体类Book.java
    package
entity;
public class Book
{
    private
String name;
    private
float price;
    public
Book()
    {
   
    // TODO
Auto-generated constructor stub
    }
    public
Book(String name,float price)
    {
   
   
this.setName(name);
   
   
this.setPrice(price);
    }
    public
String getName()
    {
   
    return
name;
    }
    public void
setName(String name)
    {
   
    this.name =
name;
    }
    public float
getPrice()
    {
   
    return
price;
    }
    public void
setPrice(float price)
    {
   
    this.price =
price;
    }
}
 3、新建控制器PagerServlet.java
   public class PagerServlet
extends HttpServlet
{
    public void
doGet(HttpServletRequest request, HttpServletResponse
response)
   
   
    throws
ServletException, IOException
    {

doPost(request, response);
    }
   
    public void
doPost(HttpServletRequest request, HttpServletResponse
response)
   
   
    throws
ServletException, IOException
    {

response.setContentType("text/html; charset=utf-8");
   
    PrintWriter
out = response.getWriter();
   
   
List<Book> books=null;
   
   
if(books==null)
   
    {
   
   
 books = new
ArrayList<Book>();
   
    Book b1 =
new Book("物理1", 15);
   
    Book b2 =
new Book("物理10", 10);
   
    Book b3 =
new Book("物理9", 20);
   
    Book b4 =
new Book("物理8", 30);
   
    Book b5 =
new Book("物理7", 40);
   
    Book b6 =
new Book("物理6", 50);
   
    Book b7 =
new Book("物理5", 60);
   
    Book b8 =
new Book("物理4", 70);
   
    Book b9= new
Book("物理3", 80);
   
    Book b10 =
new Book("物理2", 90);
   
   
books.add(b10);
   
   
books.add(b9);
   
   
books.add(b8);
   
   
books.add(b7);
   
   
books.add(b6);
   
   
books.add(b5);
   
   
books.add(b4);
   
   
books.add(b3);
   
   
books.add(b2);
   
   
books.add(b1);
   
   
request.getSession().setAttribute("books", books);
   
    }
   
   
//页面翻页的普通样式
   
   
request.getRequestDispatcher("/book_list_comm.jsp").forward(request,
response);
   
   
//谷歌样式的页面翻页
   
   
//request.getRequestDispatcher("/book_list_google.jsp").forward(request,
response);
   
   
out.flush();
   
   
out.close();
    }
}
 3、在web.xml中配置PagerServlet.java
  
<servlet>
   
<description>分页控制器</description>

<servlet-name>PagerServlet</servlet-name>

<servlet-class>servlet.PagerServlet</servlet-class>

</servlet>
 
<servlet-mapping>
   
<servlet-name>PagerServlet</servlet-name>

<url-pattern>/PagerServlet</url-pattern>

</servlet-mapping>
4、新建普通风格分页页面（核心部分）book_list_comm.jsp（最重要）
<%@taglib
uri="http://java.sun.com/jsp/jstl/core" prefix="c"
%>
<%@taglib
uri="http://jsptags.com/tags/navigation/pager" prefix="pg"
%>

body元素中添加：
 <pg:pager
url="book_list_comm.jsp" maxPageItems
= "3" maxIndexPages="3"
export="offset,currentPageNumber=pageNumber"
isOffset="false" 
index="half-full" 
>  

<table width="778" border="0"
cellPadding="0" cellSpacing="1"
bgcolor="#6386d6">

<tr
bgcolor="#EFF3F7">

<TD
align="center">书名</TD>

<TD
align="center">价格</TD>

</tr>

<c:if test="${!empty
books}">  
         
<c:forEach items="${books}"
var="book">
         
<pg:item>

<tr
bgcolor="#EFF3F7">

<td align="center">${book.name
}</td>

<td align="center">${book.price
}</td>

</tr> 
           
</pg:item>  

</c:forEach>

</c:if>

<c:if test="${empty
books}">  
        
<tr>

<td colspan="5" align="center"
bgcolor="#EFF3F7">

没有找到相应的记录  
           
</td>

</tr>

</c:if>

</table>

<%-- 定义分页风格：普通风格
--%>

<pg:index>
 
<pg:first>

<a
href="${pageUrl}">首页</a>

</pg:first>

<pg:prev>

<a href="${pageUrl
}">上一页</a>

</pg:prev>

<pg:pages>

<c:choose>
  
   
 
<%--当循环页码是当前页码，则该页码不可以导航，并显示为红色--%>

<c:when test="${currentPageNumber eq
pageNumber}">

<font color="red">[${pageNumber
}]</font>

</c:when>

<%-- 当循环页码不是当前页码，则该页码可以导航 --%>
     
<c:otherwise>

<a href="${pageUrl }">[${pageNumber
}]</a>

</c:otherwise>

</c:choose>

</pg:pages>

<pg:next>

<a href="${pageUrl
}">下一页</a>

</pg:next>

<pg:last>

<a href="${pageUrl
}">尾页</a>

</pg:last>
 
</pg:index>

</pg:pager>  

 
5、新建谷歌风格的分页界面（核心部分）：book_list_google.jsp（最重要）
<%@taglib
uri="http://java.sun.com/jsp/jstl/core" prefix="c"
%>
<%@taglib
uri="http://jsptags.com/tags/navigation/pager" prefix="pg"
%>

<pg:pager url="book_list_google.jsp" 
index="half-full" export="currentPageNumber=pageNumber"
maxPageItems="3" maxIndexPages="3">

<table width="778" border="0" cellPadding="0"
cellSpacing="1"
bgcolor="#6386d6">

<tr
bgcolor="#EFF3F7">

<TD
align="center">书名</TD>

<TD
align="center">价格</TD>

</tr>

<c:if test="${!empty
books}">  
         
<c:forEach items="${books}"
var="book">
         
<pg:item>

<tr
bgcolor="#EFF3F7">

<td align="center">${book.name
}</td>

<td align="center">${book.price
}</td>

</tr> 
           
</pg:item> 

</c:forEach>

</c:if>

<c:if test="${empty
books}">  
        
<tr>

<td colspan="5" align="center"
bgcolor="#EFF3F7">

没有找到相应的记录  
           
</td>

</tr>

</c:if>

</table>

<%--定义风衣风格：谷歌风格
--%>
    
 <%-- 
使用静态导入谷歌风格 （如不理解，请参考标题三）
            
<pg:index>
       
   
 <%@ include
file="/WEB-INF/jsp/google.jsp"%>
            
</pg:index>
        
--%> 

<pg:index>
     
<center>
     
<table border=0 cellpadding=0 width=10%
cellspacing=0>
     
<tr align=center valign=top>
     
<td
valign=bottom><font
face=arial,sans-serif 
       
size=-1>Result Page:
</font></td>

<pg:prev ifnull="true">
       
<% if (pageUrl != null) { %>
         
<td align=right><A
HREF="<%= pageUrl
%>"><IMG
           
SRC=http://www.google.com/nav_previous.gif alt=""
border=0><br>
         
<b>Previous</b></A></td>

<% } else { %>
         
<td><IMG
SRC=http://www.google.com/nav_first.gif alt=""
border=0></td>
       
<% } %>
     
</pg:prev>
     
<pg:pages>
       
<% if (pageNumber == currentPageNumber) {
%>
         
<td><IMG
SRC=http://www.google.com/nav_current.gif
alt=""><br>
         
<font
color=#A90A08><%= pageNumber
%></font></td>

<% } else { %>
         
<td><A
HREF="<%= pageUrl
%>"><IMG
           
SRC=http://www.google.com/nav_page.gif alt=""
border=0><br>
         
<%= pageNumber
%></A></td>

<% } %>
     
</pg:pages>
     
<pg:next ifnull="true">
       
<% if (pageUrl != null) { %>
         
<td><A
HREF="<%= pageUrl
%>"><IMG
           
SRC=http://www.google.com/nav_next.gif alt=""
border=0><br>
         
<b>Next</b></A></td>

<% } else { %>
         
<td><IMG
SRC=http://www.google.com/nav_last.gif alt=""
border=0></td>
       
<% } %>
     
</pg:next>
     
</tr>
     
</table>
     
</center>
   
</pg:index>
  
</pg:pager>
在浏览器中输入：http://localhost:8888/Pager-taglib/PagerServlet

可以看到两种分页风格的的分页：
普通风格：

谷歌风格：