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

最新推荐文章于 2018-09-06 15:04:22 发布

zolalad

最新推荐文章于 2018-09-06 15:04:22 发布

阅读量6.9k

点赞数

分类专栏： JavaEE 文章标签： FreeMarker 模板引擎 Struts2 视图技术

JavaEE 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

使用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

zolalad

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
使用FreeMarker模板引擎作为Struts2的视图技术

使用FreeMarker模板引擎作为Struts2的视图技术　　Struts2使用FreeMarker作为其黙认的模板技术，因此Strus2对FreeMarker的支持非常良好。因此，为了在Struts2应用中使用FreeMarker模板技术，只需要在Struts.xml文件中进行简单配置即可。一.在FreeMarker模板中使用Struts2标签.　　虽然FreeMarker自己提
复制链接

扫一扫

专栏目录