首页 > 代码库 > 眼下最好的JSP分页技术
眼下最好的JSP分页技术
前言
在使用数据库的过程中，不可避免的须要使用到分页的功能，但是JDBC的规范对此却没有非常好的解决。对于这个需求非常多朋友都有自己的解决方式，比方使用 Vector等集合类先保存取出的数据再分页。但这样的方法的可用性非常差，与JDBC本身的接口全然不同，对不同类型的字段的支持也不好。这里提供了一种与 JDBC兼容性非常好的方案。
JDBC和分页
Sun的JDBC规范的制定，有时非常让人哭笑不得，在JDBC1.0中，对于一 个结果集（ResultSet）你甚至仅仅能运行next()操作，而无法让其向后滚动，这就直接导致在仅仅运行一次SQL查询的情况下无法获得结果集的大 小。所以，假设你使用的是JDBC1.0的驱动，那么是差点儿无法实现分页的。
好在Sun的JDBC2规范中非常好的弥补了这一个不足，添加?了结果集的前后滚动操作，尽管仍然不能直接支持分页，但我们已经能够在这个基础上写出自己的可支持分页的ResultSet了。
和详细数据库相关的实现方法
有一些数据库，如Mysql, Oracle等有自己的分页方法，比方Mysql能够使用limit子句，Oracle能够使用ROWNUM来限制结果集的大小和起始位置。这里以Mysql为例，其典型代码例如以下：
// 计算总的记录条数
String SQL = "SELECT Count(*) AS total " + this.QueryPart;
rs = db.executeQuery(SQL);
if (rs.next())
Total = rs.getInt(1);
// 设置当前页数和总页数
TPages = (int)Math.ceil((double)this.Total/this.MaxLine);
CPages = (int)Math.floor((double)Offset/this.MaxLine+1);
// 依据条件推断，取出所需记录
if (Total > 0) {
SQL = Query + " LIMIT " + Offset + " , " + MaxLine;
rs = db.executeQuery(SQL);
}
return rs;
}
毫无疑问，这段代码在数据库是Mysql时将会是美丽的，可是作为一个通用的类（其实我后面要提供的就是一个通用类库中的一部分），须要适应不同的数据库，而基于这个类（库）的应用，也可能使用不同的数据库，所以，我们将不使用这样的方法。
还有一种繁琐的实现方法
我看过一些人的做法（其实包含我在内，一開始也是使用这样的方法的），即不使用不论什么封装，在须要分页的地方，直接操作ResultSet滚到对应的位置，再读取对应数量的记录。其典型代码例如以下：
<%
sqlStmt = sqlCon.createStatement(java.sql.ResultSet.TYPE_SCROLL_INSENSITIVE,
java.sql.ResultSet.CONCUR_READ_ONLY);
strSQL = "select name,age from test";
//运行SQL语句并获取结果集
sqlRst = sqlStmt.executeQuery(strSQL);
//获取记录总数
sqlRst.last();
intRowCount = sqlRst.getRow();
//记算总页数
intPageCount = (intRowCount+intPageSize-1) / intPageSize;
//调整待显示的页码
if(intPage>intPageCount) intPage = intPageCount;
%>
<table border="1" cellspacing="0" cellpadding="0">
<tr>
<th>姓名</th>
<th>年龄</th>
</tr>
<%
if(intPageCount>0){
//将记录指针定位到待显示页的第一条记录上
sqlRst.absolute((intPage-1) * intPageSize + 1);
//显示数据
i = 0;
while(i<intPageSize && !sqlRst.isAfterLast()){
%>
<tr>
<td><%=sqlRst.getString(1)%></td>
<td><%=sqlRst.getString(2)%></td>
</tr>
<%
sqlRst.next();
i++;
}
}
%>
</table>
非常显然，这样的方法没有考虑到代码重用的问题，不仅代码数量巨大，并且在代码须要改动的情况下，将会无所适从。
使用Vector进行分页
还见过还有一些实现分页的类，是先将全部记录都select出来，然后将ResultSet中的数据 都get出来，存入Vector等集合类中，再依据所需分页的大小，页数，定位到对应的位置，读取数据。或者先使用前面提到的两种分页方法，取得所需的页 面之后，再存入Vector中。
扔开代码的效率不说，单是从程序结构和使用的方便性上讲，就是非常糟糕的。比方，这样的做法支持的字段类型有限，int, double, String类型还比較优点理，假设碰到Blob, Text等类型，实现起来就非常麻烦了。这是一种更不可取的方案。
一个新的Pageable接口及其实现
非常显然，看过上面三种实现方法后，我们对新的分页机制有了一个目标，即：不与详细数据库相关；尽可能做到代码重用；尽可能与原JDBC接口的用法保持一致；尽可能高的效率。
首先，我们须要提供一个与java.sql.ResultSet向下兼容的接口，把它命名为Pageable，接口定义例如以下：
public interface Pageable extends java.sql.ResultSet{
/**返回总页数
*/
int getPageCount();
/**返回当前页的记录条数
*/
int getPageRowsCount();
/**返回分页大小
*/
int getPageSize();
/**转到指定页
*/
void gotoPage(int page) ;
/**设置分页大小
*/
void setPageSize(int pageSize);
/**返回总记录行数
*/
int getRowsCount();
/**
* 转到当前页的第一条记录
* @exception java.sql.SQLException 异常说明。
*/
void pageFirst() throws java.sql.SQLException;
/**
* 转到当前页的最后一条记录
* @exception java.sql.SQLException 异常说明。
*/
void pageLast() throws java.sql.SQLException;
/**返回当前页号
*/
int getCurPage();
}
这是一个对java.sql.ResultSet进行了扩展的接口，主要是添加?了对分页的支持，如设置分页大小，跳转到某一页，返回总页数等等。
接着，我们须要实现这个接口，因为这个接口继承自ResultSet，而且它的大部分功能也都和ResultSet原有功能同样，所以这里使用了一个简单的Decorator模式。
PageableResultSet2的类声明和成员声明例如以下：
public class PageableResultSet2 implements Pageable {
protected java.sql.ResultSet rs=null;
protected int rowsCount;
protected int pageSize;
protected int curPage;
protected String command = "";
}
能够看到，在PageableResultSet2中，包括了一个ResultSet的实例（这个实例仅仅是实现了ResultSet接口，其实它是由各个数据库厂商分别实现的），而且把全部由ResultSet继承来的方法都直接转发给该实例来处理。
PageableResultSet2中继承自ResultSet的主要方法：
//……
public boolean next() throws SQLException {
return rs.next();
}
//……
public String getString(String columnName) throws SQLException {
try {
return rs.getString(columnName);
}
catch (SQLException e) {//这里是为了添加?一些出错信息的内容便于调试
throw new SQLException (e.toString()+" columnName="
+columnName+" SQL="+this.getCommand());
}
}
//……
仅仅有在Pageable接口中新增的方法才须要自己的写方法处理。
/**方法凝视可參考Pageable.java
*/
public int getCurPage() {
return curPage;
}
public int getPageCount() {
if(rowsCount==0) return 0;
if(pageSize==0) return 1;
//calculate PageCount
double tmpD=(double)rowsCount/pageSize;
int tmpI=(int)tmpD;
if(tmpD>tmpI) tmpI++;
return tmpI;
}
public int getPageRowsCount() {
if(pageSize==0) return rowsCount;
if(getRowsCount()==0) return 0;
if(curPage!=getPageCount()) return pageSize;
return rowsCount-(getPageCount()-1)*pageSize;
}
public int getPageSize() {
return pageSize;
}
public int getRowsCount() {
return rowsCount;
}
public void gotoPage(int page) {
if (rs == null)
return;
if (page < 1)
page = 1;
if (page > getPageCount())
page = getPageCount();
int row = (page - 1) * pageSize + 1;
try {
rs.absolute(row);
curPage = page;
}
catch (java.sql.SQLException e) {
}
}
public void pageFirst() throws java.sql.SQLException {
int row=(curPage-1)*pageSize+1;
rs.absolute(row);
}
public void pageLast() throws java.sql.SQLException {
int row=(curPage-1)*pageSize+getPageRowsCount();
rs.absolute(row);
}
public void setPageSize(int pageSize) {
if(pageSize>=0){
this.pageSize=pageSize;
curPage=1;
}
}
PageableResultSet2的构造方法：
public PageableResultSet2(java.sql.ResultSet rs) throws java.sql.SQLException {
if(rs==null) throw new SQLException("given ResultSet is NULL","user");
rs.last();
rowsCount=rs.getRow();
rs.beforeFirst();
this.rs=rs;
}
这里仅仅是简单的取得一个总记录数，并将记录游标移回初始位置（before first），同一时候将參数中的ResultSet赋给成员变量。
Pageable的用法
由于Pageable接口继承自ResultSet，所以在用法上与ResultSet一致，尤其是在不须要分页功能的时候，能够直接当成ResultSet使用。而在须要分页时，仅仅须要简单的setPageSize, gotoPage，就可以。
PreparedStatement pstmt=null;
Pageable rs=null;
……//构造SQL，并准备一个pstmt.
rs=new PageableResultSet2(pstmt.executeQuery());//构造一个Pageable
rs.setPageSize(20);//每页20个记录
rs.gotoPage(2);//跳转到第2页
for(int i=0; i<rs.getPageRowsCount(); i++){//循环处理
int id=rs.getInt(“ID”);
……//继续处理
rs.next();
}
总结
一个好的基础类应该是便于使用，而且具备足够的可移植性，同一时候要保证其功能的完好。在上面的实现中，我们从java.sql.ResultSet接口继承出Pageable，并实现了它。这就保证了在使用中与JDBC原有操作的一致性，同一时候对原有功能没有缩减。
同一时候它也是易于使用的，由于封装了一切必要的操作，所以在你的代码中唯一显得"难看"和"不舒服"的地方就是需要自己去构造一个PageableResultSet2。只是仅仅要你愿意，这也是能够解决的。
当然它也有具有充分的可移植性，当你将数据库由Oracle变为Mysql或者SQLServer的时候，你仍然能够使用这些分页的代码。它在使用中 （或者说在移植的过程中）唯一的限制就是你必需要使用一个支持JDBC2的驱动（如今明确为什么我把类命名为PageableResultSet2了 吧。:P），只是，好在JDBC2已经成为标准了，绝大多数的数据库（如Oracle, Mysql, SQLServer）都有自己的或者第三方提供的JDBC2的驱动。
OK，这个分页的实现是否对你的编程有帮助呢？细致看看，事实上真正自己写的代码并不多的，大部分都仅仅是简单的转发操作。一个合适的模式应用能够帮你非常大忙。