谁用过这个？能用吗？教教我！

nuanshuidai 2003-08-19 12:47:18

在以列表的形式显示数据时需要对页面进行翻页控制，基本在项目的各模块中都会用到。为了最大限度地实现翻页的可重用和易移植，利用组件的形式对翻页逻辑进行封装。
翻页控制器的分析

描述：

翻页控制器用来实现对WEB页面的翻页内容的显示和翻页的各种操作的控制。通过JSP调用，将分页内容显示到WEB页面。它支持多种方式和风格的显示。

翻页控制器的设计

下面分别创建翻页控制器的一个PageConfig类、一个Page类、一个PageView类。

· PageConfig.java

类

类 PageConfig
声明 public class
描述这个类用来保存页面属性的值,如每页显示几行等。
超类
执行

属性描述

属性属性描述定义
[PageConfig]
|--PAGE_SIZE 页大小 public static final int
|--PAGE_SIZE_SMALL 小型页面的大小 public static final int
|--PAGE_SIZE_NORMAL 正常页面的大小 public static final int
|--PAGE_SIZE_BIG 大型页面的大小 public static final int
|--PAGE_SIZE_BIGGER 较大页面的大小 public static final int
|--PAGE_SIZE_BIGGEST 最大页面的大小 public static final int

· Page.java

类

类 Page
声明 public class
描述这个类用来保存页面属性的值,如每页显示几行等。
超类
执行 java.lang.Serializable

属性描述

属性名称属性描述数据类型
|--EMPTY_PAGE 空白页面描述一个空白页面，即不含内容的页面。 Page对象
|--objects 结果集列表结果集列表 java.util.List或java.util.Vector
|--start 开始记录号开始记录号，从0开始正整数和0
|--end 结束记录号结束记录号正整数和0
|--viewStart 显示在页面开始记录号显示在页面开始记录号，从1开始正整数
|--viewEnd 显示在页面结束记录号显示在页面结束记录号正整数
|--hasPrevious 是否有上一页的开关是否有上一页的开关布尔值
|--previousPageNumber 上一页的页码上一页的页码正整数和0
|--hasNext 是否有下一页的开关是否有下一页的开关布尔值
|--nextPageNumber 下一页的页码下一页的页码正整数和0
|--total 总行数一共有多少行记录正整数和0
|--totalPage 总页数一共有多少页
|--currentPageNumber 当前页描述当前是第几页正整数和0
|--pageSize 页大小描述每页有多少行正整数和0

构造器

构造器构造器描述参数
[Page]
|--Page(List l, int s, boolean hasNext) 创建页面 l 结果集s 开始记录号，从0开始hasNext 是否有下一页的开关
|--Page(List l, int s, boolean hasNext, int total) 创建页面 l 结果集s 开始记录号，从0开始hasNext 是否有下一页的开关total 一共有多少行记录
|--Page(List l, int s, int size, boolean hasNext, int total) 创建页面 l 结果集s 开始记录号，从0开始size 每页有多少行hasNext 是否有下一页的开关total 一共有多少行记录
|-- Page(List l, int num, int size, int total) 创建页面 l 结果集num 当前是第几页size 每页有多少行total 一共有多少行记录
|-- Page(List l) 创建页面,不进行分页 l 结果集

方法

方法方法描述返回值
[Page]
|--autoCalculate () 自动计算，根据当前页、页大小、总行数计算出其它属性的值 private void
|--getList() 获得结果集 public List
|--getViewStart() 获得显示在页面的开始记录号，从1开始 public int
|--getViewEnd() 获得显示在页面的结束记录号 public int
|--hasNextPage() 是否有下一页 public boolean
|--hasPreviousPage () 是否有上一页 public boolean
|--getPreviousPageNumber () 获得上一页的页码 public int
|--getNextPageNumber () 获得下一页的页码 public int
|--getTotal () 获得结果集中记录总行数 public int
|--getTotalPage () 获得总页数 public int
|--getCurrentPageNumber () 获得当前页码 public int
|--getPageSize () 获得每页多少行记录 public int
|--getStartOfNextPage () 获得下一页在结果集中开始的记录号，从0开始 public int
|--getStartOfPreviousPage () 获得上一页在结果集中开始的记录号，从0开始 public int
|--getSize() 获得当前页包括的记录行数 public int
|--isEmpty() 判断当前页面是否是空白页面,如果当前页面是空白页面,返回true,否则,返回false public boolean

PageView.java

类

