java - 是否可以通过编程方式创建 Freemarker 宏？

Question

Freemarker 被用作 ninja web 框架中的默认模板引擎。该框架将一些默认值分配给模板，这些默认值在使用 ninja web 框架时全局可用。我已经为启用 CSRF 保护的模板创建了一个扩展。该扩展提供了一个可以在模板中使用的功能，例如

${foo(bar)}

目前需要使用特定参数调用函数，这不是很直观。使用宏我可以简化对

的调用

@{foo}

并且用户无需担心传递正确的(例如“bar”)参数。但是要在 ninja web 框架中使用它，我必须以编程方式定义一个宏。这可能吗？

更新

抱歉造成混淆。意味着 <@foo/> 而不是 @{foo} ...

查看 Freemarker 文档，我也许可以更清楚地了解我想要实现的目标:http://freemarker.org/docs/ref_directive_macro.html

就像我上面解释的那样，我将一个自定义函数传递给模板，使我能够调用

${foo("bar")}

我想做的是通过像这样的宏来调用它

@<myMacro/>

但是定义的宏就像

<#macro myMacro>
  ${foo("bar")}
</#macro> 

不应在模板中定义，而应以编程方式定义。希望这能让它更清楚。

更新 2/解决方案

我最终使用了推荐的 TemplateDirectiveModel。

public class TemplateEngineFreemarkerAuthenticityTokenDirective implements TemplateDirectiveModel {
    private String authenticityToken;

    public TemplateEngineFreemarkerAuthenticityTokenDirective(Context context) {
        this.authenticityToken = context.getSession().getAuthenticityToken();
    }

    @Override
    public void execute(Environment env, Map params, TemplateModel[] loopVars, TemplateDirectiveBody body) throws TemplateException, IOException {
        if (!params.isEmpty()) {
            throw new TemplateException("This directive doesn't allow parameters.", env);
        }

        if (loopVars.length != 0) {
            throw new TemplateException("This directive doesn't allow loop variables.", env);
        }

        Writer out = env.getOut();
        out.append(this.authenticityToken);
    }
}

Answer 1

FreeMarker 宏调用看起来不像 @{...}。那是某种 Ninja 特定的扩展吗？

无论如何，如果您知道数据模型中有一个 bar，那么您的方法可以像 Environment.getCurrentEnvironment().getDataModel().get("bar")，所以不需要传入。

另外，了解 FTL 有两种“子程序”，类函数的和类指令的可能很有用。两者都可以在 FTL(#function、#macro)和 Java(普通 Java 方法、TemplateMethodModelEx、TemplateDirectiveModel)。真正的区别在于，类似函数的用于计算值，而类似指令的用于将值直接打印到输出(因此绕过自动转义)和副作用。但是所有这些都可以到达 Environment，所以那里没有区别。