<#if condition><#elseif condition><#else></#if> 条g判断
<#list hash_or_seq as var></#list> 遍历hash表或者collectionQfreemakerUCsequenceQ的成员
<#macro name param1 param2 ... ><#nested param></#macro> 宏，无返回参?br /><#function name param1 param2><#return val></#function>函数Q有q回参数
var?member_function(...) 用函数对varq行转换QfreemakerUCؓbuild-ins。实际内部实现类似member_function(var, ...)
stringA[M .. N] 取子字符ԌcMsubstring(stringA, M, N)
{key:value, key2:value2 ...} 直接定义一个hash?br />[item0, item1, item2 ...] 直接定义一个序?br />hash0[key0] 存取hash表中key对应的元?br />seq0[5] 存取序列指定下标的元?br /><@function1 param0 param1 ... /> 调用函数function1
<@macro0 param0 param1 ; nest_param0 nest_param1 ...> nest_body < /@macro > 调用宏，q处理宏的嵌?br /><#assign var = value > 定义变量q初始化
<#local var = value> ?macro 或?function 中定义局部变量ƈ初始?br /><#global var = value > 定义全局变量q初始化
${var} 输出q替换ؓ表达式的?br /><#visit xmlnode> 调用macro匚wxmlnode本n及其子节?br /><#recurse xmlnode> 调用macro匚wxmlnode的子节点
<#if condition > </#if>
<#list SequenceVar as variable > repeatThis </#list>
<#include "/copyright_footer.html">
一个ftl标记不能攑֜另外一个ftl标记里面Q但是注释标记能够放在ftl标记里面?br />
pȝ预定义指令采?lt;#...></#>
用户自定义指令采?lt;@...></@>
hash片段可以采用Q?/strong> products[10..19] or products[5..] 的格式?br />
序列也可以做加法计算Qpasswords + {"joe":"secret42"}
~省? name!"unknown" 或?(user.name)!"unknown" 或?name! 或?(user.name)!
null值检? name?? or (user.name)??
转义列表Q?br />
Escape sequence | Meaning |
|---|---|
\" | Quotation mark (u0022) |
\' | Apostrophe (a.k.a. apostrophe-quote) (u0027) |
\\ | Back slash (u005C) |
\n | Line feed (u000A) |
\r | Carriage return (u000D) |
\t | Horizontal tabulation (a.k.a. tab) (u0009) |
\b | Backspace (u0008) |
\f | Form feed (u000C) |
\l | Less-than sign: < |
\g | Greater-than sign: > |
\a | Ampersand: & |
\{ | Curly bracket: { |
\xCode | Character given with its hexadecimal Unicode code (UCS code) |
如果x?{Q则需要将{转义Q可以写?$\{user}"Q或者可以用生字W（r指oQ：$(r "${xx}"}
序列构成Q?lt;#list ["winter", "spring", "summer", "autumn"] as x>${x}</#list>
不同的对象可以存攑֜一个序列里面，比如Q?font color="#a03d10">[2 + 2, [1, 2, 3, 4], "whatnot"]. W一个是数字Q第二个是序列，W三个是字符丌Ӏ?br />
可用采用start..end的方式来定义一个数字序列，start可以于endQ同Ӟend也可以省略?br />
hash取值支持一下四U模式：book.author.name, book["author"].name, book.author.["name"], book["author"]["name"].
Ҏ变量是指freemaker引擎本n定义的变量。访问时Q以.variable_name的语法访问?br />
变量表达式支持嵌套模式，比如Q?{"Hello ${user}!"}?br />
变量表达式在指o中的使用情况Q?br />变量表达式可以在指o中，用“”的方式存在Q不如：<#include "/footer/${company}.html">.
但是不允怸面的方式存在Q?<#if ${isBig}>Wow!</#if>, 正确写法是：<#if isBig>Wow!</#if>.
而且 <#if "${isBig}">Wow!</#if>写法也不正确Q因?${isBig}"q回的是字符Ԍ不是booleancd?br />
字符串中取字W或字符串采用以下语法：${user[0]},${user[0..2]} ${user[4..]},${user?string(4)}
序列操作Q?br /> 加法Q?lt;#list ["Joe", "Fred"] + ["Julia", "Kate"] as user> 但要注意串联之后的读取速度变慢?br /> 子序列：seq[1..4]
序列和hash的串联都只能用于两个相加Q不能有多个相加的模式，hash相加Q如果两个相加的hash存在相同的keyQ则后面会覆盖前面的?br />
在?gt;=或?gt;Ӟ需要注意一些问题，因ؓfreemaker会将>解释成标记的关闭W，Z解决q个问题Q需要在表达式加上括P比如Q?<#if (x > y)>. 或者?> and <W号来代ѝ?/tt>
无值变量（包括无该变量QnullQ返回voidQ无属性等Q：unsafe_expr!default_expr or unsafe_expr! or (unsafe_expr)!default_expr or (unsafe_expr)!
~省值可以是McdQ不一定是数字Q比如：hits!0 或?colors!["red", "green", "blue"].
如果~省值忽略，那么会默认为空丌Ӏ空序列或者空hashQ因为freemarker支持多类型的倹{不q要让默认gؓ0或falseQ则不能省略~省倹{?br />
非顶层变量的无值处理：
product.color!"red"Q只处理product不ؓI，color为空的缺省值处理，如果product为空Q则freemaker会抛出异常?product.color)!"red"Q则会处理product为空Qcolor为空Q或者没有color属性的无值情c?br />
无值变量的判断操作Q?em>unsafe_expr?? or (unsafe_expr)??
普通变量插入方? ${expression},${3+5);
数字变量插入方式: #{expression} or #{expression; format}Q过期?br />变量只能用于文本区或者是字符串里面，比如Q?lt;h1>Hello ${name}!</h1>以及 <#include "/footer/${company}.html">
数字值的插入Q根据缺省的number_format输出Q以及可以通过setting来达到设|数字格式的目的Q也可以通过内置函数string来改变输出格式?br />
日期cd的格式设|：date_format, time_format ?datetime_format
定义宏：
不带参数Q?b><#macro 宏名>...</#macro>Q引?lt;@宏名 />
带参敎ͼ<#macro 宏名 参数...>...</#macro>Q引?lt;@宏名 参数1=?.../>Q带有参数的宏，调用是参数的值必d参数的个数相同。当然也可以在宏定义时给参数一些默认倹{比如：<#macro greet person color="black">
宏里面的嵌套内容Q?br /><#macro border>
<table border=4 cellspacing=0 cellpadding=4><tr><td>
<#nested>
</tr></td></table>
</#macro>
在宏的定义body中加?lt;#nested>指o。嵌套的内容可以是Q何正的ftl块?br />
宏的本地变量在嵌套内容中是不可见的?br />
宏定义时Q?lt;#nest>指o相当于调用定义的内容Q而用宏Ӟnest body相当于定义?br />
<#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>
定义变量Q?br /> 在模板中定义的变量将会隐藏（不是更改Q数据模型根下面的同名的变量?br />
模板中的3U类型变量：
1Q?strong>plain variablesQ能够在模板中的M地方讉KQ一个模板include另外一个模板，也可以访问被包含模板的变量。可以通过assign或者macro指o产生或替换变量?br /> 如果要访问数据模型中的变量，则可以通过.global来访问：
<#assign user = "Joe Hider">
${user} <#-- prints: Joe Hider -->
${.globals.user} <#-- prints: Big Joe-->
2Q?strong>Local variablesQ宏定义body中用local指o创徏或者替换?br /> 3QLoop variables:由list指o产生?br />
namespaces:
<#import "/lib/my_test.ftl" as my> <#-- the hash called "my" will be the "gate" -->
<@my.copyright date="1999-2002"/>
${my.mail}
讄命名I间里面的变量：<#assign mail="jsmith@other.com" in my>
命名I间与数据模型：命名I间的ftl可以讉K数据模型的变量。同样命名空间的变量也会隐藏数据模型中同名的变量?br />
I白问题Q?br />1QWhite-space strippingQ默认ؓenabledQ清除ftl标记带来的空白以及羃q。处理模板的I白?br />2Qt, rt, lt指o?br />3Qftl的参数strip_text.
用compress directive或者transform来处理输出?br /><#compress>...</#compress>Q消除空白行?br /><@compress single_line=true>.../@compress输出压~ؓ一行?br />
可替换语法：
freemarker可用"["代替"<".在模板的文g开头加?strong>[#ftl].
]]>
${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 Qmiddle和long?br />
${openingTime?string.short}
${openingTime?string.medium}
${openingTime?string.long}
l合使用Q?{lastUpdated?string.short_long}${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")}
三：逻辑?br />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>
chunkQ将一个序列分解成几个序列?br />
<#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>
chunkl常用于分栏或者表D出的格式?br />
五：hash内置ҎQ?br />
keysQ?br />valuesQ?br />
六：很少使用或者专家的内|方法：
byte,double,float,int,long,short?br />
eval
has_contentQ变量存在，不是指null也不是空Ԍ一般情况下可以使用expr!?size > 0 or expr!?length > 0 代替expr?has_content?br />
interpret一个字W串解析为ftl模版Q生一?font face="Courier New" color="#a03d10">TemplateTransformModel对象?br /><#assign x=["a", "b", "c"]>
<#assign templateSource = "<#list x as y>${y}</#list>">
<#assign inlineTemplate = templateSource?interpret>
<@inlineTemplate>def/@inlineTemplate
is_...查变量类型：
Built-in | Returns true if the value is a ... |
|---|---|
is_string | string |
is_number | number |
is_boolean | boolean |
is_date | date (all types: date-only, time-only and date-time) |
is_method | method |
is_transform | transform |
is_macro | macro |
is_hash | hash |
is_hash_ex | extended hash (i.e. supports ?keys and ?values) |
is_sequence | sequence |
is_collection | collection |
is_enumerable | sequence or collection |
is_indexable | sequence |
is_directive | macro or transform |
is_node | node |
namespaceQ返回宏变量的命名空_只能用于宏?br />
newQ创Z个TemplateModel实现的变量?br /><#assign word_wrapp = "com.acmee.freemarker.WordWrapperTransform"?new()>
]]>
Configuration cfg = new Configuration();
cfg.setDirectoryForTemplateLoading(new File("/where/you/store/templates"));
cfg.setObjectWrapper(new DefaultObjectWrapper());
2Q得到模板对象：
Template temp = cfg.getTemplate("test.ftl");
Configuration对Template对象q行~存?br />
3Q合q模板和数据模型Q?br />Writer out = new OutputStreamWriter(System.out);
temp.process(root, out);
out.flush();
4Q数据模型：
M模板要用的数据模型都是通过object wrapping传入的对象包装成实?/strong>TemplateModel接口的对象?br /> TemplateModel提供几个下接口Q?font face="Courier New" color="#a03d10">TemplateSequenceModel{?/font>
5Q单值模型：Scalars
Boolean
Number
String
Date
Template
Type
Model
6Q方法 ?br />public class IndexOfMethod implements TemplateMethodModel {
public TemplateModel exec(List args) throws TemplateModelException {
if (args.size() != 2) {
throw new TemplateModelException("Wrong arguments");
}
return new SimpleNumber(
((String) args.get(1)).indexOf((String) args.get(0)));
}
}
root.put("indexOf", new IndexOfMethod());
<#assign x = "something">
${indexOf("met", x)}
${indexOf("foo", x)}
7QTransforms
import java.io.*;
import java.util.*;
import freemarker.template.TemplateTransformModel;
class UpperCaseTransform implements TemplateTransformModel {
public Writer getWriter(Writer out, Map args) {
return new UpperCaseWriter(out);
}
private class UpperCaseWriter extends Writer {
private Writer out;
UpperCaseWriter (Writer out) {
this.out = out;
}
public void write(char[] cbuf, int off, int len)
throws IOException {
out.write(new String(cbuf, off, len).toUpperCase());
}
public void flush() throws IOException {
out.flush();
}
public void close() {
}
}
}
root.put("upperCase", new UpperCaseTransform());
<@upperCase>
blah2
blah3
</@upperCase>
8Q访问freemarker的环境变量：Environment.getCurrentEnvironment().
9Q共享变量是指所有模杉K能访问的变量Q在configuration中设|?br /> cfg.setSharedVariable("to_upper", new UpperCaseTransform());
cfg.setSharedVariable("company", "Foo Inc.");
数据模型中的变量会隐藏同名的共享变量?br />
TemplateModel的实C是线层安全的Q因此不能用于共享变量?br />
预置׃n变量Q?br />
10Q设|层ơ：configuration, template, runtime environment
import java.io.*;
import java.util.*;
import freemarker.template.TemplateTransformModel;
class UpperCaseTransform implements TemplateTransformModel {
public Writer getWriter(Writer out, Map args) {
return new UpperCaseWriter(out);
}
private class UpperCaseWriter extends Writer {
private Writer out;
UpperCaseWriter (Writer out) {
this.out = out;
}
public void write(char[] cbuf, int off, int len)
throws IOException {
out.write(new String(cbuf, off, len).toUpperCase());
}
public void flush() throws IOException {
out.flush();
}
public void close() {
}
}
}
root.put("upperCase", new UpperCaseTransform());
<@upperCase>
blah2
blah3
</@upperCase>
8Q访问freemarker的环境变量：Environment.getCurrentEnvironment().
9Q共享变量是指所有模杉K能访问的变量Q在configuration中设|?br /> cfg.setSharedVariable("to_upper", new UpperCaseTransform());
cfg.setSharedVariable("company", "Foo Inc.");
数据模型中的变量会隐藏同名的共享变量?br />
TemplateModel的实C是线层安全的Q因此不能用于共享变量?br />
预置׃n变量Q?br />
name | class |
|---|---|
capture_output | freemarker.template.utility.CaptureOutput |
compress | freemarker.template.utility.StandardCompress |
html_escape | freemarker.template.utility.HtmlEscape |
normalize_newlines | freemarker.template.utility.NormalizeNewlines |
xml_escape | freemarker.template.utility.XmlEscape |
10Q设|层ơ：configuration, template, runtime environment
]]>