使用FreeMarker模板引擎作为Struts2的视图技术

来源：互联网发布：bp神经网络算法实现编辑：程序博客网时间：2024/05/10 10:06

使用FreeMarker模板引擎作为Struts2的视图技术

　 FreeMarker是一个非常优秀的模板引擎，这个模板引擎可用于任何场景，FreeMarker负责将数据模型中的数据合并到模板中，从而生成标准输出.FreeMarker可以提供昜好的团队协作，对于界面开发人员而言，他们只关心界面（也就是模板文件）的开发，而无需理会底层数据;而对于业务逻辑开发者，他们只需要关心负责将需要显示的数据填入数据模型--FreeMarker负责合并数据模型和模板，从而生成标准输出.

　　FreeMarker特别适应于MVC模式的web应用，虽然FreeMarker具有一些编程能力，但这种编程能力非常有限，无法实现业务逻辑，保能提供一些数据格式的转换。因此，通常由Java程序准备要显示的数据，由FreeMarker模板引擎来生成页面，而FreeMarker模板则则提供页面布局支持，从而能更好地规范MVC架构，保证视图和业务逻辑的分离。

除此之外，FreeMarker也是与web容器，也就是FreeMarker并不一定需要运行在web容器中。FreeMarker同样可以应用于非web应用程序环境。而且，FreeMarker并不是只能生成Html页面，它也可以生成各种文本，如xml,rtf,java程序。

struts2可以非常简单地使用FreeMarker模板作为视图技术，对于传统的jsp页面而言，FreeMarker是一个绝佳的替代方案。

　　除此之外，Struts2默认采用FreeMarker作为其模板文件，而Struts2所有的主题模板文件都是采用FreeMarker编写的。因此，如果我们需要扩展struts2的主题，也需要熟悉FreeMarker技术。

Struts2使用FreeMarker作为其黙认的模板技术，因此Strus2对FreeMarker的支持非常良好。因此，为了在Struts2应用中使用FreeMarker模板技术，只需要在Struts.xml文件中进行简单配置即可。

一.在FreeMarker模板中使用Struts2标签.

　　虽然FreeMarker自己提供了一些FTL指令，可以对数据模型中的数据进行迭代输出，也提供了一定的条件判断能力。但Struts2提供的标签远不止于此，它还提供了一系列的表现标签，例如form标签等。因此，还是需要在FreeMarker模板中使用Strut2标签.

　　在FreeMarker模板中使用标签毕竟不同于在jsp页面中使用标签，因为FreeMarker不支持使用taglib指令来导入标签库。但Struts2为了在FreeMarker模板中使用标签库，提供了额外的支持。

为了在FreeMarker模板中使用标签库，可按如下步骤进行

1.将struts-tags.tld文件复制到WEB-INF目录下

即将系统所需的标签库定义文件(*.tld文件)复制到web应用中。对于基于struts2框架的JAVA_Web应用，则需要将Struts2-core.jar包解压，取出其中的struts-tags.tld文件，并复制到web应用的WEB-INF目录下。

2.在web.xml文件中启动JspSupportServlet

在web.xml文件中作如下配置，如下：

  <servlet> <servlet-name>JspSupportServlet</servlet-name> <servlet-class>org.apache.struts2.views.JspSupportServlet</servlet-class>       <!--配置JspSupportServlet自启动--> <load-on-startup>1</load-on-startup> </servlet>

3. 在FreeMarker模板文件中使用“assign指令”导入标签库

导入标签库的代码如下：

<#--定义web-inf/strust-tags.tld文件对应的标签库前缀为s--> <#assigns=JspTaglibs["/WEB-INF/struts-tags.tld"]/>

说明：在上面导入的标签库定义文件中，指定了标签库前缀为s,而该前缀对应的标签库定义文件主放置在/WEB-INF/struts-tags.tld路径下、

4.完毕

经过上述步骤后，即可在应用的FreeMarker模板中使用Struts2标签。在FreeMarker模板中增加了标签库定义后，就可以在FreeMarker模板中使用Struts2标签了。在FreeMarker使用标签与在jsp中使用标签略有差别.

在FreeMarker模板使用Struts2标签示例如下:

<#assign s=JspTaglibs["/WEB-INF/struts-tags.tld"] /><html><head><title>登录页面</title></head><body>请输入用户名和密码来登陆<br><@s.form action="Login.action"> <@s.textfield name="username" label="用户名"/> <@s.textfield name="password" label="密码"/> <@s.submit value="提交"/></@s.form></body></html>

如果是在jsp中使用Struts2标签，则使用下述代码：

 jsp文件导入struts2的标签库 略<s:form action="Login.action"> <s:textfield name="username" label="用户名"/> <s:textfield name="password" label="密码"/> <s:submit value="提交"/></s:form>

补充说明

　　我们不能直接通过浏览器直接请求该页面，否则看到的不是我们想要的结果，而是该模板页面的源代码（因为WEB容器默认不会处理 FreeMarker模板页面）。

正如前面使用FreeMarker模板作为视图组件时看到的，FreeMarker作为视图组件是由Servlet负责加载该模板，并使用数据模型填充该模板，并且填充后的标准HTML响应输出给浏览者。

