FTL自己用得比较少,这里做个备份记录,以免忘记。
Freemarker这里先扯淡两句,在单纯的页面使用上来说和JSP个人感觉没有太大的区别,都有比较多的类库支持,不过相对的如果FTL没有做静态化相对的还是JSP的速度要快一些。但是为什么还是有很多项目用freemarker,网上也有很多文章,这里偷个懒,传送门:
我这里比较传统用的IDE工具是Myeclipse2014,所有如果想要有ftl格式的东东高亮支持的话需要配置下插件,同样的网上一大把,这里也偷懒了,传送门:
在项目中,Spring是支持多个前段引擎的,只是需要在Spring的配置文件中去配置一下,就可以同时支持JSP和FLT了。除了Spring需要的jar外还需要Freemarker的jar支持,这里我用的完整的XML
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="; xmlns:xsi="; xmlns:p="; xmlns:context="; xmlns:mvc="; xsi:schemaLocation=" /spring-beans-3.0.xsd /spring-context-3.0.xsd /spring-mvc-3.0.xsd"> <!-- 开启springmvc的注解支持 --> <mvc:annotation-driven conversion-service="tc" /> <!-- 定义静态资源 --> <mvc:resources location="/static/" mapping="/static/**" /> <!-- 制定扫描规则 --> <context:component-scan base-package="com"> <!-- 制定过滤器 --> <context:include-filter type="annotation" expression="org.; /> <context:exclude-filter type="annotation" expression="org.; /> <context:exclude-filter type="annotation" expression="org.; /> </context:component-scan> <!-- 可以配置一个全局类型转换器 --> <!-- 配置spring定义的转换工厂类 --> <bean id="tc" class="org.;> <property name="converters"> <set> <bean class="com.lovo.conver;></bean> </set> </property> </bean> <!-- 配置http消息体数据与JSON转换 --> <bean class="org.;> <property name="messageConverters"> <list> <ref bean="mappingJackson2HttpMessageConverter"></ref> </list> </property> </bean> <!-- 配置HTTP消息信息与JSON对象之间的一个转换器 --> <bean id="mappingJackson2HttpMessageConverter" class="org.;> </bean> <!-- 视图解析器 JSP --> <bean id="urlBasedViewResolver" class="org.;> <property name="viewClass" value="org.;></property> <property name="prefix" value="/WEB-INF/jsp/"></property> <property name="suffix" value=".jsp"></property> <property name="order" value="1"/> </bean> <!-- 视图解析器 FTL --> <bean id="viewResolverFtl" class="org.;> <property name="viewClass" value="org.;/> <property name="contentType" value="text/html; charset=UTF-8"/> <!-- 将请求和会话属性作为变量暴露给FreeMarker模板使用。要做到这一点, 可以设置exposeRequestAttributes或者exposeSessionAttributes为true --> <property name="exposeRequestAttributes" value="true" /> <property name="exposeSessionAttributes" value="true" /> <!-- 使用这些宏,必须设置FreeMarkerViewResolver的exposeMacroHelpers属性为true --> <property name="exposeSpringMacroHelpers" value="true" /> <!-- 使用缓存 --> <property name="cache" value="true" /> <property name="suffix" value=".ftl" /> <property name="order" value="0"/> </bean> <!-- 配置freeMarker的模板路径 --> <bean id="freemarkerConfig" class="org.;> <property name="templateLoaderPath" value="/WEB-INF/ftl/"/> <property name="freemarkerVariables"> <map> <entry key="xml_escape" value-ref="fmXmlEscape" /> </map> </property> <property name="defaultEncoding" value="UTF-8"/> <!-- FreeMarker默认每隔5秒检查模板是否被更新,如果已经更新了,就会重新加载并分析模板。 但经常检查模板是否更新可能比较耗时。如果你的应用运行在生产模式下,而且你预期模板不会经常更新, 则可以将更新的延迟时间延长至一个小时或者更久。 可以通过为freemarkerSettings属性设置template_update_delay达到这一目的 --> <property name="freemarkerSettings"> <props> <prop key="template_update_delay">3600</prop> <!-- 设置标签类型 两种:[] 和 <> 。[] 这种标记解析要快些 --> <prop key="tag_syntax">auto_detect</prop> <prop key="default_encoding">UTF-8</prop> <prop key="output_encoding">UTF-8</prop> <prop key="locale">zh_CN</prop> <!-- 设置时间格式 --> <prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop> <prop key="date_format">yyyy-MM-dd</prop> <!-- 设置数字格式 --> <prop key="number_format">#.##</prop> <!-- 可以满足一般需要。默认情况变量为null则替换为空字符串,如果需要自定义,写上${empty!"EmptyValue of fbysss"}的形式即可 --> <prop key="classic_compatible">true</prop> </props> </property> </bean> <bean id="fmXmlEscape" class=";/> <!-- 配置MultipartResolver 用于文件上传 使用spring的CommosMultipartResolver 说明: p:defaultEncoding="UTF-8":这里设置默认的文件编码为UTF-8,必须与用户JSP的默认编码一致; p:maxUploadSize="5000000":指定文件上传大小,单位为字节; p:uploadTempDir="fileUpload/temp":文件上传临时目录,上传完成后,就会将临时文件删除; --> <bean id="multipartResolver" class="org.; p:defaultEncoding="UTF-8" p:maxUploadSize="5000000" p:uploadTempDir="fileUpload/temp"> </bean> </beans>
需要注意一下的是如果只需要FTL作为模板不作为前段引擎,可以不配置视图解析器,如果配置了多个视图解析器,其他视图解析器的优先级一定要高于JSP才行。
<property name="order" value="0"/>
配置完了后写个简单的controller,用法和传统的后台封装参数,前台写JSP写EL表达式一样
import javax.; import javax.; import org.; import org.; import org.; import org.; import org.; @Controller @RequestMapping(value="/ftl") public class ftlController { @RequestMapping(value=";,method=Reque) public String index(HttpServletRequest requset,HttpServletResponse response,Model mode) { mode.addAttribute("msg", "hi freemarker"); return "MyFtl"; } }
<!DOCTYPE html> <html> <head> <title>MyH;/title> <meta name="keywords" content="keyword1,keyword2,keyword3"> <meta name="description" content="this is my page"> <meta name="content-type" content="text/html; charset=UTF-8"> <!--<link rel="stylesheet" type="text/css" href=".;>--> </head> <body> <b>${msg}</b> </body> </html>
首先科普下
FreeMarker模板文件主要有4个部分组成
1、文本,直接输出的部分 2、注释,即<#--...-->格式不会输出 3、插值(Interpolation):即${..}或者#{..}格式的部分,将使用数据模型中的部分替代输出 4、FTL指令:FreeMarker指令,和HTML标记类似,名字前加#予以区分,不会输出。
Freemarker支持各种后台的常用类型,页面也支持条件判断,逻辑运算,首先,我们测试下最常用的后台封装list,前台循环出来,在通过条件去判断
@RequestMapping(value=";) public String expressionTest(HttpServletRequest requset,HttpServletResponse response,Model mode) { //页面测试用集合,简单数据类型 List<Object> testList = new ArrayList<Object>(); ("1"); ("2"); ("3"); mode.addAttribute("list",testList); return "expressionTest"; }
<!DOCTYPE html> <html> <head> <title>MyH;/title> <meta name="keywords" content="keyword1,keyword2,keyword3"> <meta name="description" content="this is my page"> <meta name="content-type" content="text/html; charset=UTF-8"> <!--<link rel="stylesheet" type="text/css" href=".;>--> </head> <body> <div > <#--在jsp中${}表达式会直接忽略不显示,而freemarker会报异常,还是一大堆,freemarker就需要您手动去处理--> <#-- ?? 用于判断是否为空 ?number将字符串转换为数字--> <#if list??> <span>集合长度:${list?size} </span><br> <#list list as a > 集合的下标:${a_index} 当前集合值:${a} <#if a?number%2==0>偶数 <#else>奇数 </#if> <br> </#list> <#else> 集合为空 </#if> </div> </body> </html>
这里可以发现在用JSP的过程中我们一般不会对null值进行特殊的处理判断,JSP默认会处理,当为null时显示为空。但是在FLT模板中并不会这样,如果未进行非空判断,而直接进行取值,会抛出异常。通常有两种方式进行处理。
例如现在有个user对象,里面有角色属性方式
1:配置classic_compatible=true,此种方式只能判断一层,如u为null,显示为空,若user为空,则仍会发生异常。
方式2:使用!或者??
${list!'集合为空'}
如果集合为空会显示空
?? 用于判断是否为空
<#if u??> 当前用户没有权限角色 <#else> 当前用户有权限角色 </#if>
${u???string}<#--这里将结果以字符串的形式输出:true 或者false--> ${u???string("YES","NO")} <#--这判定用户权限角色为空 -->
${u!"当前用户没有角色"} <#--获取当前用户的角色:${u.rolename!} 而role任然没值的时候依然会报错,而正确的方式<br/>获取当前用户的角色:${(u.rolename)!}-->
来完整的处理个null,首先建立一个简单的user对象
package com.lovo.beans; import java.io.Serializable; public class UserBean implements Serializable{ /** * 省略get set方法 */ private static final long serialVersionUID = -2959897964759682757L; private Long id; private String name; private String sex; private Long age; }
控制器
@RequestMapping(value=";) public String expressionUset(HttpServletRequest requset,HttpServletResponse response,Model mode) { UserBean bean = new UserBean(); bean.setName("小明"); bean.setAge(20L); bean.setSex(null); //不对classBean做null处理 bean.setClassBean(null); mode.addAttribute("user", bean); return "expressionUser"; }
FTL模板
<!DOCTYPE html> <html> <head> <title>MyH;/title> <meta name="keywords" content="keyword1,keyword2,keyword3"> <meta name="description" content="this is my page"> <meta name="content-type" content="text/html; charset=UTF-8"> <!--<link rel="stylesheet" type="text/css" href=".;>--> </head> <body> <div > 姓名:<input type = "text" value="${u}"/><br> 性别:<input type = "text" value="${u}"/><br> 年龄:<input type = "text" value="${u}"/><br> 班级:<input type = "text" value="${u}"/> </div> </body> </html>
会发现报错
这个时候用!和??处理下!是直接做null判断,后面可以跟值,如果不写,显示为空字符串,??是做是否为空判断,多用作if else中,也可以输出默认值???需用???string("yes","no")
<!DOCTYPE html> <html> <head> <title>MyH;/title> <meta name="keywords" content="keyword1,keyword2,keyword3"> <meta name="description" content="this is my page"> <meta name="content-type" content="text/html; charset=UTF-8"> <!--<link rel="stylesheet" type="text/css" href=".;>--> </head> <body> <div > 姓名:<input type = "text" value="${u}"/><br> 性别:<input type = "text" value="${u}"/><br> 年龄:<input type = "text" value="${u!}"/><br> 班级:<input type = "text" value="${(u)!}"/> 班级:<input type = "text" value="<#if (u)??></#if>"/> 班级:<input type = "text" value="${(u)???string("班级不为空","班级为空")}"/> </div> </body> </html>
在页面使用FTL时,不可避免的会操作变量,在Freemarker中变大大致可以分为4种。
- 数据模型变量,后台封装的变量参数传递到模板中
- 模板中的变量使用,用<#assign>定义
- 局部变量,在指令中的变量
- 循环变量,在循环中的变量
数据模型变量,可以在后台封装成对象,list,map等,这里举例字符串
@RequestMapping(value=";) public String expressionAssagin(HttpServletRequest requset,HttpServletResponse response,Model mode) { mode.addAttribute("root", "后台封装的变量"); return "expressionAssagin"; }
<b>${root}</b>
页面显示
<#assign>定义的变量
<body> 后台封装的变量:<b>${root}</b></br> 页面定义的变量: <#assign username="李四"> ${username} </body>
当页面定义的assign变量名与数据模型变量名相同时,优先展示页面定义的assign变量,不是覆盖数据模型变量,可以使用.globals进行展示
<body> <#assign root="页面变量优先于数据模型变量展示"> 优先展示:<b>${root}</b></br> 指定展示:<b>${.globals.root}</b></br> 页面定义的变量: <#assign username="李四"> ${username} </body>
局部变量
<body> <#assign root="页面变量优先于数据模型变量展示"> 优先展示:<b>${root}</b></br> 指定展示:<b>${.globals.root}</b></br> 页面定义的变量: <#assign username="李四"> ${username}<br> <#--使用local可以声明局部变量,所以在marco宏中局部变量--> <#macro test> <#--此时当调用该指令之后,会将模板中的变量覆盖,不能使用globals,一般不使用这种方式在指令中定义变量--> <#local username="我的名字变了"/> <#local sex="性别是保密的"/> 姓名:${username!} 性别${sex!}</br> </#macro> <#--调用宏--> <@test/> ${sex!"局部变量外部是调用不到的"} </body>
循环变量,就是在循环体中使用的变量
<#--循环变量--> <#list 1..3 as num> <#--只能在循环体中使用--> ${num} </#list> ${num!"循环变量出了循环体就消失了"}