`

Freemarker页面语法

阅读更多

A 概念

最常用的 3 个概念

sequence 序列,对应java 里的list 、数组等非键值对的集合

hash      键值对的集合

namespace 对一个ftl 文件的引用, 利用这个名字可以访问到该ftl 文件的资源

B 指令

if, else, elseif

语法

<#if condition>
  ...
<#elseif condition2>
  ...
<#elseif condition3>
  ...
...
<#else>
  ...
</#if>

用例

<#if x = 1>
  x is 1
</#if>
<#if x = 1>
  x is 1
<#else>
  x is not 1
</#if>

switch, case, default, break

语法

 

<#switch value>
  <#case refValue1>
         ...
         <#break>
  <#case refValue2>
         ...
         <#break>
  ...
  <#case refValueN>
         ...
         <#break>
  <#default>
         ...
</#switch>
 

用例

字符串

<#switch being.size>
  <#case "small">
          This will be processed if it is small
          <#break>
  <#case "medium">
          This will be processed if it is medium
          <#break>
  <#case "large">
          This will be processed if it is large
          <#break>
  <#default>
          This will be processed if it is neither
</#switch>
 

数字

<#switch x>
  <#case x = 1>
         1
  <#case x = 2>
         2
  <#default>
         d
</#switch>
 

如果x=1 输出 1 2, x=2 输出 2, x=3 输出d

list, break

语法

<#list sequence as item>
...
<#if item = "spring"><#break></#if>
...
</#list>

 关键字

item_index:是list当前值的下标

item_has_next:判断list是否还有值

用例

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

 

输出:

      1.winter,

      2.spring,

      3.summer,

      4.autumn

include

语法

<#include filename>

  或则

<#include filename options>
 

options包含两个属性

encoding="GBK" 编码格式

parse=true 是否作为ftl语法解析,默认是true,false就是以文本方式引入.注意在ftl文件里布尔值都是直接赋值
的如parse=true,而不是parse="true"

用例

/common/copyright.ftl 包含内容

Copyright 2001-2002 ${me}

All rights reserved.  
 

模板文件


<#assign me = "Juila Smith">

Some test

Yeah
___________________________________________________________________________

<#include "/common/copyright.ftl" encoding="GBK">













 


输出结果:

Some test

Yeah.

Copyright 2001-2002 Juila Smith

All rights reserved. 

 

Import

语法

<#import path as hash>

 类似于java里的import,它导入文件,然后就可以在当前文件里使用被导入文件里的宏组件

用例

假设mylib.ftl 里定义了宏copyright 那么我们在其他模板页面里可以这样使用

<#import "/libs/mylib.ftl" as my>

<@my.copyright date="1999-2002"/>

<#-- "my"在freemarker里被称作namespace -->
 

compress

语法

<#compress>
  ...
</#compress>
 

用来压缩空白空间和空白的行

escape, noescape

语法

<#escape identifier as expression>
  ...
  <#noescape>...</#noescape>
  ...
</#escape>

用例

      主要使用在相似的字符串变量输出,比如某一个模块的所有字符串输出都必须是html安全的,这个时候就可以使用

该表达式

<#escape x as x?html>
  First name: ${firstName}
  <#noescape>Last name: ${lastName}</#noescape>
  Maiden name: ${maidenName}
</#escape>

相同表达式

  First name: ${firstName?html}
  Last name: ${lastName }
  Maiden name: ${maidenName?html}
 

assign

语法

<#assign name=value>

<#-- 或则 -->

<#assign name1=value1 name2=value2 ... nameN=valueN>

<#-- 或则 -->

<#assign same as above... in namespacehash>

<#-- 或则 -->

<#assign name>
  capture this
</#assign>

<#-- 或则 -->

<#assign name in namespacehash>
  capture this
</#assign>
 

用例

生成变量,并且给变量赋值

给seasons赋予序列值

<#assign seasons = ["winter", "spring", "summer", "autumn"]>

 给变量test加1

<#assign test = test + 1>

 给my namespage 赋予一个变量bgColor,下面可以通过my.bgColor来访问这个变量

<#import "/mylib.ftl" as my>

<#assign bgColor="red" in my>

 将一段输出的文本作为变量保存在x里

<#assign x>
  <#list 1..3 as n>
         ${n} <@myMacro />
  </#list>
</#assign>

Number of words: ${x?word_list?size}

${x}

<#assign x>Hello ${user}!</#assign>          error

<#assign x=" Hello ${user}!">         true

 同时也支持中文赋值,如:

<#assign 语法>
  java
</#assign>

${语法}

 打印输出:

java


global

语法

<#global name=value>

<#--或则-->

<#global name1=value1 name2=value2 ... nameN=valueN>

<#--或则-->

<#global name>
  capture this
</#global>
 

     全局赋值语法,利用这个语法给变量赋值,那么这个变量在所有的namespace [A1] 中是可见的, 如果这个变量被当前的assign 语法覆盖 如<#global x=2> <#assign x=1> 在当前页面里x=2 将被隐藏,或者通过${.global.x} 来访问

setting

语法

<#setting name=value>
 

用来设置整个系统的一个环境

locale

number_format

boolean_format

date_format , time_format , datetime_format

time_zone

classic_compatible

用例

假如当前是匈牙利的设置,然后修改成美国

${1.2}

<#setting locale="en_US">

${1.2}  
 

输出

         1,2

         1.2

因为匈牙利是采用", "作为十进制的分隔符,美国是用". "

macro, nested, return

语法

<#macro name param1 param2 ... paramN>
  ...
  <#nested loopvar1, loopvar2, ..., loopvarN>
  ...
  <#return>
  ...
</#macro>

用例

<#macro test foo bar="Bar"[A2]  baaz=-1>
  Test text, and the params: ${foo}, ${bar}, ${baaz}
</#macro>

<@test foo="a" bar="b" baaz=5*5-2/>

<@test foo="a" bar="b"/>

<@test foo="a" baaz=5*5-2/>

<@test foo="a"/> 
 

输出

  Test text, and the params: a, b, 23
  Test text, and the params: a, b, -1
  Test text, and the params: a, Bar, 23

  Test text, and the params: a, Bar, -1

 

定义循环输出的宏

<#macro list title items>
${title?cap_first}:
        <#list items as x>
           *${x?cap_first}

         </#list>
</#macro>

<@list items=["mouse", "elephant", "python"] title="Animals"/>
 

输出结果:
      Animals:
           *Mouse
           *Elephant
           *Python

 

包含body 的宏

<#macro repeat count>
  <#list 1..count as x>
         <#nested x, x/2, x==count>
  </#list>
</#macro>

<@repeat count=4 ; c halfc last>
  ${c}. ${halfc}<#if last> Last!</#if>
</@repeat> 
 

输出

  1. 0.5
  2. 1
  3. 1.5

  4. 2 Last!

t, lt, rt

语法

<#t> 去掉左右空白和回车换行

<#lt>去掉左边空白和回车换行

<#rt>去掉右边空白和回车换行

<#nt>取消上面的效果

C 一些常用方法或注意事项

表达式转换类

${expression} 计算expression 并输出

#{ expression } 数字计算#{ expression ;format} 安格式输出数字formatMm

M 表示小数点后最多的位数,m 表示小数点后最少的位数如#{121.2322;m2M2} 输出121.23

数字循环

1..5 表示从15 ,原型number..number

对浮点取整数

${123.23?int} 输出 123

给变量默认值

${var?default("hello world")?html} 如果var is null 那么将会被hello world 替代

判断对象是不是 null

<#if mouse?exists>
      Mouse found
<#else>

 也可以直接${mouse?if_exists})输出布尔形

 

--------------------------------------------

(1)解决输出中文乱码问题:

     freemarker乱码的原因:

  • 没有使用正确的编码格式读取模版文件,表现为模版中的中文为乱码

解决方法:在classpath上放置一个文件freemarker.properties,在里面写上模版文件的编码方式,比如

default_encoding=UTF-8
locale=zh_CN

注意:eclipse中除了xml文件、java文件外,默认的文件格式iso8859-1

  • 数据插入模版时,没有使用正确的编码,表现出模版中的新插入数据为乱码

解决方法:在result的配置中,指定charset,s2的FreemarkerResult.java会将charset传递freemarker

<action name="ListPersons" class="ListPersons">

<result type="freemarker">

    <param name="location">/pages/Person/view.ftl</param>

    <param name="contentType"> text/html;charset=UTF-8

</param>

</result>

</action>

(2)提高freemarker的性能

在freemarker.properties中设置:

template_update_delay=60000

避免每次请求都重新载入模版,即充分利用cached的模版

(3)尽量使用freemarker本身的提供的tag,使用S2 tags 的标签会在性能上有所损失

 

(4)freemarker的标签种类:

  • ${..}:FreeMarker will replace it in the output with the actual value of the thing in the curly brackets. They are called interpolation s.
  • # ,代表是FTL tags(FreeMarker Template Language tags) ,hey are instructions to FreeMarker and will not be printed to the output
    • <#if ...></#if>
    • <#list totalList as elementObject>...</#list>
  • @ ,代表用户自定义的标签
  • <#-- --> 注释标签,注意不是<!-- -->

(5)一些特殊的指令:  

  • r代表原样输出:${r"C:\foo\bar"}
  • <#list ["winter", "spring", "summer", "autumn"] as x>${x}</#list>
  • ?引出内置指令
    • String处理指令:
      • html:特殊的html字符将会被转义,比如"<",处理后的结果是&lt;
      • cap_first lower_case upper_case
      • trim :除去字符串前后的空格
    • sequences处理指令
      • size :返回sequences的大小
    • numbers处理指令
      • int:number的整数部分,(e.g. -1.9?int is -1)

(6)对于null,或者miss value,freemarker会报错

  •   ?exists:旧版本的用法
  • !:default value operator,语法结构为: unsafe_expr !default_expr,比如 ${mouse!"No mouse."} 当mouse不存在时,返回default value;
    • (product.color)!"red" 这种方式,能够处理product或者color为miss value的情况;
    • 而product.color!"red"将只处理color为miss value的情况
  • ??: Missing value test operator ,测试是否为missing value
    • unsafe_expr ?? :product.color??将只测试color是否为null
    • (unsafe_expr )??:(product.color)??将测试product和color是否存在null
<#if mouse??>
  Mouse found
<#else>
  No mouse found
</#if>
Creating mouse...
<#assign mouse = "Jerry">
<#if mouse??>
  Mouse found

<#else>
  No mouse found
</#if>
 

(7)模版值插入方式 (interpolation)

  • 通用方式 Universal interpolations): ${expression }

  • 对于字符串:只是简单输出
  • 对于数值,会自动根据local确定格式,称为human audience,否则称为computer audience,可以"?c", 比如, <a href="/shop/details?id=${product.id ?c }">Details...</a>,因此这里的id是给浏览器使用的,不需要进行格式化,注意?c只对数值有效
  • 对于日期,会使用默认的日期格式转换,因此需要事先设置好默认的转换格式,包括date_format , time_format atetime_format
  • 对于布尔值,不能输出,会报错并停止模版的执行,比如${a = 2} 会出错,但是可以 string built-in来进行转换

数值处理,具体参考:Built-ins for numbers

    http://freemarker.org/docs/ref_builtins_number.html#ref_builtin_string_for_number

    数值处理的例子:
   
    <#setting number_format="currency"/>
    <#assign answer=42/>
    ${answer}
    ${answer?string} <#-- the same as ${answer} -->
    ${answer?string.number}
    ${answer?string.currency}
    ${answer?string.percent}

    除了使用内置的formate,可以使用任何用Java decimal number format syntax 书写的formate,比如

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

    <#setting number_format="0"/>

    <#setting number_format="#"/>
    ${1234}
    ${12345?string("0.####E0")}

    更加方便的格式:

    <#setting locale="en_US">
    US people writes:        ${12345678?string(",##0.00")}

    <#setting locale="hu">
    Hungarian people writes: ${12345678?string(",##0.00")}

    

    日期处理,参考Built-ins for dates

    http://freemarker.org/docs/ref_builtins_date.html#ref_builtin_string_for_date

    日期处理的例子:

  •     ${openingTime?string.short}
  •     ${openingTime?string.medium}
  •     ${openingTime?string.long}
  •     ${openingTime?string.full}
  •     ${nextDiscountDay?string.short}
  •     ${nextDiscountDay?string.medium}
  •     ${nextDiscountDay?string.long}
  •     ${nextDiscountDay?string.full}
  •     ${lastUpdated?string.short}
  •     ${lastUpdated?string.medium}
  •     ${lastUpdated?string.long}
  •     ${lastUpdated?string.full}

 

注意:

    由于java语言中的Date类型的不足,freemarker不能根据Date变量判断出变量包含的部分(日期、时间还是全部),在这种情况下,freemarker

    不能正确显示出${lastUpdated?string.short} 或者 simply ${lastUpdated},因此,可以通过?date, ?time and ?datetime built-ins

    来帮助freemarker来进行判断,比如${lastUpdated?datetime?string.short}

    除了使用内置的日期转换格式外,可以自己指定日期的格式,使用的是Java date format syntax,比如:

  •     ${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')'")}

    数值专用方式 Numerical interpolations):#{expression } or #{expression ; format },这是数值专用的输出方式,但是 最好使用通用方式的string built-in或者number_format 来完成转换,Numerical interpolations方式将会被停用

 

 

(8)创建自定义模版

<#macro greet>      
     <font size="+2">Hello Joe!</font>
</#macro>

 

 

 

<#assign   user="zhangsan"/>

字符串连接

${"Hello  ${user}!"}   与 ${"Hello " + user + "!"} 相同

结果:Hello  zhangsan

获取字符

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

结果:z  g

序列的连接和访问

 <#assign   nums=["1" , "2"] + ["3" , "4"]  />

${nums[0]}   结果是 1

内置函数

html   使用实体引用替换字符串中所有HTML字符,例如,使用&amp; 替换&

lower_case   将字符串转化成小写

substring

index_of      例如”abcdc"?index_of("bc") 将返回1

seq_contains    序列中是否包含指定值  ${nums?seq_contains("1")?string("yes","no")}

seq_index_of    第一个出现的索引   ${nums?seq_index_of("1")}   结果0

sort_by    用于散列   

 

 

分享到:
评论
11 楼 shootboss 2017-02-22  
可以,mark学习
10 楼 java_cache 2015-01-21  
好东西,果断收藏!
9 楼 fireinjava 2014-03-19  
${.global.x}改为${.globals.x}
:)
8 楼 贾志新 2014-02-14  
good

7 楼 贾志新 2014-02-14  
sasasa
6 楼 西北小强 2012-11-08  
挺全面的,谢谢奉献哦
5 楼 jiangsha 2012-10-28  
freemarker使用有多种,如果和ServletContext结合使用,应该是这样。      
       <#if Session['key']??>
              <#if Session['key'].status==1 >
<input type="button" name="">
              <#elseif Session['key'].status==1 >
                  <input type="button" name="">
              </#if>
</#if>

yzz9i 写道
很不错啊!学习了。

请教下 我的一个java bean 对象设置到session中了 ,如果要判断bean的一个属性来显示不同的html代码的时候怎么做?


例如:A对象的属性 status状态有1、2

if(status==1){
<input type="button" name="">
}else if(status==2){
<input type="text" name="">
}

类似这种判断在ftl文件中怎么写代码?楼主请指点下我
4 楼 yzz9i 2012-10-26  
很不错啊!学习了。

请教下 我的一个java bean 对象设置到session中了 ,如果要判断bean的一个属性来显示不同的html代码的时候怎么做?


例如:A对象的属性 status状态有1、2

if(status==1){
<input type="button" name="">
}else if(status==2){
<input type="text" name="">
}

类似这种判断在ftl文件中怎么写代码?楼主请指点下我
3 楼 hanmiao 2012-07-14  
写了这么多,就是没有举例说明怎样写<#if></#if>里的条件表达式。
2 楼 cfying 2012-02-23  
1 楼 zhousheng193 2010-08-13  
值得学习,非常感谢!

相关推荐

    freemarker语法完整版

    Freemarker页面语法 A 概念 最常用的 3 个概念 sequence 序列,对应java 里的list 、数组等非键值对的集合 hash 键值对的集合 namespace 对一个ftl 文件的引用, 利用这个名字可以访问到该ftl 文件的资源 ...

    java freemarker 语法

    java 静态页面(freemarker)技术是java程序员项目开发中重要的技术,比如在网站项目开发中,生成静态页面有利于提高网速……本资源介绍关于freemarker技术的语法知识

    freemarker语法

    freemarker 语法介绍 FreeMarker的模板文件并不比HTML页面复杂多少,FreeMarker模板文件主要由如下4个部分组成: 1. 文本:直接输出的部分 2. 注释:格式部分,不会输出 3. 插值:即${...}或#{...}格式的部分,将使用...

    freemarker语法知识

    FreeMarker的模板文件并不比HTML页面复杂多少,FreeMarker模板文件主要由如下4个部分组成: 1,文本:直接输出的部分 2,注释:格式部分,不会输出 3,插值:即${...}或#{...}格式的部分,将使用数据模型中的部分替代输出 4,...

    freemarker资料集

    FreeMarker语法之表达式,FreeMarker如何生成静态页面,freemarker空值的多种处理方法,FreeMarker的优点和缺点,Freemarker的内置函数及用法

    超强freemarker使用总结,有示例有讲解,可做快速查询手册!!

    在开发web项目的时候使用到的页面展现技术,它并不复杂,只是有一些语法内容,但是在页面展现的时候往往因为忘记语法规范而需要查阅官方文档,这样做并不高效,因此做了一些总结工作。 总体,该文档能够提供所有常用...

    java Freemarker页面静态化实例详解

    Freemarker FreeMarker 是一个用 Java 语言编写的模板引擎,它基于模板来生成文本输出。FreeMarker与 Web 容器无关,即在 Web 运行时,它并不...Freemarker 语法 /** * freemark入门案例 * freemark三要素: * 1.

    SpringBoot_Freemarker生成Word_多个表格+两层嵌套循环

    SpringBoot_Freemarker生成Word_多个表格+两层嵌套循环; 步骤说明: 1.用Microsoft Office Word打开word原件;将文档中需要动态生成的内容,替换为属性名 ${name} 2.另存为,选择保存类型Word 2003 XML 文档(*....

    freemarker总结

    该指令用于导入FreeMarker模板中的所有变量,并将该变量放置在指定的Map对象中,import指令的语法格式如下: 上面的代码将导入/lib/common.ftl模板文件中的所有变量,将这些变量放置在一个名为com的Map对象中. 创建...

    超完整FreeMarker中文教程,代码

    什么是FreeMarker? ................................................................................................. 7 我们应该阅读什么内容? .............................................................

    freemaker语法文档

    虽然FreeMarker具有一些编程的能力,但通常由Java程序准备要显示的数据,由FreeMarker生成页面,通过模板显示准备的数据 FreeMarker不是一个Web应用框架,而适合作为Web应用框架一个组件 FreeMarker与容器无关,...

    FreeMarker 手册

    4.5 替换(方括号)语法 ................................................................................... 59 第二部分 程序开发指南 .......................................................................

    FreeMark学习笔记

    FreeMarker的模板文件并不比HTML页面复杂多少,FreeMarker模板文件主要由如下4个部分组成: 1,文本:直接输出的部分 2,注释:格式部分,不会输出 3,插值:即${...}或#{...}格式的部分,将使用数据模型中的部分替代输出 4,...

    FreeMarker模板引擎-其他

    虽然FreeMarker具有一些编程的能力,但通常由Java程序准备要显示的数据,由FreeMarker生成页面,通过模板显示准备的数据。 FreeMarker不是一个Web应用框架,而适合作为Web应用框架一个组件。FreeMarker与容器无关,...

    thymeleaf的使用

    本文来自于微信,本文主要介绍了...它的优点是语法优雅易懂、原型即页面、遵从web标准。原型即页面是它的特色,所谓原型即页面,就是你写的html,静态的去访问是什么样,动态的去访问还是这样,只不过动态的时候会把

    java版飞机大战源码-migo-freemaker:类似freemaker的Demo

    FreeMarker模板引擎与动态页面静态化 模板引擎可以让程序实现界面与数据分离,业务代码与逻辑代码的分离,这就提升了开发效率,良好的设计也使得代码复用变得更加容易。一般的模板引擎都包含一个模板解析器和一套...

    Struts2入门教程(全新完整版)

    9.N语法top语法 26 10.获取Stack Context中的信息 26 11.总结$ # %的区别 27 12.总结OGNL[重点] 27 五、拦截器 28 1.概述strust2中的拦截器 28 2.自定义拦截器 28 方式一,实现Interceptor接口。 28 方式二、继承...

    web-DB-tools:web平台数据库SQL执行工具,权限、SQL收藏、SQL分享、以及一些小工具、webSQL

    常用SQL收藏,编辑,删除,以及SQL分享给其他用户支持添加用户,权限配置,只读,读写,dml等支持定期密码更新提醒,只需一个配置设置密码必须更新的周期附带一些常用的开发工具,JSON格式化,freemarker语法测试,域名whois...

Global site tag (gtag.js) - Google Analytics