类 PageView
声明 public class
描述通过JSP调用，将分页内容显示到WEB页面。不支持图片、按钮等，只支持文字。用法:在JSP页面按如下形式定义:<% PageView view = new PageView(request,out,page); %>按缺省形式显示<% view.setVisible(true); %>按指定形式显示<% view.setVisible(true,0,1); %>
超类
执行

属性描述

属性名称属性描述数据类型
[PageView]
|--currentUrl 当前页面的URL 当前页面的URL 字符串
|--style 风格风格字符串
|--useSquareBrackets 是否加[]的开关在"上一页"两边是否加上"["和"]" 布尔值
|--page WEB页面 WEB页面 Page对象

构造器

构造器构造器描述参数
[PageView]
|-- PageView (HttpServletRequest request,JspWriter out,Page page)) 创建一个分页内容 request 客户端请求out 页面输出对象page WEB页面

方法

方法方法描述返回值
[PageView]
|--setVisible(boolean visible) 按缺省形式显示分页内容,如果visible为true,则显示分页内容,否则,不显示分页内容 public void
|--setVisible(boolean visible,int style,int order) 按指定形式显示分页内容,如果visible为true,则显示分页内容,否则,不显示分页内容 public void
|--setVisible(boolean visible,boolean useSquareBrackets,int style,int order) 按指定形式显示分页内容,如果visible为true,则显示分页内容,否则,不显示分页内容 public void
|--viewPage(boolean useSquareBrackets,int style,int order) 按指定形式显示分页内容,order为0,表示完整形式,按如下顺序显示:共计:18 分页:2 当前页:1 每页:10 首页前页后页尾页转到□□□□order为1,表示简洁形式,按如下顺序显示:前页后页尾页 1/2order为2,表示完整形式2,按如下顺序显示:共计:18 每页:10 转到□□□□ 首页前页后页尾页 1/2 public void

翻页控制器的编码

只需按翻页控制器的设计进行编码，这里不用再讲了。

翻页控制器组件的源代码

a)PageConfig.java

b)Page.java

c)PageView.java

源代码：立即下载

翻页控制器的调用

翻页控制器的调用实在太简单了，调用方法：

· 导入翻页控制器包

<%@ page import="java.util.List,com.cwap.oa.controller.web.page.Page,
com.cwap.oa.controller.web.page.PageView"%>

· 创建一个Page对象，Page.EMPTY_PAGE为空白页面

Page page = Page.EMPTY_PAGE;

· 创建一个PageView对象

<% PageView view = new PageView(request,out,page); %>

· 显示分页的内容：

按缺省形式显示

<% view.setVisible(true); %>

按指定形式显示

<% view.setVisible(true,0,1); %>

· 调用翻页控制器的例子

下面是在论坛板块中的一个JSP中调用的示例，用来显示所有的论坛板块列表，下面只列出部分代码：

<%@ page language="java"%>
<%@ page contentType="text/html; charset=GBK"%>
<%@ page import="java.util.List,
com.cwap.oa.controller.web.page.PageView,com.cwap.oa.controller.web.page.Page"%>
<jsp:useBean id="forumBoardHelper" scope="page"
class="com.club8090.forum.forumboard.client.ForumBoardClientHelper"/>
<%
String tmp=request.getParameter("pageNumber");
int pageNumber = 0;
if(tmp==null || tmp.equals("")){
pageNumber = 1;
}else{
try {
pageNumber = Integer.parseInt(tmp);
}catch(java.lang.NullPointerException npe){
pageNumber = 1;
}catch(java.lang.NumberFormatException nfe){
pageNumber = 1;
}
}
Page page = Page.EMPTY_PAGE;//page初始化为Page.EMPTY_PAGE空白页面
page = forumBoardHelper.getAllForumBoards(pageNumber);
%>
…
<table>
<tr>
<td>NO.</td>
<td>名称</td>
<td>描述摘要</td>
</tr>
<%
List items = page.getList();
if( items.isEmpty() ) {
out.println("<tr colspan=3>没有记录存在</tr>");
}else{
int no;//页面中显示的行数
for (int i = 0; i < items.size(); i++) {
ForumBoardModel forumBoardModel = (ForumBoardModel)items.get(i);
no = page.getViewStart() + i;
%>
//显示记录列表
<tr>
<td><%= no %></td>
<td><%= forumBoardModel.getName() %></td>
<td><%= forumBoardModel.getSummary() %></td>
</tr>
<%
}
PageView view = new PageView(request,out,page);
view.setVisible(true,0,1);
}
%>
</table>
…

...全文