在路上

 找回密码
 立即注册
在路上 站点首页 学习 查看内容

Groovy模板引擎上(基础模板介绍)

2016-12-20 13:12| 发布者: zhangjf| 查看: 554| 评论: 0

摘要: 原文链接 作者:groovy团队 译者:树下偷懒的蚁 1.简介 Groovy支持多种方式动态的生成文本譬如:GStrings, printf(基于Java5),MarkupBuilder 。除此之外,模板框架则是非常适用基于静态模板生成文本的应用程序。 ...

原文链接 作者:groovy团队 译者:树下偷懒的蚁

1.简介
Groovy支持多种方式动态的生成文本譬如:GStrings, printf(基于Java5),MarkupBuilder 。除此之外,模板框架则是非常适用基于静态模板生成文本的应用程序。

2.模板框架

在Groovy中,模板框架包含TemplateEngine抽象基类(引擎必须实现),Template接口(引擎生成的模板必须实现)。

Groovy包含的以下几种模板引擎:

SimpleTemplateEngine-基础模板引擎 GStringTemplateEngine-将模板作为可写的闭包 (适用于流操作) XmlTemplateEngine-适用于输出XML格式的模板引擎 MarkupTemplateEngine– 非常完整优化的模板引擎

3. SimpleTemplateEngine

SimpleTemplateEngine允许在模板中使用类似JSP风格的代码(如下例),脚本和EL表达式。样例

  1. import groovy.text.SimpleTemplateEngine
  2. def text = 'Dear "$firstname $lastname",nSo nice to meet you in <% print city %>.nSee you in ${month},n${signed}'
  3. def binding = ["firstname":"Sam", "lastname":"Pullara", "city":"San Francisco", "month":"December", "signed":"Groovy-Dev"]
  4. def engine = new SimpleTemplateEngine()
  5. template = engine.createTemplate(text).make(binding)
  6. def result = 'Dear "Sam Pullara",nSo nice to meet you in San Francisco.nSee you in December,nGroovy-Dev'
  7. assert result == template.toString()
复制代码

然而,通常在模板中混入业务逻辑不是良好的习惯。但是有时一些简单的逻辑是有用的。上述的例子中,我们可以修改一下:

  1. $firstname
复制代码

可以改为(假设模板已经import了capitalize)

  1. ${firstname.capitalize()}
复制代码

或者这样

  1. <% print city %>
复制代码

改为:

  1. <% print city == "New York" ? "The Big Apple" : city %>
复制代码

3.1.高级应用说明

如果直接将模板嵌入到脚本中(如我们上面做的那样),必须小心反斜杠转义。模板中的字符串在传入到模板框架之前需要Groovy解析,而GString表达式以及脚本代码作为Groovy程序的一部分,必须要转义反斜杠。例如,想用引号把 The Big Apple引起来,可以这样做:

  1. <% print city == "New York" ? "\"The Big Apple\"" : city %>
复制代码

相似的,如果想新起一行,我们可以这样用:

  1. \n
复制代码

“n” 可以在静态模板文本中使用,也可以在外部模板文件中使用。同样,如果要显示反斜线本身,要用:

  1. \\
复制代码

在外部文件中:

  1. \\
复制代码

4.GStringTemplateEngine

使用GStringTemplateEngine的方法,和上述的例子有点类似(显示更多的参数)。首先,我们将模板存在文件中:

test.template

  1. Dear "$firstname $lastname", So nice to meet you in <% out << (city == "New York" ? "\"The Big Apple\"" : city) %>. See you in ${month}, ${signed}
复制代码

注意:我们使用out替代print支持GStringTemplateEngine的流特性。因为我们将文件存储在单独的文件中,所以不需要转义反斜线。调用过程如下:

  1. def f = new File('test.template')
  2. engine = new GStringTemplateEngine()
  3. template = engine.createTemplate(f).make(binding)
  4. println template.toString()
复制代码

输入结果如下:

  1. Dear "Sam Pullara",
  2. So nice to meet you in "The Big Apple".
  3. See you in December,
  4. Groovy-Dev
复制代码

5. XmlTemplateEngine

XmlTemplateEngine适用于输入模板输出结果都是XML样式的场景。可以在模板的任意表达式中使用${expression} 和 $variable符号。同时也支持特殊的标签:(用户插入代码片段) and(用于输入结果的代码片段).

注解和处理指令在处理的过程中会被移除,同时特殊的XML符号比如:<,>,"和'会被相应的XML符号转义。输出结果将按照标准的XML输出格式进行缩进。gsp:tags 定义的Xmlns命名空间会被移除但是其他的命名空间将会被保留(可能转换成XML树中等效的结果)。

正常情况下,模板原文件会保存在单独的文件中,但是下面的例子提供一个String类型的XML模板。

  1. def binding = [firstname: 'Jochen', lastname: 'Theodorou', nickname: 'blackdrag', salutation: 'Dear']
  2. def engine = new groovy.text.XmlTemplateEngine()
  3. def text = '''
  4. &lt;document xmlns:gsp='http://groovy.codehaus.org/2005/gsp' xmlns:foo='baz' type='letter'&gt;
  5. &lt;gsp:scriptlet&gt;def greeting = &quot;${salutation}est&quot;&lt;/gsp:scriptlet&gt;
  6. &lt;gsp:expression&gt;greeting&lt;/gsp:expression&gt;
  7. &lt;foo:to&gt;$firstname &quot;$nickname&quot; $lastname&lt;/foo:to&gt;
  8. How are you today?
  9. &lt;/document&gt;
  10. '''
  11. def template = engine.createTemplate(text).make(binding)
  12. println template.toString()
复制代码

输出结果如下:

Dearest Jochen "blackdrag" Theodorou How are you today?

6. The MarkupTemplateEngine

此模板引擎主要适用于生成XML风格类似的标记(XML, XHTML, HTML5, …),但是也可以用于生成任意文本。和传统的模板引擎不同的是,此模板引擎基于DSL。如下模板样例:

  1. xmlDeclaration()
  2. cars {
  3. cars.each {
  4. car(make: it.make, model: it.model)
  5. }
  6. }
复制代码

如果用下面的数据模型填充:

  1. model = [cars: [new Car(make: 'Peugeot', model: '508'), new Car(make: 'Toyota', model: 'Prius')]]
复制代码

渲染的结果:

  1. <?xml version='1.0'?> <cars><car make='Peugeot' model='508'/><car make='Toyota' model='Prius'/></cars>
复制代码

此模板引擎的主要特点:

标记构建器风格的语法 模板编译成字节代码 渲染迅速 可选择的模板数据类型校验 包含 国际化支持 碎片化/布局

原创文章,转载请注明: 转载自并发编程网 – ifeve.com

本文链接地址: Groovy模板引擎上(基础模板介绍)

最新评论

小黑屋|在路上 ( 蜀ICP备15035742号-1 

;

GMT+8, 2025-7-7 20:53

Copyright 2015-2025 djqfx

返回顶部