Cosmos开发指南(三)

时间：2021-08-25 15:16:30
本篇主要介绍如何利用Cosmos框架进行分页开发，利用上一篇文章的结果，下面直接将上面查询和列出所有学生的界面，修改为一个带有分页的界面。

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

  

SQL
DELIMITER $$

USE `cosmos`$$

DROP PROCEDURE IF EXISTS `searchStudents`$$

CREATE DEFINER=`cosmos`@`%` PROCEDURE `searchStudents`(IN studentName VARCHAR(512),IN page INT,IN orderBy INT, IN orderDesc INT,OUT totalRecords INT)
BEGIN
    SET @pageLimit=5;

    IF page IS NULL OR page = 'null' OR page = '' OR page < 1 THEN
        SET @page=1;
    ELSE
        SET @page=page;
    END IF;

    IF orderBy IS NULL OR orderBy = 'null' OR orderBy = '' OR orderBy < 1 THEN
        SET @orderBy=2;
    ELSE
        SET @orderBy=orderBy;
    END IF;

    IF orderDesc IS NULL OR orderDesc = 'null' OR orderDesc = '' OR orderDesc=0 THEN
        SET @orderDesc='ASC';
    ELSE
        SET @orderDesc='DESC';
    END IF;

    SET @pageStart = (@page - 1) * @pageLimit;

    IF studentName IS NULL THEN
        SET studentName = '';
    END IF;

    SET @namePattern = CONCAT('%', studentName, '%');
    SET @listSql=CONCAT('SELECT * FROM student WHERE NAME LIKE ? OR REAL_NAME LIKE ? ORDER BY ? ',@orderDesc, ' LIMIT ?,?');
    PREPARE _stmt FROM @listSql;
    EXECUTE _stmt USING @namePattern, @namePattern, @orderBy, @pageStart, @pageLimit;
    DEALLOCATE PREPARE _stmt;

    SELECT COUNT(ID) INTO totalRecords FROM student WHERE NAME LIKE @namePattern OR REAL_NAME LIKE @namePattern;
    END$$

DELIMITER ;

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

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

studentName：入参数，要查询的学生名字；

page：入参数，当前是哪一页；

orderBy：入参数，使用哪一列进行排序；

orderDesc：入参数，排序采用正序还是倒序；

totalRecords：出参数，总记录个数。

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

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

JSP
<%@ page pageEncoding="UTF-8" language="java" contentType="text/html;charset=UTF-8"%><%@ include file="/include.inc.jsp"%><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" />
<link href="styles/default/css/main.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="styles/default/scripts/main.js"></script>
</head>

<body onresize="fixSubHeight();" onload="fixSubHeight();">
<iframe id="hiddenFrame" name="hiddenFrame" style="display:none;"></iframe>
<div id="listContent">
    <h1><span>学生列表</span></h1>
    <div id="top" class="toolBar">
        <div class="left" style="width:100%;">
            <form name="searchForm" id="searchForm" method="post" enctype="application/x-www-form-urlencoded" style="border:none;">
                <input type="text" name="studentName" value="${param.studentName}" />
                <button onclick="searchForm.submit();">查询</button>
            </form>
        </div>
    </div>
    <div id="tab" align="center">
        <table class="defaultList">
            <tr>
                <th scope="col">学生名称</th>
                <th scope="col">学生真实姓名</th>
                <th scope="col">学生性别</th>
            </tr><c:forEach items="${present:commandFirstList('jndi', 'searchStudents', result)}" var="student">
            <tr onclick="selectRow(this);">
                <td>${student.name}</td>
                <td>${student.realName}</td>
                <td>${student.gender ? "女" : "男"}</td>
            </tr></c:forEach>
        </table>
    </div>
    <div id="bottom" class="toolBar">
        <div class="left">
        </div>
        <div class="right">
            <pager:info totalItems="${present:commandVar('jndi', 'searchStudents', 'totalRecords', result)}" url="cosmos.slet?domain=jndi&method=searchStudents&forward=test.paged_students&studentName=${param.studentName}" numPerPage="5" currentPageNum="${param.page}" pageNumShown="5" >
                <pager:first><a href="${firstPage}">首页</a></pager:first>
                <pager:prepages><a href="${prePages}">前${Pager_pageNumShown }页</a></pager:prepages>        
                <pager:previous><a href="${prePage}">上一页</a></pager:previous>
                <pager:pages><a href="${pages}"><c:if test="${Pager_pageNum == Pager_currentPageNum }"><strong>${Pager_pageNum }</strong></c:if><c:if test="${!(Pager_pageNum == Pager_currentPageNum)}">${Pager_pageNum}</c:if></a></pager:pages>
                <pager:next><a href="${nextPage}">下一页</a></pager:next>
                <pager:nextpages><a href="${nextPages}">后${Pager_pageNumShown}页</a></pager:nextpages>        
                <pager:last><a href="${lastPage}">尾页</a></pager:last>
                <select onchange="document.location='${url}'+this.options[this.selectedIndex].value;"><pager:allpages><option ${Pager_currentPageNum == Pager_pageCount ? "selected" : ""} value="${Pager_pageCount}">${Pager_pageCount}</option></pager:allpages></select> 
            </pager:info>
        </div>
    </div>
</div>
</body>
</html>


 上述代码中，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框架分页标签库所提供的。

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

Cosmos开发指南(三)

点击下一页之后，界面显示如下：

Cosmos开发指南(三)

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

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

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


 

标签：

相关文章