　　在Strtus2框架的支持下，Struts2框架充当了之前的Servlet角色，只要浏览者的请求经过了Struts2处理后，Struts2框架就会自动加载FreeMarker模板，并使用数据模型填充该模板，并且将最后的HTML页面输出给浏览者.。

　　为了让所有的用户请求都经过Struts2框架处理，我们将所有的FreeMarker模板文件放在web-inf/ftl路径下.

　　因为浏览者无法直接访问web-inf/ftl路径下的资源，所以我们在struts.xml配置文中增加了如下配置片段：

 <action name="*">           <resulttype="freemarker">/WEB-INF/ftl/{1}.ftl</result>       </action>

在上面配置片段中，配置了一个能匹配所有请求的Action，该Action被映射到一个动态Result,这个动态Result是根据请求来决定的。

因为增加了上面的配置片段，在浏览器中请求login.action，该Action将被转向到login.ftl模板。具体效果如下：

struts.xml文件内容如下：

<?xml version="1.0" encoding="GBK"?><!DOCTYPE struts PUBLIC        "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"        "http://struts.apache.org/dtds/struts-2.0.dtd"><struts> <constant name="struts.i18n.encoding" value="GBK"/>    <package name="ish" extends="struts-default">        <action name="Login" class="ish.LoginAction">            <result name="error" type="freemarker">/WEB-INF/ftl/error.ftl</result>            <result name="success" type="freemarker">/WEB-INF/ftl/welcome.ftl</result>               </action>        <action name="GetBooks" class="ish.GetBooksAction">            <result name="login" type="freemarker">/WEB-INF/ftl/login.ftl</result>            <result name="success" type="freemarker">/WEB-INF/ftl/showBook.ftl</result>               </action>        <action name="*">            <result type="freemarker">/WEB-INF/ftl/{1}.ftl</result>        </action>    </package></struts>

二.使用FreeMarker Result

　　对于Struts2应用中Action而言，使用FreeMarker模板和使用jsp页面作为视图组件没有任何区别,Action一样是取得用户请求参数，处理用户请求，返回一个逻辑视图。

本应用的Action代码如下：

package ish;import com.opensymphony.xwork2.Action;import com.opensymphony.xwork2.ActionContext;public class LoginAction implements Action{    private String username;    private String password;  public String getUsername(){        return username;    }  public void setUsername(String username){        this.username = username;    }  public String getPassword(){        return password;    } public void setPassword(String password){        this.password = password;    } public String execute() throws Exception{      if (getUsername().equals("scott")&& getPassword().equals("tiger") ) {                 ActionContext.getContext().getSession().put("user" , getUsername());                 return SUCCESS;       }else{                 return ERROR;       }    }}

这个Action类与前面的Action类没有任何区别。配置该Action的Result时，需要使用FreeMarker类型的Result,该Result意味着使用FreeMarker模板作为视图组件。

配置该Action的配置片段如下：

<action name="Login" class="ish.LoginAction">            <result name="error" type="freemarker">/WEB-INF/ftl/error.ftl</result>            <result name="success" type="freemarker">/WEB-INF/ftl/welcome.ftl</result>       </action>

从上面的Action类代码看出，当用户输入的用户名为scott,密码为tiger时，即可完成转入success逻辑视图。

success对应的视图为/web-inf/ftl/welcome.ftl模板

该模板的代码如下：

<html>    <head>        <title>成功页面</title>    </head>    <body>        欢迎，${user},您已经登录!<br> <a href="GetBooks.action">查看作者李刚已出版的图书</a>    </body></html>

当点击查看链接时，转入GetBooks.action，即

GetBooks对应的Action 代码如下：

package ish;import com.opensymphony.xwork2.Action;import com.opensymphony.xwork2.ActionContext;public class GetBooksAction implements Action{ //用于初始化books属性的初始化块 //静态块 在类加载的时候，就先加载到内存中了 {  books = new String[]{   "Spring2.0宝典" ,   "轻量级J2EE企业应用实战",   "基于J2EE的Ajax宝典",   "Struts,Spring,Hibernate整合开发"  }; } //用于封装全部图书的属性 private String[] books; //返回books属性的getter方法 public String[] getBooks() {  return books; } //用于用户请求的execute方法 public String execute() throws Exception {  String user = (String)ActionContext.getContext().getSession().get("user");  if (user != null && user.equals("scott"))  {   return SUCCESS;  }  else  {   return LOGIN;  }    }}

配置该Action的配置片段如下:

<action name="GetBooks" class="ish.GetBooksAction">            <result name="login" type="freemarker">/WEB-INF/ftl/login.ftl</result>            <result name="success" type="freemarker">/WEB-INF/ftl/showBook.ftl</result>               </action>

showBook.ftl模板文件对应的代码如下:

<html>    <head>        <title>作者李刚的图书</title>    </head>    <body> <table border="1" width="360"> <caption>作者李刚的图书</caption> <#list books as book> <tr>  <td>书名：</td>  <td>${book}</td> </tr> </#list> </table>    </body></html>

转载自：http://blog.sina.com.cn/s/blog_4c925dca0100h3kr.html

0 0