freemarker自学1.0

1.引入bootstrap4的css样式

<link href="https://cdn.bootcss.com/twitter-bootstrap/4.3.1
/css/bootstrap.css" rel="stylesheet">

2.list

<#assign thingsList = sqlt.sqlQueryForList("todo_list.getList")>
<#list thingsList as l>
    <div>${l.tid}--${l.type}--${l.content}</div>
</#list>

---

宏是在模板中使用macro指令定义

宏是和某个变量关联的模板片断，以便在模板中通过用户定义指令使用该变量，

调用宏时，与使用FreeMarker的其他指令类似，只是使用@替代FTL标记中的#

1.macro定义模板，然后调用直接显示

<#macro greet>
    <font size = "+2">Hello Alice!</font>
    <span class="text-primary">aliceRachel</span>
</#macro>
<@greet></@greet>
<@greet/>

2.在macro指令中可以在宏变量之后定义参数

<#macro greet person>
    <font size = "+2" class="text-danger">Hi~ ${person}</font>   
</#macro>
<@greet person="Prime"></@greet>
<@greet person="kamma"/>

3.macro 定义多个参数

<#macro greet1 person1 color="green">
    <font size = "+2" color="${color}">This is a good day! ${person1}===</font>
    
</#macro>
<@greet1 person1="Fred"></@greet1>
<@greet1 person1="Batman"/>

4.自定义指令嵌套内容 #nested>

macro可以有多个参数，参数的次序是无关的， 在macro指令中只能使用定义的参数，并且必须对所有参数赋值， 可以在定义参数时指定缺省值

<#macro border>
    <table border=4 cellspacing=0 cellpadding =4>
        <tr>
            <td>
                <#nested>
                 <#nested>
            </td>
             <td>
                <#nested>
            </td>
        </tr>
    
    </table>
</#macro>
<@border>The bordered text</@border>

ps：#nested>就相当于占位符,#nested>指令可以被多次调用

<#macro do_thrice>
    <#nested>
    <#nested>
    <#nested>
</#macro>
<@do_thrice>Beautiful</@do_thrice>

5.局部变量对嵌套内容不可见

<#macro repeat count> 
    <#local y = "test"> 
    <#list 1..count as x> 
      ${y} ${count}/${x}: <#nested> 
    </#list> 
</#macro> 

<@repeat count=3>${y?default("?")} ${x?default("?")} 
${count?default("?")}</@repeat> 

6.宏定义中使用循环变量

nested指令也可以有循环变量（循环变量的含义见下节），调用宏的时候在宏指令的参数后面，分号隔开依次列出循环变量的名字，格式如下：

尖括号@ macro_name paramter list; loop variable list[,]尖括号

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

---

---

java Freemarker中macro可以用于实现自定义指令, 通过使用自定义指令, 可以将一段模板片段定义成一个用户指令

name:指定的是该自定义指令的名字, 使用自定义指令时可以传入多个参数。 宏变量的名称，它不是表达式。和 顶层变量 的语法相同，比如 myMacro 或 my\-macro

paramX:指定使用自定义指令时报参数, 使用该自定义指令时,必须为这些参数传入值 （ 局部变量 的名称，存储参数的值 (不是表达式)，在 = 号后面和默认值(是表达式)是可选的。 默认值也可以是另外一个参数，比如 <#macro section title label=title>。参数名称和 顶层变量 的语法相同，所以有相同的特性和限制）

nested:输出使用自定义指令时的中间部分

nested指令中的循环变量:这此循环变量将由macro定义部分指定 ,传给使用标签的模板

return:可用于随时结束该自定义指令

基本格式：
<#macro name param1 param2 ... paramN>
  ...
  <#nested loopvar1, loopvar2, ..., loopvarN>
  ...
  <#return>
  ...
</#macro>
return 和 nested 指令是可选的，而且可以在 <#macro ...> 和 </#macro> 
之间被用在任意位置和任意次数。

1. macro简单例子

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

2. macro自定义循环输出的宏

<#macro list title items>
    <p>${title?cap_first}</p>
    <p>${title?capitalize}</p>
    <ul>
        <#list items as x>
            <li>${x?cap_first}</li>
        </#list>
    </ul>
</#macro>
<@list items=["mouse","elephant","python"] title="animals" />

3. macro结合参数使用

<div>
    <#macro test>
        <font color="blue">没有参数的macro</font>
    </#macro>
    <@test />
</div>
<div>
    <#macro test1 params1 params2>
        <font color="red">
        有参数的macro，params1=${params1},params2=${params2}</font>

    </#macro>
    <@test1 params1="java" params2="freemarker"/>
</div>
<div>
    <#macro test2 params1 params2="python">
        <font color="grey">
        	有参数默认值的macro，params1=${params1},params2=${params2}
        </font>
    </#macro>
    <br>
    <@test2 params1="alice" params2="prime" />
    <br>
    <@test2 params1="alice" />
