基于Struts2、Freemarker的分页组件实现(附工程源码)

李明 — Wed, 01 Dec 2010 09:35:00 GMT

本文为原创，欢迎转载，转载请注明出处BlogJava。

本次分页组件着重于页面（Freemarker部分）、及Action部分。
至于Service及持久层处理，只是做了一个模拟的实现，实际开发中，我是应用了iBatis，封装了分页调用。
由于用法有所不同，所以就不放在源码范围内，也不在这里介绍了。
这里的分页功能只提供了上一页、下一页、指定页的分页，但在分页Java代码中包含了首页、末页的实现。有需要的可自行添加。

分页的效果如图：

分页实现代码介绍：
1.pagination.ftl 分页组件页面部分。

2.PageSupport.java 分页Action部分。

3.WebPager.java 计算分页动作。

4.Pager.java 保存分页信息，由Action传递到Service，根据Pager对象取得数据。

5.MockDataBase.java 模拟Dao，实现分页处理。

使用该组件的方法如下：

第一步：引入分页组件

<#include "/ftl/ecs/pagination.ftl" />

分页组件使用了Freemarker的宏。

第二步：在ftl文件中使用分页组件

分页组件需要输入4个参数，分别为id、method、btnCssClass、cssClass，其中id、method必须输入；btnCssClass、cssClass可选。以下是参数详细说明：
1.id : 分页组件的唯一标识。
2.method : 分页用的Action。例如：定义了Action为Pagination，则method输入 Pagination.action；若为动态方法调用，可输入Pagination!query.action
3.cssClass : 分页组件的class属性。例如cssClass="center"。
4.btnCssClass : 分页组件按钮的class属性。例如btnCssClass="btn_history"。

<@pagination id="***" btnCssClass="***" cssClass="***" method="***.action">

...

[编辑]第三步：继承分页类PageSupport

PageSupport.java继承自ActionSupport.java，在要分页的方法中使用PageSupport.java提供的List pageCall(String module, String target, Map dataMap)分页调用。
通过setPageSize(int pageSize)方法设定每页显示的记录数。
API详细说明：
1.pageCall

 参数说明：
1) String module : 调用service的通道，例如：upf、esf。
2) String target : 要调用的service的方法，例如：com.ailk.ecs.service.TdupfPageService.selectAllUser。
3) Map dataMap : 输入参数。
返回值说明：
List : 页面显示的数据记录。

2.setPageSize

 参数说明：
1) int pageSize : 每页显示记录数。

[编辑]
第四步：Service代码中使用

在service封装分页Dao或者分页方法。

pagination.ftl代码:

<#macro pagination id method cssClass="" btnCssClass="" pageSize='10'>
<div id='${id}'>
<#nested> <#-- 要刷新的区域 -->

<div class="${cssClass}">
    <input type="button" onclick="Pagination${id}.gotoPage('prev', '${webPager.pageInfo.currentPage}', '${totalSize}');" value="上一页" class="${btnCssClass}" />
      共 ${totalPages} 页  第 ${webPager.pageInfo.currentPage} 页  转到
    <input type="text" id='${id}_inputPageNo' name='${id}_inputPageNo' size="6"/>页
    <input type="text" style="display:none"/>
    <input type="button" onclick="Pagination${id}.gotoPage('input', '${webPager.pageInfo.currentPage}', '${totalSize}');" value="确定" class="${btnCssClass}" />
    <input type="button" onclick="Pagination${id}.gotoPage('next', '${webPager.pageInfo.currentPage}', '${totalSize}');" value="下一页" class="${btnCssClass}" />
div>

<script>
if (!this.Pagination${id} ) {
    this.Pagination${id} = {}

    // 分页处理方法
    Pagination${id}.gotoPage = function(action, c, t) {
        var cmd = action;

        // 当总记录数量小于等于每页记录数量时，分页动作无效
        if (t <= ${webPager.pageInfo.pageSize}) {
            return;
        }

        // 确定按钮处理
        if(action == 'input') {
            var inValue = $("#${id}_inputPageNo").val();

            if(inValue.match(/^[0-9]+$/) && parseInt(inValue) > 0) {
                cmd = inValue;
            }
            else {
                // TODO 提示错误信息
                return ;
            }
        }

        $('#${id}').load(
            '${method} #${id}',
            {action : cmd,
             totalSize : t,
             currentPage : c
            }
        );
    };

    // 刷新当前页面
    Pagination${id}.refreshPage = function() {
        //Pagination${id}.gotoPage('refresh');
        //scrollPage${id}('refresh', "${method}");
    };

    // 页码输入框keyup事件
    //Pagination${id}.keyup = function(inputElem, currentPage, totalSize) {
        //if (inputElem.value.match(/^[0-9]+$/) && parseInt(inputElem.value) > 0) {
            //Pagination${id}.gotoPage(inputElem.value, currentPage, totalSize);
        //}
    //};

    //$("#${id}_inputPageNo").keyup(function(event){
        //if(event.keyCode == 13) {
            //Pagination${id}.keyup(this, '${webPager.pageInfo.currentPage}', '${totalSize}');
        //}
    //});
}
script>

div>
#macro>

请点击下载源码。

非maven化工程，自己找包吧。
lib包如图：

李明 2010-12-01 17:35 发表评论

基于Struts2 Result Type为chain 的Action之间数据传递

李明 — Fri, 19 Nov 2010 09:25:00 GMT

摘要: 本文为原创，欢迎转载，转载请注明出处BlogJava。 chain:基本用途是构造成一条动作链。前一个Action将控制权转交给后一个Action，而前一个Action的状态在后一个Action里仍然保持着。我现在有一个场景，FirstAction 通过chain的方式，将控制权交给 SecondAction。FirstAction对应的页面代码为first.ftl，SecondActi... 阅读全文

李明 2010-11-19 17:25 发表评论

基于Struts2和freemarker的异常提示信息的统一处理

李明 — Tue, 16 Nov 2010 06:53:00 GMT

摘要: 本文为原创，欢迎转载，转载请注明出处BlogJava。 Struts2 版本 2.2.1 Freemarker版本 2.3.16 此统一处理的目的在于 Web层、Service层抛出的业务异常以统一的格式显示在页面的固定位置。首先定义我们的业务异常类。 public abstract class BaseException extends&n... 阅读全文

李明 2010-11-16 14:53 发表评论

BlogJava-ALL is Well！-随笔分类-Struts2