分页标签库Pager

分页标签库Pager

N.1 简介

使用Pagers标签库可以实现分页功能。

开发者主页

N.2 用法

JSP中动态生成表格的代码一般如下所示：

< table >
<% ...
for(int i = 0; i < 行数; i++)
{
%>
< tr >
< td > 内容 </ td >
</ tr >
<% ...
}
%>
</ table >

在本章中我使用pg作为Pager标签库的前缀。

如果要使用Pager标签库进行分页处理的话，需要使用<pg:pager>标签将<table>包括在内，然后在内部使用一系列的Pager标签表示上一页、下一页等控制按钮。常用的控制标签如下表所示：

下面是一个例子，源代码如下所示：

<%...
Vector<String[]> v = (Vector<String[]>)request.getAttribute("table_list");
int maxPageItems = 25;
String url = "/INtools/Db/ListTable.action";
int item_count = v.size();
int page_count = item_count % maxPageItems == 0 ? item_count / maxPageItems : item_count / maxPageItems + 1;
%>
<form id="form1" name="form1" method="post" action="">
<pg:pager
items="<%= item_count %>"
url="<%= url %>"
index="center"
maxPageItems="<%= maxPageItems %>"
maxIndexPages="10"
isOffset="true"
export="offset,currentPageNumber=pageNumber"
scope="request">
<table border="1" cellspacing="0" cellpadding="3" bordercolordark="#ffffff"
bordercolorlight="#000066" width='100%' bgcolor="#76a6c7">
<tr class="table_desc">
<td colspan="3">后台表集合</td>
</tr>
<tr class="table_title">
<td width="33%">表名</td>
<td width="33%">所属模块</td>
<td width="34%">操作</td>
</tr>
<%...
for(int iRow = offset.intValue(), l = Math.min(iRow + maxPageItems, v.size()); iRow < l; iRow++)
{
String[] row_data = v.get(iRow);
String table_name = row_data[0];
String module_name = row_data[1];
String table_id = row_data[2];
String bgcolor = iRow % 2 == 0 ? "#f4fbff" : "#FFFFDD";
%>
<pg:item>
<tr bgcolor="<%=bgcolor%>" class="table_data">
<td align="left"><%=table_name%></td>
<td align="left"><%=module_name%></td>
<td align="center">
<input type="button" value="修改" />&nbsp;
<input type="button" value="删除" />
</td>
</tr>
</pg:item>
<%...
}
%>
<tr class="table_page_break">
<td colspan="3">
记录数: <%= item_count %>&nbsp;
页数：<%= page_count %>&nbsp;
<pg:first export="firstPageUrl=pageUrl" unless="current">
<a href="<%= firstPageUrl %>">|&lt;</a>
</pg:first>
<pg:skip export="skipBackPageUrl=pageUrl" pages="<%= -10 %>">
<a href="<%= skipBackPageUrl %>">&lt;&lt;&lt;</a>
</pg:skip>
<pg:prev export="prevPageUrl=pageUrl">
<a href="<%= prevPageUrl %>">&lt;&lt;</a>
</pg:prev>
<pg:pages><%...
if (pageNumber == currentPageNumber) {
%> <b><%= pageNumber %></b> <%...
} else {
%> <a href="<%= pageUrl %>"><%= pageNumber %></a> <%...
}
%></pg:pages>
<pg:next export="nextPageUrl=pageUrl">
<a href="<%= nextPageUrl %>">&gt;&gt;</a>
</pg:next>
<pg:skip export="skipForwardPageUrl=pageUrl" pages="<%= 10 %>">
<a href="<%= skipForwardPageUrl %>">&gt;&gt;&gt;</a>
</pg:skip>
<pg:last export="lastPageUrl=pageUrl" unless="current">
<a href="<%= lastPageUrl %>">&gt;|</a>
</pg:last>
<input type="text" size="4" name="page_no" id="page_no" />
<input type="button" value="go" onclick="goto_page_no()" />
</td>
</tr>
<tr class="table_button_row">
<td colspan="3">
<input type="button" value="确定" class="form_button" />
</td>
</tr>
</table>
</pg:pager>
</form>
<script type="text/javascript">...

function goto_page_no()
...{
var em_page_no = document.all["page_no"];
var page_no = parseInt(em_page_no.value);
var offset = <%= maxPageItems %> * (page_no - 1);
document.location.href = "<%= url %>?pager.offset=" + offset;
}

</script>

分页效果如下图所示：

获取数据

该段代码用于获取显示的页面数据，在此做了如下设定，取得的显示数据的格式为Vector<String[]>，每页显示25行记录，获取页数据时需要重新执行查询，其处理操作为/INtools/Db/ListTable.action，这里我使用了struts框架，这表示一个servlet处理类，也可以是一个JSP文件。并进行了页数计算。

pager标签

• items：表示记录数
• url：表示获取数据时的处理程序
• index：页码的显示方式，可以为center、forward、half-full
• maxPageItems：每页显示的记录数
• maxIndexPages：显示的页码数
• isOffset；
• export：将pager标签支持的变量导出，

N.3 技巧

如果要实现如下功能：

• 指定跳转到某页
• 生成分页内容时需要参数TableName

可写入如下代码：

< form id ="form1" name ="form1" method ="get" action ="..." >
...
< pg:param name ="TableName" value ="<%= search_table_name %>" />
< input type ="hidden" name ="TableName" id ="TableName" value ="<%= search_table_name %>" />
< input type ="hidden" name ="pager.offset" />
< input type ="button" value ="go" onclick ="goto_page_no()" />
...
</ form >

< script type ="text/javascript" > ...

function goto_page_no()
...{
var offset = 记录偏移值;
var frm = document.form1;
frm.elements["pager.offset"].value = offset;
frm.submit();
}

</ script >

其中<pg:param>是用于点击页码翻页时提供查询参数，如果打开生成后的源代码，会发现所有的翻页标记(<a>)都加了一个参数TableName，而<input type="hidden" name="TableName" />则用于指定跳转页时提供查询参数，<input type="hidden" name="pager.offset" />则用于提供指定跳转页时的记录偏移量，其名称格式为“[pager].[pg:pager标签的export属性中的offset表示法]”。

值得注意的是，此处的<form>需要使用“get”方式，如果使用“post”方式，使用跳转按钮提交的“TableName”参数会翻倍，例如，第一次为“a”，第二次则为“a,a”。