目前最好的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 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();

void pageFirst() throws 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接口中新增的方法才需要自己的寫方法處理。

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”);

……//繼續處理

}

總結

　　一個好的基礎類應該是便于使用，并且具備足夠的可移植性，同時要保證其功能的完善。在上面的實作中，我們從java.sql.ResultSet接口繼承出Pageable，并實作了它。這就保證了在使用中與JDBC原有操作的一緻性，同時對原有功能沒有縮減。

　　同時它也是易于使用的，因為封裝了一切必要的操作，是以在你的代碼中唯一顯得"難看"和"不舒服"的地方就是需要自己去構造一個PageableResultSet2。不過隻要你願意，這也是可以解決的。

　　當然它也有具有充分的可移植性，當你将資料庫由Oracle變為Mysql或者SQLServer的時候，你仍然可以使用這些分頁的代碼。它在使用中（或者說在移植的過程中）唯一的限制就是你必須要使用一個支援JDBC2的驅動（現在明白為什麼我把類命名為PageableResultSet2了吧。:P），不過，好在JDBC2已經成為标準了，絕大多數的資料庫（如Oracle, Mysql, SQLServer）都有自己的或者第三方提供的JDBC2的驅動。

　　OK，這個分頁的實作是否對你的程式設計有幫助呢？仔細看看，其實真正自己寫的代碼并不多的，大部分都隻是簡單的轉發操作。一個合适的模式應用可以幫你很大忙