JDBC和分页
Sun的JDBC规范的制定,有时很让人哭笑不得,在JDBC1.0中,对于一个结果集(ResultSet)你甚至只能执行next()操作,而无法让其向后滚动,这就直接导致在只执行一次SQL查询的情况下无法获得结果集的大小。所以,如果你使用的是JDBC1.0的驱动,那么是几乎无法实现分页的。
好在Sun的JDBC2规范中很好的弥补了这一个不足,增加了结果集的前后滚动操作,虽然仍然不能直接支持分页,但我们已经可以在这个基础上写出自己的可支持分页的ResultSet了。
和具体数据库相关的实现方法
有一些数据库,如Mysql,Oracle等有自己的分页方法,比如Mysql可以使用limit子句,Oracle可以使用ROWNUM来限制结果集的大小和起始位置。这里以Mysql为例,其典型代码如下:
//计算总的记录条数
StringSQL="SELECTCount(*)AStotal"+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);
}
returnrs;
}
毫无疑问,这段代码在数据库是Mysql时将会是漂亮的,但是作为一个通用的类(事实上我后面要提供的就是一个通用类库中的一部分),需要适应不同的数据库,而基于这个类(库)的应用,也可能使用不同的数据库,所以,我们将不使用这种方法。
另一种繁琐的实现方法
我看过一些人的做法(事实上包括我在内,一开始也是使用这种方法的),即不使用任何封装,在需要分页的地方,直接操作ResultSet滚到相应的位置,再读取相应数量的记录。其典型代码如下:
<%
sqlStmt=sqlCon.createStatement(java.sql.ResultSet.TYPE_SCROLL_INSENSITIVE,
java.sql.ResultSet.CONCUR_READ_ONLY);
strSQL="selectname,agefromtest";
//执行SQL语句并获取结果集
sqlRst=sqlStmt.executeQuery(strSQL);
//获取记录总数
sqlRst.last();
intRowCount=sqlRst.getRow();
//记算总页数
intPageCount=(intRowCount+intPageSize-1)/intPageSize;
//调整待显示的页码
if(intPage>intPageCount)intPage=intPageCount;
%>
<tableborder="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,接口定义如下:
publicinterfacePageableextendsjava.sql.ResultSet{
/**返回总页数
*/
intgetPageCount();
/**返回当前页的记录条数
*/
intgetPageRowsCount();
/**返回分页大小
*/
intgetPageSize();
/**转到指定页
*/
voidgotoPage(intpage);
/**设置分页大小
*/
voidsetPageSize(intpageSize);
/**返回总记录行数
*/
intgetRowsCount();
/**
*转到当前页的第一条记录
*@exceptionjava.sql.SQLException异常说明。
*/
voidpageFirst()throwsjava.sql.SQLException;
/**
*转到当前页的最后一条记录
*@exceptionjava.sql.SQLException异常说明。
*/
voidpageLast()throwsjava.sql.SQLException;
/**返回当前页号
*/
intgetCurPage();
}
这是一个对java.sql.ResultSet进行了扩展的接口,主要是增加了对分页的支持,如设置分页大小,跳转到某一页,返回总页数等等。
接着,我们需要实现这个接口,由于这个接口继承自ResultSet,并且它的大部分功能也都和ResultSet原有功能相同,所以这里使用了一个简单的Decorator模式。
PageableResultSet2的类声明和成员声明如下:
publicclassPageableResultSet2implementsPageable{
protectedjava.sql.ResultSetrs=null;
protectedintrowsCount;
protectedintpageSize;
protectedintcurPage;
protectedStringcommand="";
}
可以看到,在PageableResultSet2中,包含了一个ResultSet的实例(这个实例只是实现了ResultSet接口,事实上它是由各个数据库厂商分别实现的),并且把所有由ResultSet继承来的方法都直接转发给该实例来处理。
PageableResultSet2中继承自ResultSet的主要方法:
//……
publicbooleannext()throwsSQLException{
returnrs.next();
}
//……
publicStringgetString(StringcolumnName)throwsSQLException{
try{
returnrs.getString(columnName);
}
catch(SQLExceptione){//这里是为了增加一些出错信息的内容便于调试
thrownewSQLException(e.toString()+"columnName="
+columnName+" SQL="+this.getCommand());
}
}
//……
只有在Pageable接口中新增的方法才需要自己的写方法处理。
/**方法注释可参考Pageable.java
*/
publicintgetCurPage(){
returncurPage;
}
publicintgetPageCount(){
if(rowsCount==0)return0;
if(pageSize==0)return1;
//calculatePageCount
doubletmpD=(double)rowsCount/pageSize;
inttmpI=(int)tmpD;
if(tmpD>tmpI)tmpI++;
returntmpI;
}
publicintgetPageRowsCount(){
if(pageSize==0)returnrowsCount;
if(getRowsCount()==0)return0;
if(curPage!=getPageCount())returnpageSize;
returnrowsCount-(getPageCount()-1)*pageSize;
}
publicintgetPageSize(){
returnpageSize;
}
publicintgetRowsCount(){
returnrowsCount;
}
publicvoidgotoPage(intpage){
if(rs==null)
return;
if(page<1)
page=1;
if(page>getPageCount())
page=getPageCount();
introw=(page-1)*pageSize+1;
try{
rs.absolute(row);
curPage=page;
}
catch(java.sql.SQLExceptione){
}
}
publicvoidpageFirst()throwsjava.sql.SQLException{
introw=(curPage-1)*pageSize+1;
rs.absolute(row);
}
publicvoidpageLast()throwsjava.sql.SQLException{
introw=(curPage-1)*pageSize+getPageRowsCount();
rs.absolute(row);
}
publicvoidsetPageSize(intpageSize){
if(pageSize>=0){
this.pageSize=pageSize;
curPage=1;
}
}
PageableResultSet2的构造方法:
publicPageableResultSet2(java.sql.ResultSetrs)throwsjava.sql.SQLException{
if(rs==null)thrownewSQLException("givenResultSetisNULL","user");
rs.last();
rowsCount=rs.getRow();
rs.beforeFirst();
this.rs=rs;
}
这里只是简单的取得一个总记录数,并将记录游标移回初始位置(beforefirst),同时将参数中的ResultSet赋给成员变量。
Pageable的使用方法
因为Pageable接口继承自ResultSet,所以在使用方法上与ResultSet一致,尤其是在不需要分页功能的时候,可以直接当成ResultSet使用。而在需要分页时,只需要简单的setPageSize,gotoPage,即可。
PreparedStatementpstmt=null;
Pageablers=null;
……//构造SQL,并准备一个pstmt.
rs=newPageableResultSet2(pstmt.executeQuery());//构造一个Pageable
rs.setPageSize(20);//每页20个记录
rs.gotoPage(2);//跳转到第2页
for(inti=0;i<rs.getPageRowsCount();i++){//循环处理
intid=rs.getInt(“ID”);
……//继续处理
}
总结
一个好的基础类应该是便于使用,并且具备足够的可移植性,同时要保证其功能的完善。在上面的实现中,我们从java.sql.ResultSet接口继承出Pageable,并实现了它。这就保证了在使用中与JDBC原有操作的一致性,同时对原有功能没有缩减。
同时它也是易于使用的,因为封装了一切必要的操作,所以在你的代码中唯一显得"难看"和"不舒服"的地方就是需要自己去构造一个PageableResultSet2。不过只要你愿意,这也是可以解决的。
当然它也有具有充分的可移植性,当你将数据库由Oracle变为Mysql或者SQLServer的时候,你仍然可以使用这些分页的代码。它在使用中(或者说在移植的过程中)唯一的限制就是你必须要使用一个支持JDBC2的驱动(现在明白为什么我把类命名为PageableResultSet2了吧。:P),不过,好在JDBC2已经成为标准了,绝大多数的数据库(如Oracle,Mysql,SQLServer)都有自己的或者第三方提供的JDBC2的驱动。
OK,这个分页的实现是否对你的编程有帮助呢?仔细看看,其实真正自己写的代码并不多的,大部分都只是简单的转发操作。一个合适的模式应用可以帮你很大忙。