JeeSite | 数据分页与翻页

　　本文章仍然介绍的是 JeeSite 开源项目二次开发时的一篇笔记，对于没有使用过 JeeSite 的可以不用往下看了，因为下面的代码是跟 JeeSite 二次开发相关的代码，不做 JeeSite 的二次开发，以下代码对您无用，在这里友情提醒，避免浪费您宝贵的时间。

　　翻页功能在各种项目中都会用到，在 JeeSite 开源项目中使用翻页也非常的容易，只要在配置文件中进行就可以就可以使用，系统的默认值为 30 页。

　　配置文件在 srcmainresourcesjeesite.properties 文件中，配置如下：

page.pageSize=30

　　但是这种配置并不能满足所有的分页要求，也就是说在不同的列表中分页的条数是不同的。如果在配置文件中修改分页条数，那么会影响到整个项目的分页，它是一个全局的配置参数，这样就很不方便了。

JeeSite手册的分页

　　在做项目的时候，由于使用 JeeSite 的默认页数无法满足项目的需求，因为不可能每个列表页都以 30 条记录作为一页，因此只能看手册。看手册又没有具体理解如何使用，JeeSite 手册中最分页的描述如下：

// 设置分页参数，则分页，如果不设置，则根据条件获取全部
user.setPage(page);
// 执行分页查询
page.setList(userDao.findPage(user));

　　按照手册的方法简单的尝试了一下，但是没有效果，因此就只能查看分页的源码了。

分页源码

　　在使用开源项目的时候遇到问题，如果又没有手册，或者手册说明不是特别详细的话，除了在网上找资料外，就只剩下阅读开源项目的源代码了。（注：关于分页这个问题在网上还是有很多人问的，大部分都是说修改配置文件，但是同样无法满足提问人的需要，因为大家需要的是不同的列表中有不同的分页条数。）

　　在 Eclipse 下按下 Ctrl + Shift + R，输入“page.java”，然后打开该 Java 文件。看一下 Page 类的构造方法，代码如下：

/**
 * 构造方法
 * @param request 传递 repage 参数，来记住页码
 * @param response 用于设置 Cookie，记住页码
 */
public Page(HttpServletRequest request, HttpServletResponse response){
    this(request, response, -2);
}

/**
 * 构造方法
 * @param request 传递 repage 参数，来记住页码
 * @param response 用于设置 Cookie，记住页码
 * @param defaultPageSize 默认分页大小，如果传递 -1 则为不分页，返回所有数据
 */
public Page(HttpServletRequest request, HttpServletResponse response, int defaultPageSize){
    // 设置页码参数（传递repage参数，来记住页码）
    String no = request.getParameter("pageNo");
    if (StringUtils.isNumeric(no)){
        CookieUtils.setCookie(response, "pageNo", no);
        this.setPageNo(Integer.parseInt(no));
    }else if (request.getParameter("repage")!=null){
        no = CookieUtils.getCookie(request, "pageNo");
        if (StringUtils.isNumeric(no)){
            this.setPageNo(Integer.parseInt(no));
        }
    }
    // 设置页面大小参数（传递repage参数，来记住页码大小）
    String size = request.getParameter("pageSize");
    if (StringUtils.isNumeric(size)){
        CookieUtils.setCookie(response, "pageSize", size);
        this.setPageSize(Integer.parseInt(size));
    }else if (request.getParameter("repage")!=null){
        size = CookieUtils.getCookie(request, "pageSize");
        if (StringUtils.isNumeric(size)){
            this.setPageSize(Integer.parseInt(size));
        }
    }else if (defaultPageSize != -2){
        this.pageSize = defaultPageSize;
    }
    // 设置页面分页函数
    String funcName = request.getParameter("funcName");
    if (StringUtils.isNotBlank(funcName)){
        CookieUtils.setCookie(response, "funcName", funcName);
        this.setFuncName(funcName);
    }else if (request.getParameter("repage")!=null){
        funcName = CookieUtils.getCookie(request, "funcName");
        if (StringUtils.isNotBlank(funcName)){
            this.setFuncName(funcName);
        }
    }
    // 设置排序参数
    String orderBy = request.getParameter("orderBy");
    if (StringUtils.isNotBlank(orderBy)){
        this.setOrderBy(orderBy);
    }
}

/**
 * 构造方法
 * @param pageNo 当前页码
 * @param pageSize 分页大小
 */
public Page(int pageNo, int pageSize) {
    this(pageNo, pageSize, 0);
}

/**
 * 构造方法
 * @param pageNo 当前页码
 * @param pageSize 分页大小
 * @param count 数据条数
 */
public Page(int pageNo, int pageSize, long count) {
    this(pageNo, pageSize, count, new ArrayList<T>());
}

/**
 * 构造方法
 * @param pageNo 当前页码
 * @param pageSize 分页大小
 * @param count 数据条数
 * @param list 本页数据对象列表
 */
public Page(int pageNo, int pageSize, long count, List<T> list) {
    this.setCount(count);
    this.setPageNo(pageNo);
    this.pageSize = pageSize;
    this.list = list;
}

