[Z]Freemarker实现自定义标签

一、 用macro实现自定义指令，例如：

自定义指令可以使用macro指令来定义。

<#macro greet person>

<font size="+2">Hello ${person}!</font>

</#macro>

macro指令自身不打印任何内容，它只是用来创建宏变量，所以就会有一个名为greet的变量。

使用这个宏：

<@greet person="Fred"/>

会打印出：

<font size="+2">Hello Fred!</font>

二、用java代码标签实现自定义指令：

可以使用TemplateDirectiveModel接口在Java代码中实现自定义指令。
简单示例如下：


1、实现TemplateDirectiveModel接口。

            public class UpperDirective implements TemplateDirectiveModel {

                  public void execute(Environment env,

                           Map params, TemplateModel[] loopVars,

                           TemplateDirectiveBody body)

                           throws TemplateException, IOException {

                            if (!params.isEmpty()) {

                             throw new TemplateModelException(

                               "parameters 此处没有值！");

                            }

                           if (loopVars.length != 0) {

                           throw new TemplateModelException(

                          " variables 此处没有值！");

                          }

                         if (body != null) {

                         //执行nested body  与FTL中 <#nested> 类似。

                     body.render(new UpperCaseFilterWriter(env.getOut()));

                         } else {

                        throw new RuntimeException("missing body");

                         }

                    }

           private static class UpperCaseFilterWriter extends Writer {

           private final Writer out;

           UpperCaseFilterWriter (Writer out) {

            this.out = out;

        }        

        public void write(char[] cbuf, int off, int len)

            throws IOException {

            char[] transformedCbuf = new char[len];

                for (int i = 0; i < len; i++) {

                               transformedCbuf[i] = Character.toUpperCase(cbuf[i + off]);

                }

                    out.write(transformedCbuf);

            }

        public void flush() throws IOException {

                out.flush();

            }

                public void close() throws IOException {

                out.close();

                }

           }

       }

 

说明：<#nested>指令执行位于开始和结束标记指令之间的模板代码段。

2、注入FreeMarkerConfigurer的freemarkerVariables中。 例如：在jeecms-servlet-front.xml <entry key="upper" value-ref="upper"/> <bean id="upper" class="com.example.UpperDirective" /> 说明: FreeMarkerConfigurer. 、setFreemarkerVariables(Map<String,Object> variables) 底层调用了FreeMarker的Configuration.setAllSharedVariables()方法。 因为更好的实践是将常用的指令作为共享变量放到Configuration中。

3、调用自定义指令：

 [@upper]

             bar

             [#list ["red", "green", "blue"] as color]

                  ${color}

            [/#list]

            baaz

     [/@upper]

4、显示输出结果： BAR RED GREEN BLUE BAAZ