前言 EM_`` 0^
在使用数据库的过程中,不可避免的需要使用到分页的功能,可是JDBC的规范对此却没有很好的解决。对于这个需求很多朋友都有自己的解决方案,比如使用Vector等集合类先保存取出的数据再分页。但这种方法的可用性很差,与JDBC本身的接口完全不同,对不同类型的字段的支持也不好。这里提供了一种与JDBC兼容性非常好的方案。 YpFh_Zr[
JDBC和分页 4XkSj9D~z
Sun的JDBC规范的制定,有时很让人哭笑不得,在JDBC1.0中,对于一个结果集(ResultSet)你甚至只能执行next()操作,而无法让其向后滚动,这就直接导致在只执行一次SQL查询的情况下无法获得结果集的大小。所以,如果你使用的是JDBC1.0的驱动,那么是几乎无法实现分页的。 IC-k
好在Sun的JDBC2规范中很好的弥补了这一个不足,增加了结果集的前后滚动操作,虽然仍然不能直接支持分页,但我们已经可以在这个基础上写出自己的可支持分页的ResultSet了。 {r9fKA
W_zv"c
WQ\H2go
49o5"M(
和具体数据库相关的实现方法 Kn]c4h}@b5
有一些数据库,如Mysql, Oracle等有自己的分页方法,比如Mysql可以使用limit子句,Oracle可以使用ROWNUM来限制结果集的大小和起始位置。这里以Mysql为例,其典型代码如下: -U6" Ce
// 计算总的记录条数 DA[s k7
String SQL = SELECT Count(*) AS total + this.QueryPart; ?i.]|#{Z
rs = db.executeQuery(SQL); 'RIlyH~Yf
if (rs.next()) DU6AlNx
Total = rs.getInt(1); !aSu;Ln
// 设置当前页数和总页数 ub|tX 'o
TPages = (int)Math.ceil((double)this.Total/this.MaxLine); MZt~
Abt
CPages = (int)Math.floor((double)Offset/this.MaxLine+1); wIW]uo/=
// 根据条件判断,取出所需记录 E(i<3U"4h[
if (Total > 0) { N'L3Oa\%
SQL = Query + LIMIT + Offset + , + MaxLine; K-$gTV
rs = db.executeQuery(SQL); l\=M'D
} \9T;-]
return rs; g-c\;
} HvWnPh1l
毫无疑问,这段代码在数据库是Mysql时将会是漂亮的,但是作为一个通用的类(事实上我后面要提供的就是一个通用类库中的一部分),需要适应不同的数据库,而基于这个类(库)的应用,也可能使用不同的数据库,所以,我们将不使用这种方法。 Ns6Vf5T.
83*"58
qg;[~JZYKi
另一种繁琐的实现方法 */B-%*#I.
我看过一些人的做法(事实上包括我在内,一开始也是使用这种方法的),即不使用任何封装,在需要分页的地方,直接操作ResultSet滚到相应的位置,再读取相应数量的记录。其典型代码如下: 8^3Z]=(Q
<% Qrt[MJ+#
sqlStmt = sqlCon.createStatement(java.sql.ResultSet.TYPE_SCROLL_INSENSITIVE, +L4_]
java.sql.ResultSet.CONCUR_READ_ONLY); i,=CnZCh
strSQL = select name,age from test; b|i94y(
//执行SQL语句并获取结果集 zOR
sqlRst = sqlStmt.executeQuery(strSQL); <r*A(}Y
//获取记录总数 33O@jbs@
sqlRst.last(); [.}-n AN
intRowCount = sqlRst.getRow(); gxpGi@5
//记算总页数 D0?l$]aE
intPageCount = (intRowCount+intPageSize-1) / intPageSize; 7`^]:t
//调整待显示的页码 'F'v/G~F
if(intPage>intPageCount) intPage = intPageCount; ';buS -|6
%> s=lkK/ [
<table border=1 cellspacing=0 cellpadding=0> $]/a/!d
<tr> Z3K~C_0Cnu
<th>姓名</th> lFT_J?G$'
<th>年龄</th> +zpmy3Q
</tr> 9/LI[{
<% ,|4%YaN.3
if(intPageCount>0){ 1mw<$'pm0
//将记录指针定位到待显示页的第一条记录上 ~=5 vc''
sqlRst.absolute((intPage-1) * intPageSize + 1); ~F`t[p
//显示数据 J4
yT|
i = 0; v)(tB7&`=
while(i<intPageSize && !sqlRst.isAfterLast()){ >$]SYF29
%> f#:7$:{F1
<tr> g;U f?
<td><%=sqlRst.getString(1)%></td> L0{ehpvM
<td><%=sqlRst.getString(2)%></td> B]K@'#
</tr> }e/P|7&
<% ;C8'7
sqlRst.next(); *)c,~R^
i++; g->cgExj
} P=K+!3ZXo
} A*ImruV
%> .!kqIx*3
</table> |okS7.|IX
很显然,这种方法没有考虑到代码重用的问题,不仅代码数量巨大,而且在代码需要修改的情况下,将会无所适从。 ,c:Fa)-
pA9:1*+;;
#`6A}/@.+
使用Vector进行分页 h<oQ9zW)
还见过另一些实现分页的类,是先将所有记录都select出来,然后将ResultSet中的数据都get出来,存入Vector等集合类中,再根据所需分页的大小,页数,定位到相应的位置,读取数据。或者先使用前面提到的两种分页方法,取得所需的页面之后,再存入Vector中。 o6^^hc\
扔开代码的效率不说,单是从程序结构和使用的方便性上讲,就是很糟糕的。比如,这种做法支持的字段类型有限,int, double, String类型还比较好处理,如果碰到Blob, Text等类型,实现起来就很麻烦了。这是一种更不可取的方案。 "M*Pt
N{@kgc
^Bihm] Aq
一个新的Pageable接口及其实现 `F:PWG`
很显然,看过上面三种实现方法后,我们对新的分页机制有了一个目标,即:不与具体数据库相关;尽可能做到代码重用;尽可能与原JDBC接口的使用方法保持一致;尽可能高的效率。 G`NH~C
首先,我们需要提供一个与java.sql.ResultSet向下兼容的接口,把它命名为Pageable,接口定义如下: }SHF
public interface Pageable extends java.sql.ResultSet{ ET4 C/nb
/**返回总页数 YcS}ug7
*/ 8H_3.MK
int getPageCount(); Qc2_B\K^
/**返回当前页的记录条数 LEMgRI`rf
*/ P%5h!Z2m
int getPageRowsCount(); p1p4t40<l
/**返回分页大小 ;ti{
#(Ux
*/ WY%LeC!t
int getPageSize(); .$>?2|gRv
/**转到指定页 gP*:>[lR
*/ aTC7 H]e
void gotoPage(int page) ; 6=]%Y
/**设置分页大小 !7SZZz
*/ MT" 2^&R
void setPageSize(int pageSize); {9KG06%+
/**返回总记录行数 e.eQZ5n~q`
*/ iulM8"P
int getRowsCount(); TL(L[
/** B[^mWVp6L
* 转到当前页的第一条记录 O&93QN0
* @exception java.sql.SQLException 异常说明。 T`46\KkN
*/ Zg%SE'kK
void pageFirst() throws java.sql.SQLException; IEV3(qzt
/** @RKw1$BA
* 转到当前页的最后一条记录 IMzhEm
* @exception java.sql.SQLException 异常说明。 .Ev i
*/ F|X-|Co
void pageLast() throws java.sql.SQLException; XA{tVh
/**返回当前页号 hQrO8T?2
*/ K"1xtpy
int getCurPage(); 5EDM?G
} :0pxacD"!
这是一个对java.sql.ResultSet进行了扩展的接口,主要是增加了对分页的支持,如设置分页大小,跳转到某一页,返回总页数等等。 Y3jb'S4(
接着,我们需要实现这个接口,由于这个接口继承自ResultSet,并且它的大部分功能也都和ResultSet原有功能相同,所以这里使用了一个简单的Decorator模式。 DUiqt09`~
PageableResultSet2的类声明和成员声明如下: fL4F
~@`9l
public class PageableResultSet2 implements Pageable { =8 d`qS"
protected java.sql.ResultSet rs=null; ):C4"2l3
protected int rowsCount; {{M?+]p,^
protected int pageSize; A(#hyb#
protected int curPage; .H+`]qLkL
protected String command = ; 6/9 A' !4C
} aX6.XHWbDf
可以看到,在PageableResultSet2中,包含了一个ResultSet的实例(这个实例只是实现了ResultSet接口,事实上它是由各个数据库厂商分别实现的),并且把所有由ResultSet继承来的方法都直接转发给该实例来处理。 NL))!Pi
PageableResultSet2中继承自ResultSet的主要方法: &;7\/m*W1
//…… C(C4R+U
public boolean next() throws SQLException { z%t>z9hU
return rs.next(); +u*WUw!%
} bU1UNm`{C
//…… kEWC
public String getString(String columnName) throws SQLException { xmZ]mu,,$
try { D!TL~3d
1
return rs.getString(columnName); s]0x^"#B
} c]O3pcU
catch (SQLException e) {//这里是为了增加一些出错信息的内容便于调试 Y;S+2])R2
throw new SQLException (e.toString()+ columnName= PL<q|y
+columnName+ SQL=+this.getCommand()); *nD yB.(
} f+Nq?GvwBQ
} CDei+ q
//…… iUqL /
只有在Pageable接口中新增的方法才需要自己的写方法处理。 >:5/V0;,
/**方法注释可参考Pageable.java !<}<HR^)
*/ N. 3
x[%:
public int getCurPage() { z (r Q6
return curPage; nm66U4.@
} }NDw3{zn
public int getPageCount() { |_ HH[s*U
if(rowsCount==0) return 0; lKEdpF<
if(pageSize==0) return 1; 98bmia&H
//calculate PageCount v#:#w.]-Y
double tmpD=(double)rowsCount/pageSize; YSk,kU
int tmpI=(int)tmpD; <T:u&Ic
if(tmpD>tmpI) tmpI++; OUn,URI
return tmpI; f;#hcRSH
} y!fV+S,
public int getPageRowsCount() { {PGNPxUbe
if(pageSize==0) return rowsCount; e4Ol:V
if(getRowsCount()==0) return 0; u*Eb4
if(curPage!=getPageCount()) return pageSize; /r Zj=
return rowsCount-(getPageCount()-1)*pageSize; "YHqls} c
} 31k.{dnm
public int getPageSize() { C/ow{MxA
return pageSize; %v:9_nwO)
} |"DQ^)3Pi
public int getRowsCount() { Q u2W
return rowsCount; QNzI
} =dUeQ?>t=
public void gotoPage(int page) { Ix !O&_6s
if (rs == null) i;`rzsRb
return; e m<(wJ-Y
if (page < 1) ^.Vq0Qzy]
page = 1; z+&mMP`-
if (page > getPageCount()) ?n>h/[/
page = getPageCount(); AM*V4}s*9k
int row = (page - 1) * pageSize + 1; i3s-l8\\z
try { FSd842O
rs.absolute(row); rC}r99Pe:x
curPage = page; 6~V$0Y>]
} YY{S0jnhF
catch (java.sql.SQLException e) { FkR9-X<
} _!H{\kU
} =yOIP@
public void pageFirst() throws java.sql.SQLException { =9 FY;9
int row=(curPage-1)*pageSize+1; [F%INl-sy
rs.absolute(row); n
!]_o
} dGf{d7 D
public void pageLast() throws java.sql.SQLException { G/\t<>O8o
int row=(curPage-1)*pageSize+getPageRowsCount(); )nJs9}( 0
rs.absolute(row); ~\<Fq \.x
} ?8fa/e
public void setPageSize(int pageSize) { v/\l
if(pageSize>=0){ :CNWHF4$
this.pageSize=pageSize; ZY +NKb_
curPage=1; q5YgKz?IC
} f{AbCi
} C^XJE1D.
PageableResultSet2的构造方法: #g\O*oYaw
public PageableResultSet2(java.sql.ResultSet rs) throws java.sql.SQLException { su>GeJiPW
if(rs==null) throw new SQLException(given ResultSet is NULL,user); E KhwrBjS
w_q{C>-cR
rs.last(); _n@#Lufx
rowsCount=rs.getRow(); J7/"8S_#N
rs.beforeFirst(); ;S+*s 'e
]re1$W#*
this.rs=rs; a,x-akZWf
} F]@vmzr
这里只是简单的取得一个总记录数,并将记录游标移回初始位置(before first),同时将参数中的ResultSet赋给成员变量。 _5EM <Ux
w4<1*u@${
j8WnXp_
Pageable的使用方法 \I1+J9Gl
因为Pageable接口继承自ResultSet,所以在使用方法上与ResultSet一致,尤其是在不需要分页功能的时候,可以直接当成ResultSet使用。而在需要分页时,只需要简单的setPageSize, gotoPage,即可。 (eS4$$g
PreparedStatement pstmt=null; 3|8\,fO?
Pageable rs=null; Z\D!'FX
……//构造SQL,并准备一个pstmt. LJ`*&J
rs=new PageableResultSet2(pstmt.executeQuery());//构造一个Pageable R2yiExw<
rs.setPageSize(20);//每页20个记录 (e6JI]tz{
rs.gotoPage(2);//跳转到第2页 Eb{Zm<TP
for(int i=0; i<rs.getPageRowsCount(); i++){//循环处理 f/&gR5
int id=rs.getInt(“ID”); e82SG8#]
……//继续处理 a` A V
} W~2`o*\l
Vb az#I
1[OCoj o<
总结 w2_$>z
一个好的基础类应该是便于使用,并且具备足够的可移植性,同时要保证其功能的完善。在上面的实现中,我们从java.sql.ResultSet接口继承出Pageable,并实现了它。这就保证了在使用中与JDBC原有操作的一致性,同时对原有功能没有缩减。 ~cQ./G4
同时它也是易于使用的,因为封装了一切必要的操作,所以在你的代码中唯一显得难看和不舒服的地方就是需要自己去构造一个PageableResultSet2。不过只要你愿意,这也是可以解决的。 FM$XMD0=
当然它也有具有充分的可移植性,当你将数据库由Oracle变为Mysql或者SQLServer的时候,你仍然可以使用这些分页的代码。它在使用中(或者说在移植的过程中)唯一的限制就是你必须要使用一个支持JDBC2的驱动(现在明白为什么我把类命名为PageableResultSet2了吧。:P),不过,好在JDBC2已经成为标准了,绝大多数的数据库(如Oracle, Mysql, SQLServer)都有自己的或者第三方提供的JDBC2的驱动。 P!3)-apP\
OK,这个分页的实现是否对你的编程有帮助呢?仔细看看,其实真正自己写的代码并不多的,大部分都只是简单的转发操作。一个合适的模式应用可以帮你很大忙。