apache - 如何为 Apache Velocity 创建自定义指令

Question

我正在使用 Apache 的 Velocity 模板引擎，并且我想创建一个自定义指令。也就是说，我希望能够编写“#doMyThing()”并让它调用我编写的一些 java 代码以生成文本。

我知道我可以通过添加一行来注册自定义指令

userdirective=my.package.here.MyDirectiveName

到我的velocity.properties 文件。我知道我可以通过扩展 Directive class 来编写这样一个类。我不知道的是如何扩展指令类——为新指令的作者提供某种文档。例如，我想知道我的 getType() 方法是否返回“BLOCK”或“LINE”，并且我想知道我的 setLocation() 方法应该做什么？

有没有比“Use the source, Luke”更好的文档？

Answer 1

在 Velocity wiki 上，有一个来 self 名为“Hacking Velocity”的演讲的演示文稿和示例代码。它包括自定义指令的示例。