◆ Freemarker 标签完全解析
1. assign
assign指令在前面已经使用了多次,它用于为该模板页面创建或替换一个顶层变量,assign指令的用法有多种,包含创建或替换一个顶层变量,或者创建或替换多个变量等。
示范代码:
<#assign x>
<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as n>
${n}
</#list>
</#assign>
2. break
<#break>指令用于跳出迭代
例子如下:
<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>
${x_index + 1}.${x}<#if x_has_next>,</if>
<#if x="星期四"><#break></#if>
</#list>
3. case
switch , case , default , break这些指令显然是分支指令,作用类似于Java的switch语句,switch指令的语法结构如下:
<#switch x>
<#case x = 1>
1
<#case x = 2>
2
<#default>
d
</#switch>
如果x=1 输出 1 2, x=2输出 2, x=3 输出d
4. default
switch , case , default , break这些指令显然是分支指令,作用类似于Java的switch语句,switch指令的语法结构如下:
<#switch x>
<#case x = 1>
1
<#case x = 2>
2
<#default>
d
</#switch>
如果x=1 输出 1 2, x=2输出 2, x=3 输出d
4. else
这是一个典型的分支控制指令,该指令的作用完全类似于Java语言中的if,if指令的语法格式如下:
例子如下:
<#assign age=23>
<#if (age>60)>老年人
<#elseif (age>40)>中年人
<#elseif (age>20)>青年人
<#else> 少年人
</#if>
5. elseif
这是一个典型的分支控制指令,该指令的作用完全类似于Java语言中的if,if指令的语法格式如下:
例子如下:
<#assign age=23>
<#if (age>60)>老年人
<#elseif (age>40)>中年人
<#elseif (age>20)>青年人
<#else> 少年人
</#if>
6. escape
escape指令导致body区的插值都会被自动加上escape表达式,但不会影响字符串内的插值,只会影响到body内出现的插值。
示范代码:
<#escape x as x?html>
First name:${firstName}
Last name:${lastName}
Maiden name:${maidenName}
</#escape>
7. if
这是一个典型的分支控制指令,该指令的作用完全类似于Java语言中的if,if指令的语法格式如下:
例子如下:
<#assign age=23>
<#if (age>60)>老年人
<#elseif (age>40)>中年人
<#elseif (age>20)>青年人
<#else> 少年人
</#if>
8. import
该指令用于导入FreeMarker模板中的所有变量,并将该变量放置在指定的Map对象中。
示范代码:
<#import "/libs/mylib.ftl" as my>
8. include
include指令的作用类似于JSP的包含指令,用于包含指定页。
示范代码:
<#include "/common/copyright.ftl" encoding=”GBK”>
9. list
list指令是一个迭代输出指令,用于迭代输出数据模型中的集合。
示范代码:
<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>
${x_index + 1}.${x}<#if x_has_next>,</if>
<#if x="星期四"><#break></#if>
</#list>
10. macro
macro可以用于实现自定义指令,通过使用自定义指令,可以将一段模板片段定义成一个用户指令。
示范代码:
<#macro book booklist> //定义一个自定义指令booklist是参数
<#list booklist as book>
${book}
</#list>
</#macro>
11. nested
和macro标签一起使用, 在nested指令中使用循环变量时,可以使用多个循环变量,看如下代码:
<#macro repeat count>
<#list 1..count as x> //使用nested指令时指定了三个循环变量
<#nested x, x/2, x==count>
</#list>
</#macro>
<@repeat count=4 ; c halfc last>
${c}. ${halfc}<#if last> Last! </#if>
</@repeat>
12. noescape
对于放在escape指令中所有的插值而言,这此插值将被自动加上escape表达式,如果需要指定escape指令中某些插值无需添加escape表达式,则应该使用noescape指令,放在noescape指令中的插值将不会添加escape表达式.
示范代码:
<#escape x as x?html>
First name:${firstName}
<#noescape>Last name:${lastName}</#noescape>
Maiden name:${maidenName}
</#escape>
13. noparse
noparse指令指定FreeMarker不处理该指定里包含的内容。
示范代码:
<#noparse>
<#list books as book>
<tr><td>${book.name}<td>作者:${book.author}
</#list>
</#noparse>
14. return
return指令用于结束macro指令,一旦在macro指令中执行了return指令,则FreeMarker不会继续处理macro指令里的内容,看如下代码:
<#macro book>
spring
<#return>
j2ee
</#macro>
<@book />
上面的代码输出:spring,而j2ee位于return指令之后,不会输出.
16. setting
用来设置整个系统的一个环境。
示范代码:
${1.2}
<#setting locale="en_US">
${1.2}
输出
1,2
1.2
17. switch
switch , case , default , break这些指令显然是分支指令,作用类似于Java的switch语句,switch指令的语法结构如下:
<#switch x>
<#case x = 1>
1
<#case x = 2>
2
<#default>
D
</#switch>
如果x=1 输出 1 2, x=2输出 2, x=3 输出d
18. 字符串处理
各种处理字符串的方法,有:
html安全输出、substring的用法、类似String.split的用法、取得字符串长度、大写输出字符、小写输出字符、首字符大写、首字符小写、去掉字符串前后空格、每个单词的首字符大写、类似String.indexof:、类似String.lastIndexOf 、替换字符串 replace等
19. 对象是不是null
判断对象是不是null <#if mouse?exists>
Mouse found
<#else>
也可以直接${mouse?if_exists})输出布尔形