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

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

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

userdirective=my.package.here.MyDirectiveName

到我的velocity.properties文件.而且我知道我可以通过扩展指令类来编写这样的课程.我不知道的是如何扩展指令类 - 为新指令的作者提供某种文档.例如,我想知道我的getType()方法是否返回"BLOCK"或"LINE",我想知道我的setLocation()方法应该做什么？

有没有比" 使用源,卢克 " 更好的文档？

我整理了一篇关于编写自定义速度指令(和工具)的文章.也许有人会发现它很有用.