Velocity介绍
Velocity是一个基于java的template engine。它允许Web designer引用Java Code中定义的方法。Web designer可以和Java工程师根据MVC模型并发编程。也就是说，Velocity使得Java开发和网页开发分离。
Velocity还可以根据template可以生成web pages, SQL, PostScript和其他输出，或者和其他系统的组件集成。
Velocity Template Language(VTL)
VTL在web site中使用reference嵌入动态内容。变量是reference的一种。比如下面的例子
#set( $a = "Velocity" )
这条VTL语句，#set是指令，$a是变量。String值的变量使用单引号或者双引号括起来，单引号表示raw string，双引号或得到解析后的值。
Rule of thumb: References begin with $ and are used to get something. Directives begin with # and are used to do something.
Reference
VTL有三种reference: 变量, properties和方法。作为使用VTL的设计者，你和你的工程师必须就reference的名字达成一致。这是协议！
- 变量，以#开头，然后就是identifier。比如 $foo
- properties，有独特的格式。比如 $customer.name，它可以是map中key=name的值，也可以作为方法调用的缩写
- 方法，和properties格式相近。比如 $customer.getAddress or $customer.Address
从Velocity 1.6开始，所有array reference被看做是固定长度的list。这意味着你可以在array reference上使用 java.util.List所有方法
Directive
Reference允许template designer在web sites中生成动态内容。指令——使用脚本元素操作Java code的输出
- #set 用来给变量赋值，只可以是reference类型（变量，properties和methods），literal类型（string, number）, arraylist or map
- #if / #else / #elseif
- #foreach，遍历
- #include，原地import本地文件，但是内容不被rendered
- #parse，不仅可以import VTL文件，还可以parse & render
- #evaluate，动态evaluate VTL。This allows the template to evaluate a string that is created at render time
- #block，定义VTL代码块
- #macro，定义宏
- ...
Example
最近遇到一个需要局部定制template的case。这要求template能动态render
JavaCode
|
public void test1() { VelocityEngine velo = new VelocityEngine(); velo.setProperty(RuntimeConstants.RESOURCE_LOADER, "classpath"); velo.setProperty("classpath.resource.loader.class", ClasspathResourceLoader.class.getName()); velo.init(); VelocityContext context = new VelocityContext(); Map<String, String> alert = new HashMap<>(); alert.put("timestamp", "20160719"); alert.put("policy", "policy description"); String tpl = "<ul><li>cluster:${alert.timestamp}</li><li>colo:${alert.policy}</li></ul>"; context.put("tpl" , tpl); context.put("alert", alert); Template tmpl = velo.getTemplate("ALERT_TEST.vm"); StringWriter writer = new StringWriter(); tmpl.merge(context, writer); LOG.info(writer.toString()); } |
ALERT_TEST.vm
|
... #evaluate($tpl) … |
Useful Links
- Velocity中文入门
- https://github.com/putaoshu/jdf/blob/master/doc/core_vm.md
- http://www.cnblogs.com/yasin/archive/2010/04/02/1703188.html
- Velocity官网
- http://velocity.apache.org/engine/1.7/user-guide.html#user-guide-contents
- Bosun Template
- https://golang.org/pkg/text/template/
- Bosun官网
- https://bosun.org/quickstart