freemarker 自定义一个list 标签，ListDirective

要自定义一个名为 ListDirective 的 FreeMarker 指令，你需要遵循以下步骤：

1. 创建一个 Java 类来实现指令。这个类应该继承 `freemarker.template.TemplateDirectiveModel` 接口，并且需要实现 `execute()` 方法，该方法会被 FreeMarker 引擎调用来处理指令。

import java.util.Map;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import freemarker.core.Environment;
import freemarker.template.*;

public class ListDirective implements TemplateDirectiveModel {

    public void execute(Environment env,
                        Map params, TemplateModel[] loopVars,
                        TemplateDirectiveBody body)
            throws TemplateException, java.io.IOException {

        // 在这里编写逻辑来处理指令
        // ...

    }
}

2. 在 `execute()` 方法中编写处理逻辑。在这里，你需要解析和验证指令参数，并使用 `TemplateModel` 对象来获取指令所在的模板环境和输出流。你也需要创建一个 `SimpleScalar` 对象来包装列表数据，并将其放入模板环境中。

public void execute(Environment env,
                    Map params, TemplateModel[] loopVars,
                    TemplateDirectiveBody body)
        throws TemplateException, java.io.IOException {

    // 解析和验证指令参数
    String listName = DirectiveUtils.getRequiredParam(params, "name");
    Object listData = DirectiveUtils.getRequiredParam(params, "data");

    // 获取模板环境和输出流
    Writer out = env.getOut();
    PageContext pageContext = (PageContext) env.getCustomAttribute("PageContext");
    if (pageContext == null) {
        throw new JspException("PageContext not found");
    }

    // 创建 SimpleScalar 对象来包装列表数据
    SimpleScalar listModel = new SimpleScalar(listData.toString());

    // 将 SimpleScalar 对象放入模板环境中
    env.setVariable(listName, listModel);

    // 处理指令内容
    if (body != null) {
        body.render(out);
    }
}

3. 将自定义指令注册到 FreeMarker 引擎中。你可以使用 `Configuration` 对象的 `setSharedVariable()` 方法将指令实例添加到引擎中。

import freemarker.template.Configuration;

Configuration cfg = new Configuration(Configuration.VERSION_2_3_30);
cfg.setSharedVariable("list", new ListDirective());

现在，你就可以在模板中使用自定义指令了：

<@list name="myList" data=[1, 2, 3]>
  <#list myList as item>
    ${item}
  </#list>
</@list>

这将输出：

1
2
3