前言 *y7 $xa4
在使用数据库的过程中,不可避免的需要使用到分页的功能,可是JDBC的规范对此却没有很好的解决。对于这个需求很多朋友都有自己的解决方案,比如使用Vector等集合类先保存取出的数据再分页。但这种方法的可用性很差,与JDBC本身的接口完全不同,对不同类型的字段的支持也不好。这里提供了一种与JDBC兼容性非常好的方案。 H%i>L?J2 /
JDBC和分页 SgM.B
Sun的JDBC规范的制定,有时很让人哭笑不得,在JDBC1.0中,对于一个结果集(ResultSet)你甚至只能执行next()操作,而无法让其向后滚动,这就直接导致在只执行一次SQL查询的情况下无法获得结果集的大小。所以,如果你使用的是JDBC1.0的驱动,那么是几乎无法实现分页的。 F:T GsV#
好在Sun的JDBC2规范中很好的弥补了这一个不足,增加了结果集的前后滚动操作,虽然仍然不能直接支持分页,但我们已经可以在这个基础上写出自己的可支持分页的ResultSet了。 }DIF%}UK\
=_d%=m
]H[8Z|i""
/9 hR
和具体数据库相关的实现方法 Fr:5$,At7-
有一些数据库,如Mysql, Oracle等有自己的分页方法,比如Mysql可以使用limit子句,Oracle可以使用ROWNUM来限制结果集的大小和起始位置。这里以Mysql为例,其典型代码如下: l(kr'x
// 计算总的记录条数 P:!)9/.2
String SQL = SELECT Count(*) AS total + this.QueryPart; C7qYiSv
rs = db.executeQuery(SQL); S*t%RZ~a
if (rs.next()) h=+$>_&:
Total = rs.getInt(1); ;=;JfNnbm
// 设置当前页数和总页数 ,0?!ov|
TPages = (int)Math.ceil((double)this.Total/this.MaxLine); `/:cfP\
CPages = (int)Math.floor((double)Offset/this.MaxLine+1); $k0H9_
// 根据条件判断,取出所需记录 c@du2ICUc
if (Total > 0) { bXdY\&fE
SQL = Query + LIMIT + Offset + , + MaxLine; Y E1Hpeb
rs = db.executeQuery(SQL); 9){
} $kz!zjC'
return rs; Fb_S&!
} 2CLB1
毫无疑问,这段代码在数据库是Mysql时将会是漂亮的,但是作为一个通用的类(事实上我后面要提供的就是一个通用类库中的一部分),需要适应不同的数据库,而基于这个类(库)的应用,也可能使用不同的数据库,所以,我们将不使用这种方法。 GjQfi'vCk
%}qbkkZ
8l)
另一种繁琐的实现方法 5cTY;@@
我看过一些人的做法(事实上包括我在内,一开始也是使用这种方法的),即不使用任何封装,在需要分页的地方,直接操作ResultSet滚到相应的位置,再读取相应数量的记录。其典型代码如下: ^R_e
<% @.9I3E-=
sqlStmt = sqlCon.createStatement(java.sql.ResultSet.TYPE_SCROLL_INSENSITIVE, `E>vG-9
java.sql.ResultSet.CONCUR_READ_ONLY); Ijo(^v@
strSQL = select name,age from test; ")`S0n5e
//执行SQL语句并获取结果集 q-&P=Yk
sqlRst = sqlStmt.executeQuery(strSQL); 6?gi_3g
//获取记录总数 uP|FJLY
sqlRst.last(); SkP[|g'56
intRowCount = sqlRst.getRow(); j%tEZ"H
//记算总页数 R]L2(' B
intPageCount = (intRowCount+intPageSize-1) / intPageSize; []p"3i
//调整待显示的页码 a6nlt?1?D
if(intPage>intPageCount) intPage = intPageCount; 5Pke8K
%> rla:<6tt
<table border=1 cellspacing=0 cellpadding=0> XAD3Z?
<tr> la,
h
<th>姓名</th> 9([6d.`~
<th>年龄</th> nX[;^v/
</tr> ZKdh%8C
<% Sb"2Im >
if(intPageCount>0){ &Ocu#Cb
//将记录指针定位到待显示页的第一条记录上 KH<v@IJ\
sqlRst.absolute((intPage-1) * intPageSize + 1); 0HibY[_PbD
//显示数据 KD*O%@X5C
i = 0; u{C)qb5Pu
while(i<intPageSize && !sqlRst.isAfterLast()){ uHvaZMu
%> bZ5n,KQA5
<tr> MCy~@)-IN
<td><%=sqlRst.getString(1)%></td> 4rp6 C/i
<td><%=sqlRst.getString(2)%></td> 2P}bG>M
</tr> U^$E'Q-VK
<% -2*>`,Uu
sqlRst.next(); d"&3Q_2CD
i++; uMiyq<
} A3yi?y{[*
} X47!E
|*
%> rc{o?U'^-
</table> !$>G#+y
很显然,这种方法没有考虑到代码重用的问题,不仅代码数量巨大,而且在代码需要修改的情况下,将会无所适从。 KwFXB
Ay$>(;
u,9q<&,
使用Vector进行分页 =cp;Q,t'9L
还见过另一些实现分页的类,是先将所有记录都select出来,然后将ResultSet中的数据都get出来,存入Vector等集合类中,再根据所需分页的大小,页数,定位到相应的位置,读取数据。或者先使用前面提到的两种分页方法,取得所需的页面之后,再存入Vector中。 #7W.s!#}Dd
扔开代码的效率不说,单是从程序结构和使用的方便性上讲,就是很糟糕的。比如,这种做法支持的字段类型有限,int, double, String类型还比较好处理,如果碰到Blob, Text等类型,实现起来就很麻烦了。这是一种更不可取的方案。 2d&^Sp&11
0XIxwc0Iw
I'InZ0J2
一个新的Pageable接口及其实现 AQh["1{yJ
很显然,看过上面三种实现方法后,我们对新的分页机制有了一个目标,即:不与具体数据库相关;尽可能做到代码重用;尽可能与原JDBC接口的使用方法保持一致;尽可能高的效率。 p":zrf'(6
首先,我们需要提供一个与java.sql.ResultSet向下兼容的接口,把它命名为Pageable,接口定义如下: s[V`e2O
public interface Pageable extends java.sql.ResultSet{ !~JWYY
/**返回总页数 O/9fuEF
*/ |- OHve4A
int getPageCount(); Zi1YZxF`Y
/**返回当前页的记录条数 fM:80bnL+
*/ yN:>!SQ
int getPageRowsCount(); Q8Te'1Ln!
/**返回分页大小 X;]3$\F
*/ wE2x:Ge:
int getPageSize(); @:gl:mc
/**转到指定页 ~@fanR =
*/ zJ_My&~
void gotoPage(int page) ; { _X#fq0}
/**设置分页大小 #pa\2d|
*/ Xz* tbW#
void setPageSize(int pageSize); %zQ2:iT5@=
/**返回总记录行数 C->[$HcRa
*/ 4K #^dJnC
int getRowsCount(); 0 r3N^_}
/** /MxCvEE
* 转到当前页的第一条记录 P^;WB*V
* @exception java.sql.SQLException 异常说明。 ._(z~3s
*/ O3}P07
void pageFirst() throws java.sql.SQLException; ~ i'C/[P
/** ULrbQ}"cva
* 转到当前页的最后一条记录 #VR`?n?,
* @exception java.sql.SQLException 异常说明。 %Fm`Y.l
*/ gQCC>8
void pageLast() throws java.sql.SQLException; |nfH-JytV
/**返回当前页号 )#mW7m9M#
*/ U)b&zZc;
int getCurPage(); 6(sfpK'
} cWc$yE'
这是一个对java.sql.ResultSet进行了扩展的接口,主要是增加了对分页的支持,如设置分页大小,跳转到某一页,返回总页数等等。 E =
^-Z
接着,我们需要实现这个接口,由于这个接口继承自ResultSet,并且它的大部分功能也都和ResultSet原有功能相同,所以这里使用了一个简单的Decorator模式。 $1=v.'Y
PageableResultSet2的类声明和成员声明如下: 5I_hh?N4Z
public class PageableResultSet2 implements Pageable { WT1q15U(=
protected java.sql.ResultSet rs=null; G dL4|xv
protected int rowsCount; {AtfK>D
protected int pageSize; ~.!?5(AH8z
protected int curPage; +Hi{/{k0N
protected String command = ; "
gwm23Rpj
} vLD:(qTi
可以看到,在PageableResultSet2中,包含了一个ResultSet的实例(这个实例只是实现了ResultSet接口,事实上它是由各个数据库厂商分别实现的),并且把所有由ResultSet继承来的方法都直接转发给该实例来处理。 J$<:/^t
PageableResultSet2中继承自ResultSet的主要方法: RNl\`>Cz
//…… s2wwmtUCN
public boolean next() throws SQLException { $)Jc-V
6E
return rs.next(); uk`d,xF
} :v''"+\
//…… b^@`uDb6
public String getString(String columnName) throws SQLException { vl>_e
try { 0 %C!`7
return rs.getString(columnName); l6yB_M
} ~7KynE
catch (SQLException e) {//这里是为了增加一些出错信息的内容便于调试 Z={UM/6w
throw new SQLException (e.toString()+ columnName= mJ7`.
+columnName+ SQL=+this.getCommand()); Y+}OClS
} (0O`A~M3
} 8Q#t\$RY
//…… 4Q&Xb <
只有在Pageable接口中新增的方法才需要自己的写方法处理。 ^Osd/g
/**方法注释可参考Pageable.java m3h2/}%9`
*/ WXRHG)nvL
public int getCurPage() { E5v|SFD
return curPage; >Lo6='G
} uKaf{=*
public int getPageCount() { ksxO<Y
if(rowsCount==0) return 0; H@ 1[SKBl
if(pageSize==0) return 1; oX%PsS
//calculate PageCount dw=Xjyk?h
double tmpD=(double)rowsCount/pageSize; \1eKY^)2
int tmpI=(int)tmpD; >Rx8 0
if(tmpD>tmpI) tmpI++; znGZULa#
return tmpI; ,.1&Ff)S
} WzNG<rG
public int getPageRowsCount() { Bh.6:9{
if(pageSize==0) return rowsCount; ?];~N5<'
if(getRowsCount()==0) return 0; SF78s:_!_
if(curPage!=getPageCount()) return pageSize; l7=$4As/hI
return rowsCount-(getPageCount()-1)*pageSize; Yg]FF`{p=
}
HfZ (U5~
public int getPageSize() { 6+{ nw}e8
return pageSize; k;AV;KWI'
} O23]!S<;
public int getRowsCount() { yE!7`c.[u
return rowsCount; tCF0Ah
} P+_\}u;
public void gotoPage(int page) { %te'J G<
if (rs == null) ]h`E4B
return; yA`]%U((
if (page < 1) "O"^\f
page = 1; k(w9vt0?
if (page > getPageCount()) P(W\aLp
page = getPageCount(); ?><
int row = (page - 1) * pageSize + 1; O!@KM;
try { {0m[:af&
rs.absolute(row); h&^/, G
curPage = page; nd*!`P
} njx\$,ruN
catch (java.sql.SQLException e) { /Va&k4
} *T}dv)8
} ^ZViQ$a"h;
public void pageFirst() throws java.sql.SQLException { ZLFdnC@
int row=(curPage-1)*pageSize+1; /=O+/)l`
rs.absolute(row); HS|g
} !WVabdt
public void pageLast() throws java.sql.SQLException { WZy6K(18"'
int row=(curPage-1)*pageSize+getPageRowsCount(); E&Zx]?~
rs.absolute(row); @bVh?T0~F,
} @"#gO:|[i0
public void setPageSize(int pageSize) { %lq7; emtp
if(pageSize>=0){
.ubbNp_LU
this.pageSize=pageSize; GE| ^ryh
curPage=1; dpOL1rrE
} .4m3@!qo)E
} sn T4X
PageableResultSet2的构造方法: ?@uK s4
public PageableResultSet2(java.sql.ResultSet rs) throws java.sql.SQLException { <45dy5!Tz
if(rs==null) throw new SQLException(given ResultSet is NULL,user); <`VJU2
d)J] Y=j
rs.last(); sMe~C>RD
rowsCount=rs.getRow(); nr9#3Lb
rs.beforeFirst(); :!*;0~#
jwE(]u
this.rs=rs; Fq\`1Ee{
}
j9
&AMg
这里只是简单的取得一个总记录数,并将记录游标移回初始位置(before first),同时将参数中的ResultSet赋给成员变量。 )T~ +>+t
sOtNd({
1:l&&/Wy
Pageable的使用方法 [T?6~^m=
因为Pageable接口继承自ResultSet,所以在使用方法上与ResultSet一致,尤其是在不需要分页功能的时候,可以直接当成ResultSet使用。而在需要分页时,只需要简单的setPageSize, gotoPage,即可。 HW%bx"r+4f
PreparedStatement pstmt=null; 7-0twq
Pageable rs=null; >j~70 ?
……//构造SQL,并准备一个pstmt. >|&OcU
rs=new PageableResultSet2(pstmt.executeQuery());//构造一个Pageable LRlk9:QD>
rs.setPageSize(20);//每页20个记录 T!eh?^E
rs.gotoPage(2);//跳转到第2页 q8yJW-GA
for(int i=0; i<rs.getPageRowsCount(); i++){//循环处理 `uJ l<kHI
int id=rs.getInt(“ID”); _(A+_|
……//继续处理 $TW+LWb
} OG$iZiuf
G5@fqh6ws
)RKhEm%Vr2
总结 thboHPml{
一个好的基础类应该是便于使用,并且具备足够的可移植性,同时要保证其功能的完善。在上面的实现中,我们从java.sql.ResultSet接口继承出Pageable,并实现了它。这就保证了在使用中与JDBC原有操作的一致性,同时对原有功能没有缩减。 s*U&