【转】 在模板中分页，看Freemarker和 displaytag的结合

Displaytag是一个很好的分页标签，它支持数据库端分页（在displaytag1.1的版本中也实现了数据库端分页，只要实现 PaginatedList接口，然后把这个对象扔到页面上的display:table标签中就能实现数据库端分页。这里所说的数据库端分页就是 displaytag文档中提到的partial list），排序，也支持导出各种文件，比如说pdf,excel等等，而且它还支持程序员使用decorator模式来包装和更改要输出的model的 属性,等等。

而freemarker是一个很好的模板引擎，它被设计的目的就是被用在view层，通过模板来生成html页面，在动态页面中使用模板技术的目 的就是分离页面设计者和程序员的职责，而且模板的速度更快，尤其是无需编译这种特性，模板的优缺点及freemarker和velocity的比较见http://www.iteye.com/topic/71430 。（题 外话：有人可能不同意我的观点，但我仍然相信术业有专攻，每个人都有自己强的一方面，以前在看robbin的一个就业ppt中，感觉有一句话说得特别好， 什么叫成功：成功不是弥补自己的不足，而是把自己的优点发挥到及至，这样就能够成功。）

这两个都是口碑很好的开源项目，让我觉得放弃他们中的任何一个都是非常可惜的，在使用模板语言的时候，如果不用displaytag（或者其他分 页的tag），那么必须得自己写marco来实现分页的功能，其实就是用freemarker或者velocity模板语言把分页的功能又写了一遍，可以 也是可以的，只是要花一些人力物力，说白了就是实现同样的功能却要花更多的钱和时间，在做外包的时候这样尤其不可取了（当然个人学习研究就另当别论了）， 那么在企业应用开发中如果把两者结合起来应该是一个不错的选择，这样既拥有了模板语言的优势又能只用几行代码就搞定分页排序等功能，两全其美，一举两得， 快哉。

那么让我们来看一下步骤：
1， 在web.xml导入FreemarkerServlet的配置

<servlet>
  <servlet-name>freemarker</servlet-name>
  <servlet-class
>freemarker.ext.servlet.FreemarkerServlet</servlet-
class
>

  <!-- FreemarkerServlet settings: -->
  <init-param>
    <param-name>TemplatePath</param-name>
    <param-value>/</param-value>
  </init-param>
  <init-param>
    <param-name>NoCache</param-name>
    <param-value>true
</param-value>
  </init-param>
  <init-param>
    <param-name>ContentType</param-name>
    <param-value>text/html</param-value>
  </init-param>

  <!-- FreeMarker settings: -->
  <init-param>
    <param-name>template_update_delay</param-name>
    <param-value>0
</param-value> <!-- 
0
 is 
for
 development only! Use higher value otherwise. -->
  </init-param>
  <init-param>
    <param-name>default_encoding</param-name>
    <param-value>UTF-8
</param-value>
  </init-param>
  <init-param>
    <param-name>number_format</param-name>
    <param-value>0
.##########</param-value>
  </init-param>

  <load-on-startup>1
</load-on-startup>
</servlet>

<servlet>
        <servlet-name>JspSupportServlet</servlet-name>
        <servlet-class
>
            org.apache.struts2.views.JspSupportServlet
        </servlet-class
>
        <load-on-startup>1
</load-on-startup>
    </servlet>

<servlet-mapping>
  <servlet-name>freemarker</servlet-name>
  <url-pattern>*.ftl</url-pattern>
</servlet-mapping>

<servlet>
  <servlet-name>freemarker</servlet-name>
  <servlet-class>freemarker.ext.servlet.FreemarkerServlet</servlet-class>
    
  <!-- FreemarkerServlet settings: -->
  <init-param>
    <param-name>TemplatePath</param-name>
    <param-value>/</param-value>
  </init-param>
  <init-param>
    <param-name>NoCache</param-name>
    <param-value>true</param-value>
  </init-param>
  <init-param>
    <param-name>ContentType</param-name>
    <param-value>text/html</param-value>
  </init-param>
    
  <!-- FreeMarker settings: -->
  <init-param>
    <param-name>template_update_delay</param-name>
    <param-value>0</param-value> <!-- 0 is for development only! Use higher value otherwise. -->
  </init-param>
  <init-param>
    <param-name>default_encoding</param-name>
    <param-value>UTF-8</param-value>
  </init-param>
  <init-param>
    <param-name>number_format</param-name>
    <param-value>0.##########</param-value>
  </init-param>

  <load-on-startup>1</load-on-startup>
</servlet>

<servlet>
		<servlet-name>JspSupportServlet</servlet-name>
		<servlet-class>
			org.apache.struts2.views.JspSupportServlet
		</servlet-class>
		<load-on-startup>1</load-on-startup>
	</servlet>

