FreeMarker设计指南(3)

最新推荐文章于 2023-08-17 23:15:00 发布
最新推荐文章于 2023-08-17 23:15:00 发布
阅读量531 收藏
点赞数
分类专栏： 其他 文章标签： freemarker user html string parameters spring

 

3、模板

 

（1）整体结构

 

l         模板使用FTL（FreeMarker模板语言）编写，是下面各部分的一个组合：

 

Ø         文本：直接输出

 

Ø         Interpolation：由${和}，或#{和}来限定，计算值替代输出

 

Ø         FTL标记：FreeMarker指令，和HTML标记类似，名字前加#予以区分，不会输出

 

Ø         注释：由<#--和-->限定，不会输出

 

l         下面是以一个具体模板例子：

 

<html>[BR]
 
<head>[BR]
 
  <title>Welcome!</title>[BR]
 
</head>[BR]
 
<body>[BR]
 
  <#-- Greet the user with his/her name -->[BR]
 
  <h1>Welcome ${user}!</h1>[BR]
 
  <p>We have these animals:[BR]
 
  <ul>[BR]
 
  <#list animals as being>[BR]
 
    <li>${being.name} for ${being.price} Euros[BR]
 
  </#list>[BR]
 
  </ul>[BR]
 
</body>[BR]
 
</html>  
 

l         [BR]是用于换行的特殊字符序列

 

l         注意事项：

 

Ø         FTL区分大小写，所以list是正确的FTL指令，而List不是；${name}和${NAME}是不同的

 

Ø         Interpolation只能在文本中使用

 

Ø         FTL标记不能位于另一个FTL标记内部，例如：

 

<#if <#include 'foo'>='bar'>...</if>
 

Ø         注释可以位于FTL标记和Interpolation内部，如下面的例子：

 

