6.2 freemarker 视图技术使用介绍
freemarker 和 velocity 一样也是一种可以替代 JSP 的视图技术。而且 Struts2 中对它的支持要比对 velocity 也强大的多。下面就对它进行介绍。
技术要点
本节代码说明 freemarker 在 Struts2 中使用方式。
freemarker 基本语义和书写格式说明。
模板文件 ftl 介绍 。
Struts2 中如何使用 freemarker 。
演示代码
显示数据的 ftl 模板文件代码:
- <!-------------------文件名:show.ftl------------->
- <html>
- <head>
- <title>FreeMarker使用范例</title>
- <meta http-equiv= "content-type" content= "text/html; charset=GB2312" />
- </head>
- <body>
- <h3 align= "left" >
- FreeMarker使用范例
- </h3>
- <h1>装修材料信息列表</h1>
- <table border>
- <tr align= "center" >
- <td>材料名</td>
- <td>材料价格(单位:元)</td>
- <td>材料库存量(单位:个)</td>
- </tr>
- <#list mList as Material>
- <tr align= "center" >
- <td>${Material.material}</td>
- <td>${Material.bid}</td>
- <td>${Material.mount}</td>
- </tr>
- </#list>
- </table>
- </body>
- </html>
<!-------------------文件名:show.ftl-------------> <html> <head> <title>FreeMarker使用范例</title> <meta http-equiv="content-type" content="text/html; charset=GB2312"/> </head> <body> <h3 align="left"> FreeMarker使用范例 </h3> <h1>装修材料信息列表</h1> <table border> <tr align="center"> <td>材料名</td> <td>材料价格(单位:元)</td> <td>材料库存量(单位:个)</td> </tr> <#list mList as Material> <tr align="center"> <td>${Material.material}</td> <td>${Material.bid}</td> <td>${Material.mount}</td> </tr> </#list> </table> </body> </html>
Action 代码同 velocity 示例中 Action 代码,这里就不显示了。读者自行阅读。
配置文件对 Action 的配置内容:
- <!-----------文件名:struts.xml----------->
- ………
- < package name= "C06.1" extends = "struts-default" >
- <action name= "velocity"
- class = "action.VelocityAction" >
- <result name= "success" type= "freemarker" >/velocity/show.vm</result>
- </action>
- </ package >
<!-----------文件名:struts.xml-----------> ……… <package name="C06.1" extends="struts-default"> <action name="velocity" class="action.VelocityAction"> <result name="success" type="freemarker">/velocity/show.vm</result> </action> </package>
对支持中文字符的字符编码集设置也如 velocity 示例。示例效果显示如图 6.2 。
图 6.2 freemarker 显示效果图
代码解释
( 1 )本节示例也是将一些装修材料用 list 形式显示在页面上。只不过现在使用的是 freemarker 。它其实是将 JAVA 代码中定义好的类,在底层使用 map 类型显示在页面上。因此在 ftl 模板中看见的“ # ”标识除了表明控制转向之外,其他都是 map 的 key 值,而每个 key 值对应的 value 就是 JAVA 中定义的类,这些类有可能是 JavaBean 也有可能像本示例中的材料列表一样是 list 和其他数据集合类。“ $ ”标识和 velocity 中“ $ ”标识类似是用来标识具体对象或变量。
( 2 ) freemarker 模板文件后缀名都是“ ftl ”结尾。它也可以在文件中定义各种各样的 html 标签和代码。不过它要调用 Struts2 的标签则调用方法要比 vm 文件调用 Struts2 标签要稍微复杂点。
首先在它的文件头部使用 assign 来导入 Struts2 的标签定义。代码如下:
- <#assign s=JspTagLibs[“/WEB-INF/struts-tags.tld”]/>
<#assign s=JspTagLibs[“/WEB-INF/struts-tags.tld”]/>
另外在每次调用 Struts2 标签时候前面要加上“ @ ”。
( 3 )在 Struts2 中使用 freemarker 技术,首先要在项目中导入 freemarker 的 jar 包。 struts.xml 文件中,同样笔者用黑体注明了 result 的返回类型必须是“ freemarker ”,这样才可以调用 ftl 模板文件。关于中文字符支持问题的解决方法也如笔者介绍 velocity 的小节中相同。
注意: ftl 文件中对英文字符的大小写是很敏感的,因此对某些对象和变量的定义时候,请读者注意大小写问题。