<servlet-mapping>
  <servlet-name>freemarker</servlet-name>
  <url-pattern>*.ftl</url-pattern>
</servlet-mapping>  

2,在页面模板中导入jsptag的tld声明（这一步貌似和jsp中tag的声明一样）

<#assign display=JspTaglibs[
"/WEB-INF/tld/display.tld"
]>

<#assign display=JspTaglibs["/WEB-INF/tld/display.tld"]>

3， 接下来就是使用displaytag了，前面那两步freemarker的文档上有详细的说明，大家只要在文档的索引页面上查找”tag”就能找到了，但 是在第三步就要注意点问题了，也就是把PaginatedList实现的对象实例扔到模板里时要注意的事项。

(1)在<@display.table的name属性中不要再使用${}，直接写PaginatedList的对象引用就可以了，比如说 直接写name=”customers”而不要写成name=”${customers}”

(2)不要导入displaytag-el.tld，直接导入displaytag.tld就可以了。

(3)<@display.table>和<@display.column>中的布尔类型不能使用字符串，我们在 jsp中直接使用diplaytag的使用应该是使用字符串，但是在模板中就不能这样写了，而应该使用模板语言的写法，布尔值就直接写布尔值，比如说 export=true，而不能写export=”true”，这样肯定会抛参数不匹配的异常。

(4)注意在<@display.column中使用html语句的使用记得把escapXml属性设置为false，否则 displaytag会对其进行转义，freemarker貌似不会默认给其进行转义，除非使用freemarker的转义命令（velocity的 html转义是要通过配置velocity.properties来实现，而且它直接调用了apache common包中的转义操作，这样会默认对2字节以上的字符串都进行转义，于是中文都变成了符号，浏览器能解析而人却不能直接阅读,而spring中的转 义方法就没有这个问题）。
下面是一个例子：

<
@display
.table name=
"products"
 style=
"width:70%;"
 id=
"product"
 cellspacing=
"0"
 
class
=
"table"
                 export=false
  cellpadding=
"0"
 requestURI=
""
>
            <@display
.column title=
"${xtt}"
 escapeXml=
false
 
class
=
"columnClass"
 sortable=
true
 headerClass=
"headerClass"
>
                <input type="checkbox"
 name=
"entityIds"
 id=
"entityIds"
 value=
"${product.id}"
/>
            </@display
.column>
            <@display
.column property=
"id"
 escapeXml=
true
 sortable=
true
 title=
"产品
序号"
 paramId=
"entityIds"
 paramProperty=
"id"
                                    url="/product/prepareUpdateProduct.action"
/>
            <@display
.column property=
"serialNumber"
 escapeXml=
true
 sortable=
true
 title=
"商品编号"
/>
            <@display
.column property=
"name"
 escapeXml=
true
 sortable=
true
  title=
"商品名称"
/>
                <@display
.setProperty name=
"paging.banner.item_name"
 value=
"商品"
/>
                   </@display
.table>

<@display.table name="products" style="width:70%;" id="product" cellspacing="0" class="table"
	   			 export=false  cellpadding="0" requestURI="">
		    <@display.column title="${xtt}" escapeXml=false class="columnClass" sortable=true headerClass="headerClass">
				<input type="checkbox" name="entityIds" id="entityIds" value="${product.id}"/>
		    </@display.column>
		    <@display.column property="id" escapeXml=true sortable=true title="产品序号" paramId="entityIds" paramProperty="id"
		    						url="/product/prepareUpdateProduct.action"/>
		    <@display.column property="serialNumber" escapeXml=true sortable=true title="商品编号"/>
		    <@display.column property="name" escapeXml=true sortable=true  title="商品名称"/>
		        <@display.setProperty name="paging.banner.item_name" value="商品"/>
	   			   </@display.table>

依照上面这些步骤，我相信感兴趣的同学很快就能在freemarker中使用displaytag了，虽然我在freemarker中使用了 displaytag，但是这并不意味着我支持在freemarker任意使用jsptag的观点，比如一些freemarker本身就带有的功能，判 断，循环，日期格式化等等这些根本不需要导入tag，而且我也反对在页面中使用其他input的tag，虽然这样能够带来客户端验证的优点，但是事实上基 于js验证的客户端框架现在也不少，没有必要为了这个理由把页面上弄得到处都是@ww，而且使用theme之后，页面布局更不容易控制，而且最重要的是这 样使页面设计者更难介入了（这一观点是基于很多外包公司都有专门的页面团队，他们是专业的页面制作人员，当如果公司里没有这样一支团队，那么上面这个结论 就不成立了）。