首页 > 代码库 > Spring MVC 3.0.5+Spring 3.0.5+MyBatis3.0.4全注解实例详解(五)
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都是在输出时,用实际值替换。