在 FreeMarker 模板引擎中，除了基本的变量替换和条件判断，它还提供了一些高级特性，包括宏、函数和自定义指令。这些特性可以帮助我们更高效地编写模板，并增加模板的可重用性和灵活性。
宏 (Macros)
宏是一种可重用的代码块，类似于其他编程语言中的函数。通过定义和调用宏，我们可以在模板中复用一段代码。使用宏可以简化模板的结构，减少冗余的代码，并提高开发效率。
在 FreeMarker 中，我们可以通过以下方式定义一个宏：
<#macro macroName [arg1, arg2, ...] [arg1Type, arg2Type, ...]>
宏内容
</#macro>
其中：
macroName：宏的名字。arg1, arg2, ...：宏的参数名。arg1Type, arg2Type, ...：宏的参数类型，可选。
下面是一个示例宏的定义：
<#macro welcomeMessage name>
Welcome ${name}!
</#macro>
我们可以通过以下方式调用宏：
<@welcomeMessage name="John" />
上述调用会输出：
Welcome John!
宏也可以像函数一样返回值。我们可以使用 return 语句来指定宏的返回值，例如：
<#macro sumAndMultiply a b>
<#return (a + b) * 2>
</#macro>
该宏接收两个参数 a 和 b，将它们相加之后乘以 2，并通过 return 语句返回结果。我们可以通过以下方式调用该宏：
<#assign result = sumAndMultiply(2, 3)>
${result}
上述调用会输出：
10
函数 (Functions)
除了宏之外，FreeMarker 还支持函数。函数类似于宏，但有以下区别：
- 宏可以包含任意数量的语句，而函数只能包含一个表达式。
- 宏被调用时使用
<@macroName>语法，而函数被调用时使用${functionName}或#{functionName}语法。
要在 FreeMarker 中定义一个函数，可以使用以下语法：
<#function functionName [arg1, arg2, ...] [arg1Type, arg2Type, ...]>
表达式
</#function>
以下是一个示例函数的定义：
<#function calculateSum a b>
<#return a + b>
</#function>
我们可以通过以下方式调用该函数：
${calculateSum(2, 3)}
上述调用会输出：
5
函数可以带有参数类型。类型用于标识函数的输入参数类型，以便在需要时进行强制转换。例如：
<#function calculateSum a as x b as y>
<#return a + b>
</#function>
在上面的示例中，a 的类型被指定为 x，b 的类型被指定为 y。这样在函数内部对参数的使用会自动进行类型转换。
自定义指令 (Directives)
自定义指令是一种自定义的 FreeMarker 模板指令。通过自定义指令，我们可以在模板中添加自定义的语法，用于执行一些特定的操作。自定义指令扩展了 FreeMarker 的默认语法，提供了更高级的功能。
自定义指令的语法如下：
<#directiveName [arg1=value1 arg2=value2 ...]>
指令内容
</#directiveName>
自定义指令的名称可以是任意的标识符，但建议使用大写字母开头。
以下是一个示例自定义指令的定义：
<#upper text>
${text?upper_case}
</#upper>
上述自定义指令名为 upper，它会将传入的文本转换为大写并输出。
我们可以通过以下方式调用该指令：
<@upper text="hello world" />
上述调用会输出：
HELLO WORLD
自定义指令可以带有参数，并且可以在指令内部进行处理。例如，我们可以定义一个自定义指令 ifNotNull，用于检查变量是否为 null，并根据结果执行相应的操作：
<#ifNotNull var>
${var}
<#else>
Variable is null.
</#ifNotNull>
在上面的示例中，如果变量 var 不为 null，则会输出变量的值；否则，会输出 "Variable is null."。
总结
在 FreeMarker 中，宏、函数和自定义指令是它的高级特性，可以提高模板的可重用性和灵活性。通过定义和调用宏，我们可以复用一段代码；函数可以执行一段表达式并返回结果；自定义指令可以添加自定义的语法，用于执行特定的操作。掌握这些高级特性将帮助我们更有效地使用 FreeMarker 进行模板开发。
本文来自极简博客，作者：后端思维，转载请注明原文链接：FreeMarker高级特性：宏、函数与自定义指令
