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

freemarker数字格式化引入的问题

李明 — Wed, 29 Dec 2010 06:54:00 GMT

问题
freemarker在解析数据格式的时候，默认将数字按3位来分割，例如1000被格式化为1,000，这样做看似美观，但在实际操作时候会带来问题。例如我一个页面有一个元素，该元素的值由后台绑定且超过1000，那么当我要使用这个元素的值的时候，便会出现问题。
例如，我在ftl文件中这样写：

假设后台绑定的size为1000。

然后我在js里使用这个testElement元素的值。

var t = $("#testElement");
alert(t);
alert(parseInt(t));
alert(Number(t));

得到的值是：
1,000
1
NaN

这下悲剧了，没有一个是我想要的数值类型1000，这让我情何以堪啊。

我之前有一个随笔，基于Struts2、Freemarker的分页组件实现(附工程源码) ，便因为freemarker的数字格式化问题，存在一个bug。
在数据超过1000时候，点击下一页，便会报错。原因是将1,000传到了后台，当作是总记录数，而这个值并非数值。

解决问题
* 在模板中直接加.toString()转化数字为字符串，如：${size.toString()}；
* 在freemarker配置文件freemarker.properties(在类路径下即可)加<#setting number_format="#">；
* 在模板中直接加<#setting number_format="#">；
* 通过freemarker.template.Configuration的config.setNumberFormat("#")来设定freemarker对数值的格式化;

其实后三种方法的思路是一致的，只是实现方法不同而已。如果应用中已经存在了 freemarker.properties 并配置了其他的属性，可以在这里配置，否则推荐使用最后一种方法。

最后我是用最后一种方法解决的问题。分页组件上的问题也解决了。

李明 2010-12-29 14:54 发表评论

基于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 发表评论

解决 freemarker 变量没有值时抛出异常

李明 — Wed, 17 Nov 2010 05:54:00 GMT

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

默认情况下，freemarker的变量必须有值，如果没有被赋值的变量在页面上使用就会抛出异常，出错的信息都会显示在页面上，让人感觉不爽（开发时还可以忍忍）。
解决办法：

方法一、我们可以在页面上使用freemarker变量时以 ${xxx?if_exists} 来处理空值的情况，或采用默认值的方法避免此类问题。但每个freemarker变量都这样处理确实比较让人心烦，请看以下方法。

方法二、在类路径下加入 freemarker.properties 文件，里面配置 classic_compatible=true。

方法三、通过freemarker.template.Configuration的 config.setClassicCompatible(true);通过源码我们看到，其实方法二、方法三是思想是一致的，只是实现方法不同而已。如果应用中已经存在了 freemarker.properties 并配置了其他的属性，可以在这里配置，否则推荐使用方法三，毕竟没有每个应用的配置文件实在是都够多了。

方法四、在ftl文件内引入。

其他关于在spring中的配置这里就省略。现在的项目中没有用到。

总结：方法四是需要在每个需要这样处理的页面都要引入的，比较麻烦，、还是选择使用方法二、方法三好了。但是方法二、方法三也不是万能的。例如我在action中定义一个MyBean类的对象为 myBean，MyBean中有Comp属性。在页面上就要用如下语句使用：${myBean.comp}，这里myBean可能为null，comp也可能为null。这时候就要使用方法一了，${(myBean.comp)!} 或 ${(myBean.comp)?if_exists}。

李明 2010-11-17 13:54 发表评论

基于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 发表评论