PlayFramework 1 自定义标签 -- FastTags

最早是用 HTML 来自定义标签，现在觉得 HTML 写有关逻辑的代码就有点不伦不类了，HTML 里着重是显示代码。前有一篇 PlayFramework 1 模板应用 -- Java 对象扩展 学习了对 Java 对象扩展的方式，如果不是基于已有对象类型进行方法扩展来进行调用，就可以自定义 FastTags 的方式。

Java 对象扩展的使用是 ${obj.abc()}, FastTags 标签是 #{abc}...${/abc}。

FastTags 标签类继承自 play.templates.FastTags，标签对应方法的原型是

public static void _tagName(Map<?, ?> args, Closure body, PrintWriter out,     ExecutableTemplate template, int fromLine)

这些都是得益约定优于配置，下面来几个例子，分别说明默认参数，命名参数，及多参数，标签体的处理。

上面定义了一个 hello 标签，标签参数从 args 中获取，默认参数名是 arg，标签体用 body 获得。在 HTML 页面中应用

#{hello 'Yanbin'}Good Morning#{/hello}
#{hello arg:'Yanbin'}Good Morning#{/hello}

多个参数时

页面中写成，用逗号分隔

#{hello name:'Yanbin', greeting:'Good Morning'/}

默认参数名和命名参数同时使用

#{hello 'Yanbin', greeting:'Good Morning'/}

没指定名字的参数名是 arg。

最后，无论是在自定义标签还是在扩展的 Java 对象方法中都可以直接使用 request, params, flash, session, play, messages, errors, lang, out 对象，见 Implicit objects available in a template。

FastTags 标签可以有自己的命名空间，如为了避免与默认命名空间里的 play.templates.FastTags 中定义的标签冲突，可以为自己的标签类 @FastTags.Namespace("my.tags") 加标注，如

这样，使用该标签就用

#{my.tags.hello 'Yanbin'/}

@FastTags.Namespace  就像是命名包一样，随便你指定什么样的层次。