Unmi 学习 Groovy 之模板

提起模板,在 Java 领域中无疑会让人想起 Velocity 和 FreeMarker,可也不要忽略了,和我们最早打交道的 JSP 其实也是一种模板。模板一般都用来作为数据显示分离的显示部分,即 MV 的 V。比如说我目前在 Web 展示和发送邮件时较多的用到模板。通常模板用占位符创建的一个文本,或者串文本、输入流等。这些占位符可以用自己的流程控制代码,所以相应的就有的各种模板语言,例如 VTL(Velocity Template Language)、FTL(FreeMarker Template Language)、自然 JSP 也有算上。

有了模板,再把模型数据和模板进行归并就能得到我们真正想要的数据展现了,这当中的工作就是叫做模板引擎的干的。Groovy 中包含了抽象的 groovy.text.TemplateEngine 类和 groovy.text.Template 接口。可见 Groovy 表现的很开放,它们使得将任何模板引擎插入到 Groovy 中成为可能,比如 Velocity 或者 FreeMarker 引擎,可惜现在还没有。

查看 groovy.text 包 http://groovy.codehaus.org/api/groovy/text/package-frame.html,我们可以看到 Groovy(当前版本 1.6-beta-1) 自己提供了GStringTemplateEngine、SimpleTemplateEngine、XmlTemplateEngine 三个模板引擎实现。我们在本篇介绍的是 SimplateTemplateEngine 的实现,其他两个引擎实现的应用留给读者自己研究。

groovy.text.SimpleTemplateEngine 这个引擎提供了类似于 JSP 2.0 的语法,并支持嵌入到模板中的下列表达式:

·<% statements %> -- 执行任何有效的 Groovy 语句
·<%=expression%> -- 将一个 Groovy 表达式的值嵌入到模板中
·${expression}        -- 将一个 Groovy 表达式的值嵌入到模板中的另一种写法

下面我们用个完整的例子来说明 SimpleTemplateEngine 的用法,熟悉 Velocity 的朋友可以进行对比来理解。笔者之前写过一篇 Velocity 的入门的文章:掌握一种Java模板技术 -- Velocity,可请参考。

首先创建模板文件 userinfo.template

<html> <head><title><%=title%></title></head> <body> <table border="1"> <tr><td>姓名</td><td>性别</td></tr> <% users.each{user-> out. println "<tr><td>${user.name}</td><td>${user.gender}</td></tr>" } %> </table> ${footer} </body> </html>

在这个模板文件中,我们用到了前面提到的三种语法。因为下面的代码是通过 File 形式从当前目录被 TemplateEngine 加载的,所以这个模板文件应该放到 System.getProperty("user.dir") 所在的目录。其他时候要根据 TemplateEngine.createTemplate() 的参数来决定模板文件安放的位置。

然而是使用模板的 Groovy 代码

import groovy.text.Template import groovy.text.SimpleTemplateEngine import groovy.text.TemplateEngine TemplateEngine engine = new SimpleTemplateEngine() Template template = engine.createTemplate(new File("userinfo.template")) //声明要绑定(或者叫合并)到模板的一个 Map 对象 users = [[name:"Unmi",gender:"male"],[name:"hy",gender:"female"]] //把模型数据归并到模板中,通过 Map 来传递参数 Writable result = template.make(title:"显示用户信息",users:users,footer:"&copy;Made by Unmi") //把归并后的结果输出来控制台 result.writeTo(new PrintWriter(System.out)) //如果是作为一个 Groovylet writeTo() 语句就可以写成 result.writeTo(out) //out 是 Groovlet 的内置变量 //或者不用上面的 writeTo() 方法,直接 toString() 能得到一样的结果 //print result.toString() //再干练点就是 print result

对上面的代码要加以说明一下了:

TemplateEngineEngine 抽象类的 createTemplate() 可接受 File、URL、String 或 Reader 参数,这就意味着我们的模板可以表现为多种形式,而不仅仅是一个文件模板。

要绑定(或者叫归并) 到模板的数据是在 Template.make(Map map) 中通过 Map 参数传递过去的。

这里的 TemplateEngine.createTemplate() 就相当于 Velocity 的 VelocityEngine.getTemplate() 或 Velocity.getTemplate() 方法,Velocity 的这两个方法也是可以接受多种类型参数的。

Template.make(Map map) 和紧接着的 Writable.writeTo(Writer writer) 方法这两加起来就相当于 Velocity 的 Template.merge(VelocityContext context, Writer writer) 方法。

最后,看看上面程序执行的结果

执行后在控制台输出如下信息:

<html>
<head><title>显示用户信息</title></head>
 <body>
  <table>
   <tr><td>姓名</td><td>性别</td></tr>
   <tr><td>Unmi</td><td>male</td></tr>
<tr><td>hy</td><td>female</td></tr>

  </table>
 &copy;Made by Unmi
 </body>
</html>

对了,我这里有意在模板中用的是 HTML 格式,也就很明显,我们能很好的把 Groovy 模板技术运用到 Groovlet 中,如此可以大大简化 Groovlet 的开发。参看 Unmi 学习 Groovy 之 Groovlet。真要说呢,用 Groovy 模板来简化 Groovlet 开发还不够,后面还有 GroovyMarkup-MarkupBuilder 可以用。真正的终极目标应该在 Grails 的应用,本人对 Grails 基本还没什么了解。

参考:1. 《Scripting in Java Language, Frameworks, and Patterns》 Chaper 5

你可能感兴趣的:(freemarker,velocity,grails,groovy,模板引擎,scripting)