一、背景
1、什么是FreeMarker
FreeMarker是一个模板引擎，一个基于模板生成文本输出的通用工具，使用纯Java编写
FreeMarker被设计用来生成HTML Web页面，特别是基于MVC模式的应用程序
虽然FreeMarker具有一些编程的能力，但通常由Java程序准备要显示的数据，由FreeMarker生成页面，通过模板显示准备的数据（如下图） 
2、FreeMarker特性
- 能够生成各种文本：HTML、XML、RTF、Java源代码等等
- 易于嵌入到你的产品中：轻量级；不需要Servlet环境
- 插件式模板载入器：可以从任何源载入模板，如本地文件、数据库等等
- 你可以按你所需生成文本：保存到本地文件；作为Email发送；从Web应用程序发送它返回给Web浏览器
二、整合
本示例是在spring的基础上整合freeMarker,所以对于spring的部分配置不重点关注；
1、项目目录结构
其中：springmvc-servlet是spring与freeMarker整合配置文件，而WEB-INF下的文件夹中，ftl为freeMarker的模板，jsp为spring的模板，resource为一些静态文件；
2、pom.xml中加入freeMarker的依赖
<!-- freemarker模板 -->
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.23</version>
</dependency>
3、springmvc-servlet中的配置
<!-- 配置Jsp视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.InternalResourceView" />
<property name="prefix" value="/WEB-INF/jsp/" />
<property name="suffix" value=".jsp" />
<property name="order" value="1" />
</bean> <!-- 配置freeMarker的模板路径 -->
<bean class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
<property name="templateLoaderPath" value="/WEB-INF/ftl/" /><!--注意这儿不要添加classpath-->
<property name="defaultEncoding" value="utf-8" />
<property name="freemarkerVariables">
<map>
<entry key="xml_escape" value-ref="fmXmlEscape" />
</map>
</property>
<property name="freemarkerSettings">
<props>
<prop key="template_update_delay">0</prop>
<prop key="default_encoding">UTF-8</prop>
<prop key="number_format">0.##########</prop>
<prop key="date_format">yyyy-MM-dd</prop>
<prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop>
<prop key="locale">zh_CN</prop>
<prop key="classic_compatible">true</prop>
<prop key="template_exception_handler">ignore</prop>
</props>
</property>
</bean>
<bean id="fmXmlEscape" class="freemarker.template.utility.XmlEscape"/> <!-- 配置freeMarker视图解析器 -->
<bean class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.freemarker.FreeMarkerView"/>
<property name="contentType" value="text/html;charset=UTF-8"></property>
<property name="requestContextAttribute" value="request" />
<property name="exposeSpringMacroHelpers" value="true" />
<property name="exposeRequestAttributes" value="true" />
<property name="exposeSessionAttributes" value="true" />
<property name="cache" value="true" />
<property name="prefix" value="" />
<property name="suffix" value=".ftl" />
<property name="order" value="0"/>
</bean>
其中：
1）jsp视图解析器与freeMarker视图解析器中的order属性，只有在spring项目多视图时才配置。上面配置中把freemarker的order设置为0，jsp为1。意思是找view时，先找ftl文件，再找jsp文件做为视图；
2）我感觉配置中最重要的属性是templateLoaderPath，即ftl模板的位置。没有这个属性的支持，其他的属性不起作用。我按照网上的一个配置给他的value加了classPaht,结果spring找不到ftl模板位置，让我吃了不少苦头。所以classPath不能有。我的建议是，在spring整合freeMarker时，暂时先不用管jsp是不是404，freeMarker配置完成后，先来一个小示例，如果跳转之后，出现404并且路径后面有jsp，那证明要么是templateLoaderPath属性有问题，要么是order属性有问题。而且跳转成功后看看flt页面${}中的数据有没有解析，如果没有也是不成功的。等到ftl页面显示正常，再考虑jsp与ftl两种视图共存的问题吧。
4、ftl模板。在WEB-INF/ftl下新建test.ftl
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>测试</title>
</head>
<body> 姓名：${userName}
<br/>
年龄：${userAge} </body>
</html>
5、后端代码。跳转到test.ftl
@Controller
public class FreemarkerController { @RequestMapping("/test")
public String sayHello1(ModelMap map){
map.put("userName","小明");
map.put("userAge",23);
return "test";
} }
6、浏览器显示
备注：Idea和Eclipse为了开发方便，都有ftl的插件，各位有兴趣可以看看。
到此为止，已经成功整合了SpringMVC和Freemarker！