</div>
<div>
    <#macro test3 params1 params2="python" paramExt...>
        <font color="green">
        	有多个参数的macro,params1=${params1},params2=${params2}
        </font>
        <br>
        <font color="blue">${paramExt['params3']}</font>
    </#macro>
    <@test3 params1="alice" params2="prime" 
    params3="javascript" params4="element"/>
</div>

4.宏嵌套nested 的使用

<#-- 嵌套宏 -->
<#macro border>
　　<table border="1">
　　　　<#nested>
        <#nested>
        <#nested>
　　</table>
</#macro>

<#-- 嵌套宏使用 -->
<@border>
　　<tr><td>hahaha</td></tr>
</@border> 

<#-- 嵌套宏 -->
<#macro border>
　　<table border="1">
　　　　<#nested>
        <#nested>
        <#nested>
　　</table>
</#macro>

<#-- 嵌套宏使用 -->
<@border>
　　<tr>
        <td>中国</td>
        <td>辽宁省</td>
        <td>大连市</td>
    </tr>
</@border>

<#-- 循环嵌套宏 -->
<#macro repeat count>
　　<#list 1..count as x>
    <#-- 使用nested指令时指定了三个循环变量  -->
　　　　<#nested x, x/2, x==count> 
　　</#list>
</#macro>

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

5. macro定义输出html的自定义指令

macro_copy.ftl 中内容为（以下）：

<#--  common.ftl 将一个HTML页面模板定义成一个page指令,则可以在其他页面中如此page指令  -->
<#macro page title>
<html>
<head>
   <title>FreeMarker示例页面 - ${title}</title>
</head>
<body>
   <h1>${title}</h1>
   <#nested>
    <#--  //用于引入用户自定义指令的标签体  -->
</body>
</html>
</#macro>

在本文件中进行引入：

<#--  引用自定义的page指令  -->
<#--  对应macro_copy.ftl使用  -->
<#import "macro_copy.ftl" as com>

<#-- macro定义输出html的自定义指令  -->
<#--  引用自定义的page指令  -->
<#--  对应macro_copy.ftl使用  -->
<#import "macro_copy.ftl" as com>
<@com.page title="book list">
<u1>
<li>spring</li>
<li>j2ee</li>
</ul>
</@com.page>
<p>
    1. macro是和某个变量关联的模板片断，
    以便在模板中通过用户定义指令使用该变量。
</p>
<p>
   2. 在macro进行自定义指令中可以在宏变量之后定义参数，
   调用宏时，与使用FreeMarker的其他指令类似，
   只是使用@替代FTL标记中的#。
</p>

5、nested指令

1）nested指令 是可选的，可以在#macro>

<#macro tag>  
    <#nested/>  
</#macro>  
<@tag>  
    <ul>  
        <li>1</li>  
        <li>2</li>  
        <li>3</li>  
        <li>4</li>  
        <li>5</li>  
    </ul>  
</@tag>  

function, return

构建函数，求平均值

<#function avg nums...>   
  <#local sum = 0>   
  <#list nums as num>   
    <#local sum = sum + num>   
  </#list>   
  <#if nums?size != 0>   
    <#return sum / nums?size>   
  </#if>   
</#function>   
<#--  15  -->
<span style="color:green;font-size:2rem">${avg(10, 20)}</span>   
<#--  25  -->
<span style="color:blue;font-size:2rem">${avg(10, 20, 30, 40)} </span>  
<#--  N/A    -->
<span style="color:pink;font-size:2rem">${avg()!"N/A"}  </span>   

自定义指令--嵌套的内容

<#macro border>
  <table border=4 cellspacing=0 cellpadding=4><tr><td>
    <#nested>
  </tr></td></table>
</#macro>
<#macro greet person color="pink">
  <font size="+2" color="${color}">Hello ${person}!</font>
</#macro>
<#macro do_thrice>
  <#nested>
  <#nested>
  <#nested>
</#macro>

<@border>
  <ul>
  <@do_thrice>
    <li><@greet person="Joe"/>
  </@do_thrice>
  </ul>
</@border>

因为 y， x 和 count 是宏的局部(私有)变量，从宏外部定义是不可见的。 此外不同的局部变量的设置是为每个宏自己调用的，所以不会导致混乱

<#macro repeat count>
  <#local y = "test">
  <#list 1..count as x>
    ${y} ${count}/${x}: <#nested>
    <br>
  </#list>
</#macro>
<@repeat count=3>${y!"?"} ${x!"?"} ${count!"?"}</@repeat>

<#macro test foo>${foo} (<#nested>) ${foo}</#macro>
<@test foo="A"><@test foo="B"><@test foo="C"/></@test></@test>

宏和循环变量

<#macro do_thrice>
  <#nested 1>
  <#nested 2>
  <#nested 3>
</#macro>
<@do_thrice ; x> <#-- user-defined directive uses ";" instead of "as" -->
  ${x} Anything.
</@do_thrice>

指令-字母全部大写

<#list ["red", "green", "blue"] as color>
    ${color?upper_case}
  </#list>