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