Freemarker 简介
FreeMarker允许Java servlet保持图形设计同应用程序逻辑的分离,这是通过在模板中密封HTML完成的。模板用servlet提供的数据动态地生成 HTML。模板语言是强大的直观的,编译器速度快,输出接近静态HTML页面的速度。
FreeMarker是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯Java编写
FreeMarker被设计用来生成HTML Web页面,特别是基于MVC模式的应用程序
虽然FreeMarker具有一些编程的能力,但通常由Java程序准备要显示的数据,由FreeMarker生成页面,通过模板显示准备的数据
FreeMarker不是一个Web应用框架,而适合作为Web应用框架一个组件
FreeMarker与容器无关,因为它并不知道HTTP或Servlet;FreeMarker同样可以应用于非Web应用程序环境
FreeMarker更适合作为Model2框架(如Struts)的视图组件,你也可以在模板中使用JSP标记库
Freemarker 开发配置
原本对freemarker了解不多,只知道是一种模板语言,我的个人网站设计时都没有考虑到使用freemarker,而是直接JSP展示。在网站上线推广过程中了解到,各个搜索引擎对动态的链接不够友好,就是说对于网站中XXX.action?name=www.... 这种格式的链接,搜索引擎不予收录,网络蜘蛛更亲奈.html的静态链接,为了便于更方便的网站推广,所以将网站集成URLREWRITER+FREEMARKER 技术改写了全站链接。
现在网站中有两套链接,.action的动态链接,.html的静态链接。链接的改写纯粹是为了便于网站的推广,URLREWRITER过滤器的使用,FREEMARKER模板语言开发,这两块本人将在后续文章中做详细讲解,本文将结合网站详细介绍STRUTS2+FREEMARKER的开发配置。
1、准备相应的JAR包,struts2-core- 2.0.11.2.jar,xwork-2.0.5.jar,ognl-2.6.11.jar,freemarker- 2.3.8.jar,commons-logging-1.0.4.jar
2、解压缩struts2-core-2.0.11.2.jar复制META-INF/struts-tags.tld复制到工程WEB-INF目录下,FREEMARKER中默认是不支持struts2标签的,所以需将标签库导入模板中。
3、修改WEB.XML文件
添加STRUTS2过滤器
Java代码
<filter>
<filter-name>struts2</filter-name>
<filter-class>
org.apacher.sturts2.dispatcher.FilterDispatcher
</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-parttern>/*</url-parttern>
</filter-mapping>
<filter>
<filter-name>struts2</filter-name>
<filter-class>
org.apacher.sturts2.dispatcher.FilterDispatcher
</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-parttern>/*</url-parttern>
</filter-mapping>
Java代码
注意:对于网络上所说的要想在Freemarker中使用Struts2标签必须配置一个新SERVLET
Java代码
<servlet>
<servlet-name>JspSupportServlet</servlet-name>
<servlet-class>
org.apache.struts2.views.JspSupportServlet
</servlet-class>
<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>
在本人的实践中发现这步并非必须的,此处有待深入研究
4、接下来这步应该是最重要的,配置struts.xml文件
Java代码
<action name="getVediosByCategory" class="com.wang.vedio.action.IndexAction" method="getVediosByCategory">
<result name="success">/secondPage.jsp</result>
</action>
<action name="getVediosByCategory" class="com.wang.vedio.action.IndexAction" method="getVediosByCategory">
<result name="success">/secondPage.jsp</result>
</action>
以上ACTIN配置为正常使用STRUTS2的配置,但在结合FREEMARKER中则需做如下改变
Java代码
<action name="getVediosByCategory" class="com.wang.vedio.action.IndexAction" method="getVediosByCategory">
<result name="success" type="freemarker">/WEB-INF/template/secondPage.ftl</result>
</action>
<action name="getVediosByCategory" class="com.wang.vedio.action.IndexAction" method="getVediosByCategory">
<result name="success" type="freemarker">/WEB-INF/template/secondPage.ftl</result>
</action>
注意:<reslutl>元素的type 属性必须设置为freemarker,这是因为Freemarker模板文件必须由Freemarker模板引擎来解析,而Struts2内部实现了 Freemarker模板引擎,但我们必须声明返回结果类型为freemarker才可以
经过以上四步,STRUTS2+FREEMARKER配置完成,可以进行开发应用,下面展示一个简单的实例
Java代码
IndexAction.java
……
private Log log=LogFactory.getLog(IndexAction.class);
private String username;
private String password;
/**
* 登录处理
* @return
* @throws Exception
*/
public String getVediosByCategory() throws Exception{
log.info("执行了登录方法getVediosByCategory()");
return SUCCESS;
}
省略相应(getter,setter方法)
…
IndexAction.java
……
private Log log=LogFactory.getLog(IndexAction.class);
private String username;
private String password;
/**
* 登录处理
* @return
* @throws Exception
*/
public String getVediosByCategory() throws Exception{
log.info("执行了登录方法getVediosByCategory()");
return SUCCESS;
}
省略相应(getter,setter方法)
…
创建登录页面index.jsp
Java代码
<s:form action="getVediosByCategory">
登录名:<s:textfield name="username"/><br>
密码:<s:textfield name="password"/>
<s:submit value="登录" />
</s:form>
<s:form action="getVediosByCategory">
登录名:<s:textfield name="username"/><br>
密码:<s:textfield name="password"/>
<s:submit value="登录" />
</s:form>
创建结果页面:user.ftl
Java代码
<#--
<#assign s=JspTaglibs["/WEB-INF/struts-tags.tld "]>
-->
<html>
<body>
欢迎<@s.property value="username"/>登录!
</body>
</html>
<#--
<#assign s=JspTaglibs["/WEB-INF/struts-tags.tld "]>
-->
<html>
<body>
欢迎<@s.property value="username"/>登录!
</body>
</html>
注意:
1、Struts2标签在JSP 页面中的写法与在Freemarker模板文件中的写法不同。
Freemarker模板文件是以<@s.tag>开始,以</@s.tag>结束
2、Freemarker模板文件的处理,通过Web容器是无法直接处理的,因此不要让用户直接访问模板 文件。在开发过程中,我们可以将Freemarker文件直接放到Web工程的 WEB-INF目录或其子目录下(用户无法访问WEB-INF目录下文件),并在相应的struts-*.xml文件中配置type="freemarker" 来输出模板
FREEMARKER接触不深,如有不足之处请大虾们多多指正