有人可以解释如何使用FastTags

Question

有两种通过play框架创建海关标签的方法。

1. 通过在app / view / tags中定义一个Groovy模板
2. 通过在类中直接扩展FastTag直接在纯Java中

没有最新的文件。

Answer 1

因此，类似于JavaExtensions通过扩展JavaExtensions类的工作方式，要创建FastTag，您需要创建一个扩展FastTags的类。您要作为标记执行的每个方法都必须符合以下方法结构。

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

注意标记名称前的下划线。

要了解如何构建实际的标签，最简单的方法是查看FastTag的源代码，并查看实际的代码。

这是直接来自git hub的源代码。
https://github.com/playframework/play/blob/master/framework/src/play/templates/FastTags.java

下面是我复制的一些内容，以便我可以解释它的工作原理。

public static void _verbatim(Map<?, ?> args, Closure body, PrintWriter out, ExecutableTemplate template, int fromLine) {
    out.println(JavaExtensions.toString(body));
}

因此，第一个方法是 逐字
标记，仅在JavaExtensions上调用toString方法，然后传入标记的主体。标签的主体可以在打开和关闭标签之间。所以

<verbatim>My verbatim</verbatim>

身体价值将是

My verbatim

第二个示例稍微复杂一些。它是一个依赖于父标记起作用的标记。

public static void _option(Map<?, ?> args, Closure body, PrintWriter out, ExecutableTemplate template, int fromLine) {
    Object value = args.get("arg");
    Object selectedValue = TagContext.parent("select").data.get("selected");
    boolean selected = selectedValue != null && value != null && selectedValue.equals(value);
    out.print("<option value=\"" + (value == null ? "" : value) + "\" " + (selected ? "selected=\"selected\"" : "") + "" + serialize(args, "selected", "value") + ">");
    out.println(JavaExtensions.toString(body));
    out.print("</option>");
}

该代码通过输出HTML选项标签来工作，并通过检查从父标签中选择了哪个值来设置所选值。前3行仅获取数据，并准备好要输出的数据。然后，最后3行输出标签的结果。

我链接到的源代码中还有更多示例，它们的复杂程度各不相同，但是希望这对您来说是一个很好的起点。

为确保您的标签在项目之间或与核心Play标签不会冲突，您可以使用类级别的注释@ FastTags.Namespace设置名称空间。

因此，对于问候标签，在my.tags的命名空间中，您可以执行以下操作

@FastTags.Namespace("my.tags") 
public class MyFastTag extends FastTags {
    public static void _hello (Map<?, ?> args, Closure body, PrintWriter out, ExecutableTemplate template, int fromLine) {
        ...
    }
}

然后在模板中，您可以将hello标签引用为

#{my.tags.hello/}