本篇主要介绍如何利用Cosmos框架进行分页开发,利用上一篇文章的结果,下面直接将上面查询和列出所有学生的界面,修改为一个带有分页的界面。

      首先,修改上篇博文的存储过程为带有分页的存储过程,下面是修改之后的存储过程:

 

SQL

      这个存储过程看起来似乎很复杂,但大部分代码都是十分容易理解的,前面大部分的IF-ELSE语句主要都是在判断输入的参数是否为空,因为是分页,因此,当一些参数没有传入时,应该给与默认值。

      上面的存储过程的各个参数分别代表:

      studentName:入参数,要查询的学生名字;

      page:入参数,当前是哪一页;

      orderBy:入参数,使用哪一列进行排序;

      orderDesc:入参数,排序采用正序还是倒序;

      totalRecords:出参数,总记录个数。

      在存储过程的代码中,SET @pageLimit=5;表示每一页显示5条数据;之后的几行主要是在判断传入的几个参数,如果为空时,设置其默认值;SET @pageStart = (@page - 1) * @pageLimit;来设置本页开始的记录数。从上面分析可以得知,如果不需要从页面来控制排序列,是否正序等等功能时,可去掉orderBy和orderDesc两个参数。

      下面修改页面,利用Cosmos框架提供的分页标签,进行分页显示,如下所示,是相关的代码:

 

 

JSP

  

      上述代码中,pager:info标签是用来总的来计算所有跟分页有关的信息的,其属性包括:

      totalItems:总的数据条数,在上面的例子中,利用了Cosmos框架里提供的另外一个函数present:commandVar来获取存储过程输出的OUT参数,present:commandVar函数的几个参数分别是(域名,命令名,OUT参数名称,result结果);

     url:分页页标签点击时需要的链接地址,在后面的标签中,Cosmos会根据这个参数生成每一页的链接地址;

      numPerPage:每一页显示的个数;

      currentPageNum:当前页的页数;

      pageNumShown:每次显示多少页。

      pager:first标签是用来输出第一页的链接的。pager:prepages标签是用来输出前几页的。pager:previous标签是用来输出上一页的。pager:pages标签是用来输出当前的页面列表的。pager:next标签是用来输出下一页的。pager:nextpages标签是用来输出后几页的。pager:last标签是用来输出最后一页的。pager:allpages标签是用来输出所有页面得。

      另外,在上面的例子中,凡是${Pager_}开头输出的数据,都是Cosmos框架分页标签库所提供的。

      下面是上述分页功能所输出的结果:

page_1

      点击下一页之后,界面显示如下:

page_2

      在搜索框中输入搜索条件之后,可以得到对应的搜索结果,在搜索结果页面中也可以点击分页进行其他页面的访问。

      从上面这个例子可以看出,Cosmos框架提供的分页标签基本能够满足日常的分页需求,也能够相对比较灵活地适应各种分页风格。

本例子相关的代码下载链接如下:

paged_students.zip