《SSM框架实战》整合 Freemarker

FreeMarker是一款模板引擎：即一种基于模板和要改变的数据，并用来生成输出文本（HTML网页、电子邮件、配置文件、源代码等）的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。

FreeMarker是免费的，基于Apache许可证2.0版本发布。其模板编写为FreeMarker Template Language（FTL），属于简单、专用的语言。需要准备数据在真实编程语言中来显示，比如数据库查询和业务运算，之后模板显示已经准备好的数据。在模板中，主要用于如何展现数据，而在模板之外注意于要展示什么数据。

优点

1、不能编写java代码，可以实现严格的mvc分离
2、性能非常不错
3、对jsp标签支持良好
4、内置大量常用功能，使用非常方便
5、宏定义（类似jsp标签）非常方便
6、使用表达式语言

缺点

1、不是官方标准
2、用户群体和第三方标签库没有jsp多

选择freemarker的原因

1、性能。velocity应该是最好的，其次是jsp，普通的页面freemarker性能最差（虽然只是几毫秒到十几毫秒的差距）。但是在复杂页面上（包含大量判断、日期金额格式化）的页面上，freemarker的性能比使用tag和el的jsp好。
2、宏定义比jsp tag方便
3、内置大量常用功能。比如html过滤，日期金额格式化等等，使用非常方便
4、支持jsp标签
5、可以实现严格的mvc分离

6、易学易用

我是看了一天文档就用得挺熟练了，freemarker文档写得太好了，例子丰富，照做一遍全都会了。

7、功能强大
比Velocity强大多了，还支持JSP Tag。不过最有意义的是macro功能，可以自定义常用的macro，实现页面常规操作的可复用性。

8、报错信息友好
很多应用服务器的JSP报错信息是无法定位到源代码行的。不过freemarker报错定位很准确，丝毫不差，而且信息丰富，一看就知道怎么回事(虽然那个黄黄的页面看起来让人难受)

与JSP相比，FreeMarker的一个优点在于不能轻易突破模板语言开始编写Java代码，因此降低了领域逻辑漏进视图层的危险几率。但缺点是需要一点附加配置来将其平稳地集成到应用程序中，一些IDE（集成开发环境）可能并不完全支持它，当然还有开发者或设计者也许需要学习一门陌生的模板语言。相关的JAR文件将要添加到WEB-INF/lib（在需要的时候，它们包含在Spring中）。

整合 Freemarker

1、添加依赖包，在 pom.xml 文件中的；

dependencies

节点下加入

     <!-- https://mvnrepository.com/artifact/org.freemarker/freemarker --><dependency><groupId>org.freemarker</groupId><artifactId>freemarker</artifactId><version>2.3.23</version></dependency>

2、web.xml 文件配置不需要更改；

3、在 spring-mvc.xml 中添加配置，有人可能习惯用 applicationContext.xml，这个文件名具体用什么是在 web.xml 中指定的；

 <!-- 配置freeMarker视图解析器 -->  <bean id="viewResolverFtl" 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 name="cache" value="false" />  <property name="suffix" value=".ftl" />  <property name="order" value="0"/><property name="requestContextAttribute" value="request"/></bean>  <!-- 配置freeMarker的模板路径 -->  <bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">  <property name="templateLoaderPath">  <value>/</value>  </property>  <property name="freemarkerVariables">  <map>  <entry key="xml_escape" value-ref="fmXmlEscape" />  </map>  </property>  <property name="defaultEncoding">  <value>utf-8</value>  </property>  <property name="freemarkerSettings">  <props>  <prop key="template_update_delay">0</prop>  </props>  </property>  </bean>  <bean id="fmXmlEscape" class="freemarker.template.utility.XmlEscape"/>

注意 template_update_delay 的配置，我这里使用 0 是因为在开发过程中经常需要修改测试，防止缓存；否则的话每次修改模板都需要重启或等待超时后才会使用修改后的模板内容，非常不方便测试！