<h1>Welcome ${user <#-- The name of user -->}!</h1>[BR]
 
<p>We have these animals:[BR]
 
<ul>[BR]
 
<#list <#-- some comment... --> animals as <#-- again... --> being>[BR]
 
...  
 

Ø         多余的空白字符会在模板输出时移除

 

（2）指令

 

l         在FreeMarker中，使用FTL标记引用指令

 

l         有三种FTL标记，这和HTML标记是类似的：

 

Ø         开始标记：<#directivename parameters>

 

 

Ø         结束标记：</#directivename>

 

 

Ø         空内容指令标记：<#directivename parameters/>

 

 

l         有两种类型的指令：预定义指令和用户定义指令

 

l         用户定义指令要使用@替换#，如<@mydirective>...</@mydirective>（会在后面讲述）

 

l         FTL标记不能够交叉，而应该正确的嵌套，如下面的代码是错误的：

 

<ul>
 
<#list animals as being>
 
  <li>${being.name} for ${being.price} Euros
 
  <#if use = "Big Joe">
 
     (except for you)
 
</#list>
 
</#if> <#-- WRONG! -->
 
</ul>  
 

l         如果使用不存在的指令，FreeMarker不会使用模板输出，而是产生一个错误消息

 

l         FreeMarker会忽略FTL标记中的空白字符，如下面的例子：

 

<#list[BR]
 
  animals       as[BR]
 
     being[BR]
 
>[BR]
 
${being.name} for ${being.price} Euros[BR]
 
</#list    >  
 

l         但是，<、</和指令之间不允许有空白字符

 

（3）表达式

 

l         直接指定值

 

Ø         字符串

 

n         使用单引号或双引号限定

 

n         如果包含特殊字符需要转义，如下面的例子：

 

${"It's /"quoted/" and
 
this is a backslash: //"}
 
 
 
${'It/'s "quoted" and
 
this is a backslash: //'} 
 

输出结果是：

 

It's "quoted" and
 
this is a backslash: /
 
 
 
It's "quoted" and
 
this is a backslash: / 
 

n         下面是支持的转义序列：

 

转义序列

 

 

含义

 

 

/"

 

 

双引号(u0022)

 

 

/'

 

 

单引号(u0027)

 

 

//

 

 

反斜杠(u005C)

 

 

/n

 

 

换行(u000A)

 

 

/r

 

 

Return (u000D)

 

 

/t

 

 

Tab (u0009)

 

 

/b

 

 

Backspace (u0008)

 

 

/f

 

 

Form feed (u000C)

 

 

/l

 

 

<

 

 

/g

 

 

>

 

 

/a

 

 

&

 

 

/{

 

 

{

 

 

/xCode

 

 

4位16进制Unicode代码

 

 

n         有一类特殊的字符串称为raw字符串，被认为是纯文本，其中的/和{等不具有特殊含义，该类字符串在引号前面加r，下面是一个例子：

 

${r"${foo}"}
 
${r"C:/foo/bar"}  
 

输出的结果是：

 

${foo}
 
C:/foo/bar  
 

Ø         数字

 

n         直接输入，不需要引号

 

n         精度数字使用“.”分隔，不能使用分组符号

 

n         目前版本不支持科学计数法，所以“1E3”是错误的

 

n         不能省略小数点前面的0，所以“.5”是错误的

 

n         数字8、+8、08和8.00都是相同的

 

Ø         布尔值

 

n         true和false，不使用引号

 

Ø         序列

 

n         由逗号分隔的子变量列表，由方括号限定，下面是一个例子：

 

<#list ["winter", "spring", "summer", "autumn"] as x>
 
${x}
 
</#list> 
 

输出的结果是：

 

winter
 
spring
 
summer
 
autumn
 

n         列表的项目是表达式，所以可以有下面的例子：

 

[2 + 2, [1, 2, 3, 4], "whatnot"]
 

n         可以使用数字范围定义数字序列，例如2..5等同于[2, 3, 4, 5]，但是更有效率，注意数字范围没有方括号

 

n         可以定义反递增的数字范围，如5..2

 

Ø         散列（hash）

 

n         由逗号分隔的键/值列表，由大括号限定，键和值之间用冒号分隔，下面是一个例子：

 

{"name":"green mouse", "price":150}
 

n         键和值都是表达式，但是键必须是字符串

 

l         获取变量

 

Ø         顶层变量： ${variable}，变量名只能是字母、数字、下划线、$、@和#的组合，且不能以数字开头

 

Ø         从散列中获取数据

 

n         可以使用点语法或方括号语法，假设有下面的数据模型：

 

(root)
 
 |
 
 +- book
 
 |   |
 
 |   +- title = "Breeding green mouses"
 
 |   |
 
 |   +- author
 
 |       |
 
 |       +- name = "Julia Smith"
 
 |       |
 
 |       +- info = "Biologist, 1923-1985, Canada"
 
 |
 
 +- test = "title" 
 

下面都是等价的：

 

book.author.name
 
book["author"].name
 
book.author.["name"]
 
book["author"]["name"]
 

n         使用点语法，变量名字有顶层变量一样的限制，但方括号语法没有该限制，因为名字是任意表达式的结果

 

Ø         从序列获得数据：和散列的方括号语法语法一样，只是方括号中的表达式值必须是数字；注意：第一个项目的索引是0

 

Ø         序列片断：使用[startIndex..endIndex]语法，从序列中获得序列片断（也是序列）；startIndex和endIndex是结果为数字的表达式

 

Ø         特殊变量：FreeMarker内定义变量，使用.variablename语法访问

 

l         字符串操作

 

Ø         Interpolation（或连接操作）

 

n         可以使用${..}（或#{..}）在文本部分插入表达式的值，例如：

 

${"Hello ${user}!"}
 
${"${user}${user}${user}${user}"}  
 

n         可以使用+操作符获得同样的结果

 

${"Hello " + user + "!"}
 
${user + user + user + user}
 

n         ${..}只能用于文本部分，下面的代码是错误的：

 

<#if ${isBig}>Wow!</#if>
 
<#if "${isBig}">Wow!</#if>
 

应该写成：

 

<#if isBig>Wow!</#if>
 

Ø         子串

 

n         例子（假设user的值为“Big Joe”）：

 

${user[0]}${user[4]}
 
${user[1..4]}
 

结果是（注意第一个字符的索引是0）：

 

BJ
 
ig J 
 

l         序列操作

 

Ø         连接操作：和字符串一样，使用+，下面是一个例子：

 

<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>
 
- ${user}
 
</#list>
 

输出结果是：

 

- Joe
 
- Fred
 
- Julia
 
- Kate
 

l         散列操作

 

Ø         连接操作：和字符串一样，使用+，如果具有相同的key，右边的值替代左边的值，例如：

 

<#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  
 

l         算术运算

 

Ø         ＋、－、×、／、％，下面是一个例子：

 

${x * x - 100}
 
${x / 2}
 
${12 % 10}
 

输出结果是（假设x为5）：

 

-75
 
2.5
 
2  
 

Ø         操作符两边必须是数字，因此下面的代码是错误的：

 

${3 * "5"} <#-- WRONG! -->  
 

Ø         使用+操作符时，如果一边是数字，一边是字符串，就会自动将数字转换为字符串，例如：

 

${3 + "5"}  
 

输出结果是：

 

35
 

Ø         使用内建的int（后面讲述）获得整数部分，例如：

 

${(x/2)?int}
 
${1.1?int}
 
${1.999?int}
 
${-1.1?int}
 
${-1.999?int}
 

输出结果是（假设x为5）：

 

2
 
1
 
1
 
-1
 
-1
 

l         比较操作符

 

Ø         使用=（或==，完全相等）测试两个值是否相等，使用!= 测试两个值是否不相等

 

Ø         =和!=两边必须是相同类型的值，否则会产生错误，例如<#if 1 = "1">会引起错误

 

Ø         Freemarker是精确比较，所以对"x"、"x  "和"X"是不相等的

 

Ø         对数字和日期可以使用<、<=、>和>=，但不能用于字符串

 

Ø         由于Freemarker会将>解释成FTL标记的结束字符，所以对于>和>=可以使用括号来避免这种情况，例如<#if (x > y)>

 

 

Ø         另一种替代的方法是，使用lt、lte、gt和gte来替代<、<=、>和>=

 

l         逻辑操作符

 

Ø         &&（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>  
 

l         内建函数

 

Ø         内建函数的用法类似访问散列的子变量，只是使用“?”替代“.”，下面列出常用的一些函数

 

Ø         字符串使用的：

 

n         html：对字符串进行HTML编码

 

n         cap_first：使字符串第一个字母大写

 

n         lower_case：将字符串转换成小写

 

n         upper_case：将字符串转换成大写

 

n         trim：去掉字符串前后的空白字符

 

Ø         序列使用的：

 

n         size：获得序列中元素的数目

 

Ø         数字使用的：

 

n         int：取得数字的整数部分（如-1.9?int的结果是-1）

 

Ø         例子（假设test保存字符串"Tom & Jerry"）：

 

${test?html}
 
${test?upper_case?html}
 

输出结果是：

 

Tom &amp; Jerry
 
TOM &amp; JERRY  
 

l         操作符优先顺序

 

操作符组

 

 

操作符

 

 

后缀

 

 

[subvarName] [subStringRange] . (methodParams)

 

 

一元

 

 

+expr、-expr、!

 

 

内建

 

 

?

 

 

乘法

 

 

*、 / 、%

 

 

加法

 

 

+、-

 

 

关系

 

 

<、>、<=、>=（lt、lte、gt、gte）

 

 

相等

 

 

==（=）、!=

 

 

逻辑and

 

 

&&

 

 

逻辑or

 

 

||

 

 

数字范围

 

 

..

 

 

（4）Interpolation

 

 

l         Interpolation有两种类型：

 

Ø         通用Interpolation：${expr}

 

 

Ø         数字Interpolation：#{expr}或#{expr; format}

 

 

l         注意：Interpolation只能用于文本部分

 

l         通用Interpolation

 

 

Ø         插入字符串值：直接输出表达式结果

 

Ø         插入数字值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个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%
 

Ø         插入日期值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个使用格式模式的例子：

 

${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)
 

Ø         插入布尔值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：

 

<#assign foo=true/>
 
${foo?string("yes", "no")}
 

输出结果是：

 

yes
 

l         数字Interpolation的#{expr; format}形式可以用来格式化数字，format可以是：

 

Ø         mX：小数部分最小X位

 

Ø         MX：小数部分最大X位

 

Ø         例子：

 

           <#-- If the language is US English the output is: -->
 
<#assign x=2.582/>
 
<#assign y=4/>
 
#{x; M2}   <#-- 2.58 -->
 
#{y; M2}   <#-- 4    -->
 
#{x; m1}   <#-- 2.6 -->
 
#{y; m1}   <#-- 4.0 -->
 
#{x; m1M2} <#-- 2.58 -->
 
#{y; m1M2} <#-- 4.0  -->  
 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

chmsword
关注
专栏目录
FreeMarker设计指南(1)
11-02 1万+
1、快速入门（1）模板 + 数据模型 = 输出l         FreeMarker基于设计者和程序员是具有不同专业技能的不同个体的观念l         他们是分工劳动的：设计者专注于表示——创建HTML文件、图片、Web页面的其它可视化方面；程序员创建系统，生成设计页面要显示的数据l         经常会遇到的问题是：在Web页面（或其它类型的文档）中显示的信息在设计页面时
freemarker
HelloWorld
04-27 316
一、  概述 freemarker是java编写的一款模版引擎，是一种基于模版和要改变的数据，并用于输出文本（html、电子邮件、配置文件和源代码等）的通用工具。与web容器无关，即在web运行时，它并不知道servlet或HTTP。不仅可以用于表现层的实现技术，还可以用于生成XML，JPS或java等。在企业中，一般用于生成静态页面或是页面展示。 二、  使用freemarker 导入ja...
FreeMarker 基础知识 表达式
iteye_15447的博客
09-29 437
表达式是FreeMarker的核心功能，FreeMarker中的插值支持多种表达式。 一、直接指定值直接指定值可以是字符串、数值、布尔值、集合及Map对象。1. 字符串直接指定字符串值使用单引号或双引号限定。字符串中可以使用转义字符”\"。如果字符串内有大量的特殊字符，则可以在引号的前面加上一个字母r，则字符串内的所有字符都将直接输出。 2. 数值数值可以直接输入，不需要引号。FreeMark...
FreeMarker语法之表达式（一）
weixin_34413802的博客
12-02 196
今天lola介绍FreeMarker语法之表达式（一），因FreeMarker语法的表达式比较复杂，lola将会分几次介绍。表达式是FreeMarker模板的核心功能,表达式放置在插值语法${}之中时,表明需要输出表达式的值;表达式语法也可与FreeMarker 标签结合,用于控制输出.实际上FreeMarker的表达式功能非常强大,它不仅支持直接指定值,输出变量值,也支持字...
FreeMarker表达式
精神分裂的二次元
05-11 247
表达式是FreeMarker模板的核心功能，表达式放置在插值语法(${……})之中时，表明需要输出表达式的值；表达式语法也可与FreeMarker标签结合，用于控制输出。 [color=blue][b]直接指定值[/b][/color] 使用直接指定值的语法让FreeMarker直接输出插值中的值，而不是输出变量值。直接指定值可以是字符串、数值、布尔值、集合和MAP对象。 如果字符串中包...
FreeMarker之表达式
JJ_HH
11-04 532
字符串：“ ”或‘ ’等价 值域：序列，由包含的数字范围所创建，不需要指定序列中的每一项 主要作用：使用<#list …>来迭代一定范围的数字，序列切分和字符串切分 通用形式：start…end:包含结尾的值域，eg：1..4就是【1，2，3，4】4..1就是【4，3，2，1】包含结尾的值域不会是一个空序列 start..
FreeMarker 设计指南
07-08
FreeMarker 是一个强大的模板引擎，常用于Web应用中的视图层，特别是在Java环境中与Spring MVC等框架配合使用。本设计指南将深入探讨...通过阅读《FreeMarker设计指南》PDF，你可以更深入地学习和掌握这一技术。
FreeMarker设计指南(完整整理)
03-19
这篇“FreeMarker设计指南(完整整理)”将深入解析其设计理念、核心概念和实际应用。 首先，FreeMarker是一个基于模板的解决方案，它的核心思想是分离业务逻辑和视图展示。这意味着开发者可以在不改动业务代码的情况...
FreeMarker设计指南
04-28
综上所述，FreeMarker设计指南旨在帮助开发者更好地理解和运用这款强大的模板引擎，通过熟练掌握其核心概念和语法，可以高效地构建动态网页和文档。阅读提供的《FreeMarker设计指南.pdf》文件，将更深入地了解如何在...
Freemarker
alodina的博客
08-13 456
Freemarker 网页静态化解决方案在实际开发中运用比较多，例如新闻网站，门户网站中的新闻频道或者是文章类的频道。 网页静态化技术和缓存技术的共同点都是为了减轻数据库的访问压力，但是具体的应用场景不同，缓存比较适合小规模的数据，而网页静态化比较适合大规模且相对变化不太频繁的数据。另外网页静态化还有利于SEO。 如果将网页以纯静态化的形式展现，就可以使用Nginx这样...
freemarker特殊表达式总结
lydia的博客
08-05 183
1.序列的连接可以使用+来进行，例如： &lt;#list ["joe", "fred"] + ["julia", "kate"] as user&gt; -${user} &lt;/#list&gt;    打印结果为： -joe -fred -julia -kate 2.求平均值 ${avg(3,5)}     打印结果为： 4 3.字符串内建函数
FreeMarker--表达式和运算符的用法(全面/有示例)
最新发布
IT利刃出鞘的博客
08-17 3585
本文介绍FreeMarker的表达式和运算符的用法。 表达式是FreeMarker的核心功能。表达式放置在插值语法（${...}）之中时，表明需要输出表达式的值，表达式语法也可以与FreeMarker标签结合，用于控制输出。
Freemarker教程2(表达式和常用指令)
波波烤鸭的博客
01-22 2892
表达式 直接指定值 直接显示字符串 ${'hello freemarker'}&amp;amp;amp;amp;amp;amp;lt;br&amp;amp;amp;amp;amp;amp;gt; 显示集合 &amp;amp;amp;amp;amp;amp;lt;#list [&amp;amp;amp;amp;amp;quot;aa&amp;amp;amp;amp;amp;quot;,&amp;amp;amp;amp;amp;quot;bb&amp
FreeMarker 教程整理
weixin_30888707的博客
05-08 206
Freemarker新手教程 http://blog.csdn.net/qq_23994787/article/details/77506980 FreeMarker教程整理 http://blog.csdn.net/freewindgo/article/details/52297936 史上最详细freemarker语法介绍及其入门教程实例 http://blog.csdn...
freemarker遍历tr td
an74520的专栏
02-14 3346
表单遍历，每三个属性为一行 表单明细 ${ps.displayName}${(ps_index+1) % 3} ${ps.value} 结果示意图：
FreeMarker基本用法
xfilson的专栏
06-12 4506
测试登录页面 用户名： 密   码:
一篇很全面的freemarker教程
nojob1year的博客
11-20 3384
copy自[url]http://demojava.iteye.com/blog/800204[/url] 以下内容全部是网上收集： FreeMarker的模板文件并不比HTML页面复杂多少,FreeMarker模板文件主要由如下4个部分组成: 1,文本:直接输出的部分 2,注释:格式部分,不会输出 3,插值:即${...}或#{...}格式的部分,将使用数据模型中的部分替代输出...
FreeMarker模板引擎完全指南
"FreeMarker设计指南是一份详细且实例丰富的教程，旨在帮助读者全面了解FreeMarker模板引擎。FreeMarker的核心理念是将设计与程序逻辑分离，让设计者专注于页面表现，而程序员则负责生成数据。它允许在模板中插入...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值