`
soongbo
  • 浏览: 88564 次
  • 性别: Icon_minigender_1
  • 来自: 杭州
社区版块
存档分类
最新评论

Freemarker语法

    博客分类:
  • Java
阅读更多
常用语法
EG.一个对象BOOK
1.输出 $…{book.name}
空值判断:$…{book.name?if_exists },
$…{book.name?default(‘xxx’)}//默认值xxx
$…{ book.name!”xxx”}//默认值xxx
日期格式:$…{book.date?string(’yyyy-MM-dd’)}
数字格式:$…{book?string.number}–20
$…{book?string.currency}–<#-- $20.00 -->
$…{book?string.percent}—<#-- 20% -->
插入布尔值:
<#assign foo=true />
$…{foo?string(”yes”,”no”)} <#-- yes -->

】内置方法

一:数字型
<#assign answer=42/>
$…{answer}
$…{answer?string} <#-- the same as $...{answer} -->
$…{answer?string.number}
$…{answer?string.currency}
$…{answer?string.percent}

<#setting number_format="0.###E0"/>

$…{12345?string(”0.####E0″)}

$…{answer?string(”number”)} 等同于:$…{answer?string.number}.

二:日期型:
预定义格式包括:short ,middle和long。

$…{openingTime?string.short}
$…{openingTime?string.medium}
$…{openingTime?string.long}
组合使用:$…{lastUpdated?string.short_long}
$…{lastUpdated?string(”yyyy-MM-dd HH:mm:ss zzzz”)}

三:逻辑型
foo?string
foo?string(”yes”, “no”)

四:序列的内置方法:
first

last

seq_contains
$…{x?seq_contains(”blue”)?string(”yes”, “no”)}

seq_index_of

seq_last_index_of

reverse

size

sort

sort_by
多层次的hash排序

<#assign members = [
...{"name": ...{"first": "Joe", "last": "Smith"}, "age": 40},
...{"name": ...{"first": "Fred", "last": "Crooger"}, "age": 35},
...{"name": ...{"first": "Amanda", "last": "Fox"}, "age": 25}]>
Sorted by name.last:
<#list members?sort_by(['name', 'last']) as m>
- $…{m.name.last}, $…{m.name.first}: $…{m.age} years old
</#LIST>

chunk:将一个序列分解成几个序列。

<#assign seq = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j']>

<#list seq?chunk(4) as row>
<#list row as cell>$…{cell} </#LIST>
</#LIST>

<#list seq?chunk(4, '-') as row>
<#list row as cell>$…{cell} </#LIST>
</#LIST>
chunk经常用于分栏或者表格输出的格式。

五:hash内置方法:

keys:
values:

】序列 由逗号分隔的变量列表,由方括号限定,类似java中的一维数组

<#assign seq = ["winter", "spring", "summer", "autumn"]>
<#list seq as x>
${x_index + 1}. ${x}

<#if x_has_next>,

</#LIST>

输出
1. winter,
2. spring,
3. summer,
4. autumn

】Hashes(散列)-由逗号分隔的键-值列表,由大括号限定,键和值之间用冒号分隔:{”name”:”green mouse”, “price”:150},键和值都是表达式,但是键必须是字符串。

<#assign ages = ...{"Joe":23, "Fred":25} + ...{"Joe":30, "Julia":18}>
- Joe is $…{ages.Joe}
- Fred is $…{ages.Fred}
- Julia is $…{ages.Julia}

结果:
- Joe is 30
- Fred is 25
- Julia is 18

】freemarker的空值和默认值

${user?if_exists}

${user?default(’your name’)}

判断对象是不是null
<#if mouse?exists>
Mouse found
<#else>

或<#if book.name?? >

Mouse found

</#IF>
list 空值判断 <#if bookList?size = 0>

】算术运算

比较操作符-<#if expression_r_r>…</#IF>
1.)使用=(或==,完全相等)测试两个值是否相等,使用!= 测试两个值是否不相等
2.)=和!=两边必须是相同类型的值,否则会产生错误,例如<#if 1 = "1">会引起错误
3.)Freemarker是精确比较,所以”x”、”x “和”X”是不相等的
4.)对数字和日期可以使用<、<=、>和>=,但不能用于字符串
5.)由于Freemarker会将>解释成FTL标记的结束字符,所以对于>和>=可以使用括号来避免这种情况,例如<#if (x > y)>,另一种替代的方法是,使用lt、lte、gt和gte来替代<、<=、>和>=

逻辑操作符-&&(and)、||(or)、!(not),只能用于布尔值,否则会产生错误
<#if x < 12 && color = "green">
We have less than 12 things, and they are green.
</#IF>
<#if !hot> <#-- here hot must be a boolean -->
It’s not hot.
</#IF>

内置函数-用法类似访问hash(散列)的子变量,只是使用”?”替代”.”,例如:user?upper_case
下面列出常用的一些函数:
对于字符串
html-对字符串进行HTML编码
cap_first-使字符串第一个字母大写
lower_case-将字符串转换成小写
trim-去掉字符串前后的空白字符
对于Sequences(序列)
size-获得序列中元素的数目
对于数字
int-取得数字的整数部分(如-1.9?int的结果是-1)

例一:

<#-- test的值为Tom & Jerry -->
$…{test?html}
$…{test?upper_case?html}
结果:
Tom & Jerry
TOM & JERRY

例二:

<#-- seasons的值为"winter", "spring", "summer", "autumn" -->
$…{seasons?size}
$…{seasons[1]?cap_first} <#-- left side can by any expression_r_r -->
$…{”horse”?cap_first}
结果:
4
Spring
Horse

方法的调用
$…{repeat(”What”, 3)}
$…{repeat(repeat(”x”, 2), 3) + repeat(”What”, 4)?upper_case}
结果:
WhatWhatWhat
xxxxxxWHATWHATWHATWHAT

操作符优先顺序
后缀 [subvarName] [subStringRange] . (methodParams)
一元 +expr、-expr、!
内建 ?
乘法 *、 / 、%
加法 +、-
关系 <、>、<=、>=(lt、lte、gt、gte)
相等 =、!=
逻辑 &&
逻辑 ||
数字范围 ..

三.) Interpolation:由$…{…}或#…{…}两种类型,输出计算值,可以定义输出的格式
例一:

<#setting number_format="currency"/>
<#assign answer=42/>
$…{answer}
$…{answer?string} <#-- the same as $...{answer} -->
$…{answer?string.number}
$…{answer?string.currency}
$…{answer?string.percent}
结果:
$42.00
$42.00
42
$42.00
4,200%

例二:

$…{lastUpdated?string(”yyyy-MM-dd HH:mm:ss zzzz”)}
$…{lastUpdated?string(”EEE, MMM d, ”yy”)}
$…{lastUpdated?string(”EEEE, MMMM dd, yyyy, hh:mm:ss a ‘(’zzz’)'”)}
结果:
2003-04-08 21:24:44 Pacific Daylight Time
Tue, Apr 8, ‘03
Tuesday, April 08, 2003, 09:24:44 PM (PDT)

例三:

<#assign foo=true/>
$…{foo?string(”yes”, “no”)}
结果:
yes

例四:

<#-- x is 2.582 and y is 4 -->
#…{x; M2} <#-- 2.58 -->
#…{y; M2} <#-- 4 -->
#…{x; m1} <#-- 2.6 -->
#…{y; m1} <#-- 4.0 -->
#…{x; m1M2} <#-- 2.58 -->
#…{y; m1M2} <#-- 4.0 -->
说明:mX-小数部分最小X位;MX-小数部分最大X位。

四.) 注释:<#--和-->

下面是一个常用的模板例子:

We have these animals:
Name Price
<#list animals as being>


<#if being.size = "large"></#IF>
$…{being.name}
<#if being.size="large"></#IF>


$…{being.price} Euros
</#LIST>

<#i nclude "/copyright_footer.html">
注意点:
1.) FreeMarker是区分大小写的;
2.) FTL标记不能位于另一个FTL标记内部,例如:<#if <#i nclude 'foo'>=’bar’>…;
3.) $…{…}只能在文本中使用;
4.) 多余的空白字符会在模板输出时去除;
5.) 如果使用的指令不存在,会产生一个错误消息。

<#-- x的值设定为5 -->
$…{x * x – 100}
$…{x / 2}
$…{12 % 10}
结果:
-75
2.5
2

注意: 操作符两边必须是数字;使用”+”时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串。

使用内建的指令int获得整数部分:

$…{(x/2)?int}
$…{1.1?int}
$…{1.999?int}
$…{-1.1?int}
$…{-1.999?int}
结果:
2
1
1
-1
-1
分享到:
评论

相关推荐

    freeMarker语法

    总结,FreeMarker语法提供了丰富的表达能力和控制结构,使得模板编写灵活且易于维护。通过熟练掌握这些知识,开发者可以高效地生成动态内容,提高开发效率。在实际项目中,结合源码理解和工具辅助,能更好地利用...

    Freemarker语法规则教程

    ### Freemarker语法规则教程 #### 一、字符串格式化输出 在Freemarker中,字符串格式化是一项非常实用的功能,它可以将数据按照特定的格式进行输出,方便开发者控制最终的展示效果。以下是一些基本的例子: - **...

    freemarker语法.pdf

    ### FreeMarker语法详解 #### 一、FreeMarker模板文件组成 FreeMarker模板文件与普通的HTML页面相比,并不显得更为复杂。其主要组成部分包括: 1. **文本**:这部分内容会被直接输出到最终生成的文档中。 2. **...

    freemarker语法完整版.doc

    Freemarker语法完整版 Freemarker是基于模板的生成技术,可以根据给定的数据模型生成动态的文本输出。在Freemarker中,存在五种基本概念:Scalars、Hashes、Sequences、Collection Variables和Methods。 1. ...

    Freemarker 语法规则

    以下是关于Freemarker语法规则的详细解释: 1. **变量表达式**: Freemarker中的变量表达式通常以`${}`包裹,用来输出Java对象的属性值。例如,如果有一个名为`user`的对象,其`name`属性为"张三",那么`${user....

    FreeMarker语法参考

    ### FreeMarker语法参考详解 #### 一、FreeMarker概述与基本语法 FreeMarker是一个用Java编写的模板引擎,它能够将数据模型与表现层(HTML、XML等)分离,使得前端展示逻辑与后端业务逻辑可以独立开发和维护。本文...

    freemarker语法完整版

    ### Freemarker语法完整版知识点详解 #### A. 概念 **1. Scalars(标量)** - **字符串**: 由单引号或双引号括起来的文本。 - **数字**: 直接使用数值。 - **日期**: 通常从数据模型中获取。 - **布尔值**: `...

    java freemarker 语法

    ### Java Freemarker 语法详解 #### 一、Freemarker 概述与基本概念 Freemarker 是一种用于生成动态内容的模板引擎,它能够帮助开发者将数据模型中的数据渲染到 HTML 页面上,从而实现前后端分离的效果。...

    freemarker 语法大全 文档

    以下是对Freemarker语法大全的一些关键点的详细解释: 1. **指令**: - `if`、`else`、`elseif`:用于条件判断,可以根据条件执行不同的代码块。 - `switch`、`case`、`default`、`break`:提供多分支选择,类似...

    freemarker语法完成版

    以下是关于Freemarker语法的详细说明: 1. **Scalars**: - 字符串:可以通过单引号或双引号定义,特殊字符需要转义。 - 数字:直接写入,支持整数和浮点数,但不支持科学计数法。 - 日期:通常从数据模型获取,...

    freemarker 语法基础(转).

    ### FreeMarker 语法基础 #### 一、FreeMarker 模板结构 FreeMarker 是一种用于生成文本输出的模板引擎,其模板文件结构简单且易于理解。一个典型的 FreeMarker 模板文件由以下四个主要部分组成: 1. **文本**:...

    模板:velocity和freemarker的比较

    再者,从语法格式上来讲,Velocity 和 Freemarker 的语法格式不同,Velocity 的语法更加简洁,而 Freemarker 的语法更加灵活。不同的开发者可能会有不同的倾向性,但是Freemarker 的语法更加强大。 最后,从性能上...

    freemarker语法

    ### FreeMarker语法详解 #### 一、概述 FreeMarker是一个强大的模板引擎,广泛应用于Web开发领域,用于将数据模型中的数据动态地填充到HTML、XML等格式的文档中。其核心概念包括文本、注释、插值以及FTL指令。 ##...

    freemarker语法 亲自收集整理

    以下是对 Freemarker 语法的详细解释: 1. **指令:** - **if, else, elseif**:用于条件判断。`&lt;#if condition&gt;`检查条件,如果为真则执行相应代码,`&lt;#elseif condition2&gt;`用于添加额外的条件分支,`&lt;#else&gt;`则...

    FreeMarker语法知识

    ### FreeMarker语法知识详解 #### 一、FreeMarker概述 FreeMarker是一种强大的模板引擎,用于生成文本输出。它被广泛应用于Web开发中,用于动态生成HTML页面以及其他类型的文本文件,如XML、JavaScript、电子邮件等...

Global site tag (gtag.js) - Google Analytics