ftl基础语法

FTL常用标签及语法:

一 变量定义 

1. 定义全局变量

<#assign keys=1>

2. 定义局部变量

<#local keys=1>

二  内置函数

1. 判断对象是否存在

如: obj可以是任何类型的对象,像集合,实体类，属性等等

      <#if obj??>....</#if>

      <#if obj??> ...<#else>....</#if>

或者

      <#if obj?exists>....</#if>

      <#if obj?exists> ...<#else>....</#if>

2. 判断是否和某一个值相等

如:  eq(==),gt(>),gte或ge(>=),lt(<),lte或le(<=)

       <#if obj?exists && obj.id==1>....</#if> 

       <#if obj?exists &&  obj.id == 1>...<#else>....</#if> 

注: 必须先判断是否存在，才可比较相等，如果该指定的参数不存在还比较相等的话就回出错;

3. 获取对象值

<#if obj?exists>

//获取普通属性值:${(obj.属性名称)!}

如：${(obj.user_name)!}

//获取日期类值:${(obj.属性名称)!}

如：${(obj.update_time)?string("yyyy-MM-dd HH:mm:ss")}

//获取金额类值:${(obj.属性名称)!}

如：${toYuan((((obj.actual_money)!)?default(0)))?string(",##0.00")}

或 ${toYuan((((obj.actual_money)!)?default(0)))?string("￥,##0.00")//带符号"￥"

</#if> 

4. list循环

 <#if listObj?exists>

//1.获取集合的大小

如:${listObj?size}

//2.遍历集合

<#list listObj  as  obj> 

//3.获取集合遍历序号(从0开始计算)

如:${obj_index}

<#if obj_index == 0>....<#else>...</#if>

//4.参照获取对象值.......

</#list>  

</#if>

5. 变量与指定值相加减

需要先判断该变量是否为数字类型，

?number 然后转换为数字类型再做相减运算

如:变量AA与指定的5相减

<#if obj?exists>

<#if obj.AA?exists && obj.AA?number>

 ${obj.AA?number-5} //减5操作

</#if>

</#if>

6.  变量转换代码 

      ?number转为数字   

      ?c转为字符串   

      ?string转为字符串   

      ?currency（货币）   

     ?percent(百分比)   

     trim 删除字符串首尾空格 ${“  String ”?trim} 结果为String   

     split使用指定的分隔符将一个字符串拆分为一组字符串  

如:

     ${“strabg”?replace(“ab”,”in”)}         结果为string   

     ${“string”?contains(“ing”)?string}    结果为true    注意：布尔值必须转换为字符串才能输出   

     ${“string”?index_of(“in”)                  结果为3  

     ${“string”?index_of(“ab”)                 结果为-1  

    length返回字符串的长度             ${“string”?length}                 结果为6  

    lower_case将字符串转为小写     ${“STRING”?lower_case}     结果为string   

    upper_case将字符串转为大写    ${“string”?upper_case}        结果为STRING   

    ends_with 判断某个字符串是否由某个子串结尾，返回布尔值。   ${“string”?ends_with(“ing”)?string}    返回结果为true   

    html 用于将字符串中的<、>、&和“ 替换为  对应得&lt;&gt;&quot:&amp   

    index_of（substring,start）在字符串中查找某个子串，返回找到子串的第一个字符的索引，如果没有找到子串，则返回-1。   

    Start参数用于指定从字符串的那个索引处开始搜索，start为数字值。   

    如果start大于字符串长度，则start取值等于字符串长度，如果start小于0， 则start取值为   

    如: ${‘str’?substring(0)}     结果为str   

  ${‘str’?substring(0,1)}  结果为s   

    cap_first 将字符串中的第一个单词的首字母变为大写。  ${‘str’？cap_first}    结果为Str   

    uncap_first将字符串中的第一个单词的首字母变为小写。${‘Str’？cap_first}   结果为str   

    capitalize将字符串中的所有单词的首字母变为大写        ${‘str’？ capitalize}   结果为STR   

    date,time，datetime将字符串转换为日期   

如：   

    <#assign date1=”2009-10-12”?date(“yyyy-MM-dd”)>    ${date1}  结果为2009-10-12  

    <#assign date2=”9:28:20”?time(“HH:mm:ss”)>    ${date2} 结果为9:28:20     

    <#assign date3=” 2009-10-12 9:28:20”?time(“HH:mm:ss”)>   ${date3}   结果为2009-10-12 9:28:20 

7.  宏定义hash内置函数代码 

7.1 Hash的内置函数   

1.hash?keys 返回hash里的所有key,返回结果为sequence   

2.hash?values 返回hash里的所有value,返回结果为sequence   

如：   

<#assign user={“name”:“hailang”, “sex”:“man”}>   

<#assign keys=user?keys>   

<#list keys as key>   

${key}=${user[key]}   

</#list>  

三  自定义函数

<#function sum nums>

<#local s = 0>

<#if nums??>

<#list nums as num>

<#local s += num>

</#list>

</#if>

<#return s>

</#function>

调用方式${sum([1,2,3])}

四  自定义指令

<#macro test foo bar baaz> Test text, and the params: ${foo}, ${bar}, ${baaz}</#macro><#-- call the macro: --><@test foo="a" bar="b" baaz=5*5-2/>

输出结果:Test text, and the params: a, b, 23