　　从源码中可以看出 Page 类有很多的构造方法，如果需要自定义每页有多少条记录，那么需要使用的构造方法是第二个构造方法，代码如下：

/**
 * 构造方法
 * @param request 传递 repage 参数，来记住页码
 * @param response 用于设置 Cookie，记住页码
 * @param defaultPageSize 默认分页大小，如果传递 -1 则为不分页，返回所有数据
 */
public Page(HttpServletRequest request, HttpServletResponse response, int defaultPageSize){
    // 设置页码参数（传递repage参数，来记住页码）
    String no = request.getParameter("pageNo");
    if (StringUtils.isNumeric(no)){
        CookieUtils.setCookie(response, "pageNo", no);
        this.setPageNo(Integer.parseInt(no));
    }else if (request.getParameter("repage")!=null){
        no = CookieUtils.getCookie(request, "pageNo");
        if (StringUtils.isNumeric(no)){
            this.setPageNo(Integer.parseInt(no));
        }
    }

　　这个构造方法比系统默认生成代码使用的构造函数多了一个参数—— defaultPageSize，这个参数可以用来设置每页的记录数，调用方法如下：

Page<Xxx> p = new Page<Xxx>(request, response, 10);
Page<Xxx> page = xxxService.findPage(p, xxx);

　　JeeSite 生成的代码中调用的方法如下（ JeeSite 有一个代码生成的功能，代码生成中对分页的使用如下）：

Page<Xxx> page = xxxService.findPage(new Page<Xxx>(request, response), xxx);

　　在该源码上下断点，发现这里在实例化 Page 类时，调用的构造方法如下：

/**
 * 构造方法
 * @param request 传递 repage 参数，来记住页码
 * @param response 用于设置 Cookie，记住页码
 */
public Page(HttpServletRequest request, HttpServletResponse response){
    this(request, response, -2);
}

　　在该构造方法中同样调用的是 Page.java 中第二个构造方法。

JS 翻页

　　在 JeeSite 中使用了 BootStrap 的前端库，使用这个前端库可以很容易的使用“弹出的模态对话框”。使用模态对话框，可能会是一个表单提交一些数据，也可能是其他表单数据列表。使用模态对话框时，如果是数据列表的话，那么也会涉及到列表分页的问题。调用的代码如下：

<div class="control-group">
    <label class="control-label">个人信息：</label>
    <div class="controls">
        <input type="text" name="personName" />
        <form:hidden path="personId" />
        <span class="help-inline"><font color="red">*</font> </span><a
            href="url/Controller..."
            role="button" class="btn" data-target="#PersonModal"
            data-toggle="modal">选择</a>
    </div>
</div>
……
<div id="PersonModal" class="modal hide fade" tabindex="-1" role="dialog"
    aria-labelledby="myModalLabel" aria-hidden="true">
    <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal"
            aria-hidden="true">×</button>
        <h3 id="PersonModalLabel">选择人员</h3>
    </div>
    <div class="modal-body" id="PersonBody"></div>
    <div class="modal-footer">
        <button class="btn" data-dismiss="modal" aria-hidden="true">取消</button>
        <button class="btn btn-primary" id="selectPerson">确定</button>
    </div>
</div>

　　当点击上半段代码的“选择”按钮时，通过 href 指定的 URL 地址可以将另外一个页面显示到该页面中，然后获取到的数据会在下半段代码的具有属性“modal-body”的 div 中显示出来。这时，显示的是另外一个页面的内容的，而显示页面的 JS 代码是无法带过来的。那么，翻页默认调用的 JS 代码就不能使用了。翻页的代码如下：

function page(n,s){
    $("#pageNo").val(n);
    $("#pageSize").val(s);
    $("#searchForm").submit();
    return false;
}

　　这段代码就无法调用了，那么要翻页就需要重新定义了，并且，重新定义后的 JS 代码要在完成分页的情况下将数据仍然显示到“modal-body”中。但是重新定义一个翻页的 JS 函数如何让页码列表调用呢？

　　在 Page 类中，提供了一个非常实用的方法，它可以指定翻页的 JS 函数，方法如下：

/**
 * 设置点击页码调用的js函数名称，默认为page，在一页有多个分页对象时使用。
 * @param funcName 默认为page
 */
public void setFuncName(String funcName) {
    this.funcName = funcName;
}

　　有了这个函数就可以完成翻页了，甚至在多个模态对话框中都使用到需要翻页的列表，也可以解决了。调用方法如下：

Page<Xxx> p = new Page<Xxx>(request, response, 10);
p.setFuncName("ctPage");
Page<Xxx> page = xxxService.findPage(p, xxx);

　　这样，生成的分页页码中在调用翻页函数时，就可以调用自定义的翻页函数 ctPage() 了。定义的翻页方法如下：

function hrPage(n, s) {         
    $.ajax({  
        type: "POST",  
        url:"${ctx}/...",   // 具体的地址省略
        data:{pageNo:n, pageSize:s},
        async: false,
        error: function(request) { 
            
        },
        success: function(data) {
            $('#PersonBody').empty();
            $('#PersonBody').append(data);
        }
    });
}

　　函数体就是自定义的翻页方法了。