Spring MVC 3.0.5+Spring 3.0.5+MyBatis3.0.4全注解实例详解（五）

这是本系列的最后一篇，主要讲一下FreeMarker模板引擎的基本概念与常用指令的使用方式。     一、FreemMarker基本概念     FreemMarker是一个用Java语言编写的模板引擎，它是一个基于模板来生成文本输出的一个工具。是除了JSP之外被使用得最多的页面模板技术之一，另一个比较有名的模板则是Velocity。     用户可以使用FreeMarker来生成所需要的内容，通常由Java提供数据模型，FreeMarker通过模板引擎渲染数据模型，这样最终得到我们想要的内容。使用FreeMarker作为展示层，访问速度会比较快，因为FreeMarker引擎渲染页面的时候，只需要把数据填充进去就可以了，其它的都是固定的模板内容。另外，使用FreeMarker能够很方便的动态生成静态页面，对于大访问量的网站，配合nginx可以很好的提高网站性能。     在ssm3这个例子中，就是使用的FreeMarker模板技术来实现的视图层。本文主要是对ssm3例子中所使用到的FreeMarker知识点进行介绍，其它更详细的内容还请大家参考官方文档。     在本文的最后有ssm3源码，有需要的朋友可以自行下载，例子是最基本的，方便入门的朋友学习与了解。     二、FreemMarker配置说明     在Spring 3.0框架中，已经集成好了FreeMarker，对它进行了适度的封装，我们使用起来非常方便。要使用FreemMarker模板的功能，只需要进行下面两项配置。     a、FreemMarker视图解析器          当我们发出REST请求访问资源时，当Controller执行完毕，需要返回结果给我们时，那些返回字符串指定的都是结果页面，这时，就通过上面这个解析器，根据返回的那些字符串解析成我们设计的页面。另外，如果要使用Spring提供的FreeMarker宏，还需要加上exposeSpringMacroHelpers这个属性，将它设为true，你可以将这些宏理解为一种功能，或一个方法。     b、FreemMarker环境配置          上面这段配置设置了FreeMarker环境属性，templateLoaderPath指定模板文件存放的路径，它相当于是定义了模板的前缀，所有显示的页面都遵循这个路径规则。还指定了模板文件的编码格式，如果不显示配置，否则会采用系统默认编码，这很容易出现乱码的情况，所以一定要将编码统一设置，不要再使用gb2312或gbk之类的编码方式了，采用国际统一的Unicode UTF-8编码是比较好的习惯。     除了上面我们看到的这些配置设置外，FreeMarkerConfigurer还有一个很重要的属性是freemarkerVariables，它可以用来设置我们自己开发的自定义指令标签，以满足不同的业务需求。     三、FreemMarker指令标记     要想在最终结果页面中填充数据，需要用到FreeMarker标记指令来达到这一目的。不过这些标记指令一般不会单独出现，基本上是多个组合使用，为了让大家方便理解，大象就以ssm3中的一些页面为例子进行说明。     FreeMarker有两种类型：预定义指令和用户自定义指令。预定义指令是以#号开头，用户自定义的指令则使用@开头。而Spring的FreeMarker宏也是以@开头。          指令assign表示定义一个变量，它的格式是<#assign name=value>，在这里ctx是变量名name，value可以是一个值，也可以是一个表达式。还记得FreeMarker解析器中我们设置的requestContextAttribute属性为rc吧，我们现在就是用它来获得我们应用上下文，我们的应用名为ssm3，所以这里就是取得这个值，将它赋给ctx，上面这些都写在meta.html这个模板页面中，这样我们就可以在所有模板页中引用这个变量。     在表达式中，使用了一个!符号，它的作用是如果rc.getContextPath()为null或不存在，就将字符串”/ssm3”作为默认值赋给变量ctx。这样，即使万一因为某些原因无法取得上下文值，我们的ctx变量也不会因此而出现空值或不正确的值，从而引起系统异常。     在使用FreeMarker时，一定要注意一点，FreeMarker绝不允许引用不存在的变量（即变量为null），除非明确地告诉它当变量不存在（null）时如何处理。     上面这一点非常重要，往往很多时候Bug就出在空值未处理上面，请大家使用FreeMarker的时候一定要多加注意。          指令include载入模板页，可以使用它在一个模板中插入另外一个FreeMarker模板文件。          <#if>条件判断指令，list??是否为空判断，如果list不为null才会往下执行。??一般都与if指令一起执行。     <#list list as entity>开始循环遍历，list是model里面定义的属性名称，as是list循环定义变量的语法，entity是list循环变量的名称。${...}它和JSTL里的同一个表达式含义相同。FreeMarker都是在输出时，用实际值替换。