原文連結 作者：groovy團隊  譯者：樹下偷懶的蟻

1.簡介
Groovy支援多種方式動態的生成文字譬如：GStrings, printf(基於Java5),MarkupBuilder 。除此之外，模板框架則是非常適用基於靜態模板生成文字的應用程式。

2.模板框架

在Groovy中，模板框架包含TemplateEngine抽象基類（引擎必須實現），Template介面（引擎生成的模板必須實現）。

Groovy包含的以下幾種模板引擎：

• SimpleTemplateEngine -基礎模板引擎
• GStringTemplateEngine -將模板作為可寫的閉包 (適用於流操作)
• XmlTemplateEngine
  -適用於輸出XML格式的模板引擎
• MarkupTemplateEngine – 非常完整優化的模板引擎

3. SimpleTemplateEngine

SimpleTemplateEngine允許在模板中使用類似JSP風格的程式碼（如下例），指令碼和EL表示式。樣例

import groovy.text.SimpleTemplateEngine

def text = 'Dear "$firstname $lastname",\nSo nice to meet you in <% print city %>.\nSee you in ${month},\n${signed}'

def binding = ["firstname":"Sam", "lastname":"Pullara", "city":"San Francisco", "month":"December", "signed":"Groovy-Dev"]

def engine = new SimpleTemplateEngine()
template = engine.createTemplate(text).make(binding)

def result = 'Dear "Sam Pullara",\nSo nice to meet you in San Francisco.\nSee you in December,\nGroovy-Dev'

assert result == template.toString()

然而，通常在模板中混入業務邏輯不是良好的習慣。但是有時一些簡單的邏輯是有用的。上述的例子中，我們可以修改一下：

$firstname

可以改為(假設模板已經import了capitalize)

${firstname.capitalize()}

或者這樣

<% print city %>

改為：

<% print city == "New York" ? "The Big Apple" : city %>

3.1.高階應用說明

如果直接將模板嵌入到指令碼中（如我們上面做的那樣），必須小心反斜槓轉義。模板中的字串在傳入到模板框架之前需要Groovy解析，而GString表示式以及指令碼程式碼作為Groovy程式的一部分，必須要轉義反斜槓。例如，想用引號把 The Big Apple

<% print city == "New York" ? "\\"The Big Apple\\"" : city %>

相似的，如果想新起一行，我們可以這樣用：

\\n

“\n” 可以在靜態模板文字中使用，也可以在外部模板檔案中使用。同樣，如果要顯示反斜線本身，要用：

\\\\

在外部檔案中：

\\\\

4.GStringTemplateEngine

使用GStringTemplateEngine的方法，和上述的例子有點類似（顯示更多的引數）。首先，我們將模板存在檔案中：

test.template

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的流特性。因為我們將檔案儲存在單獨的檔案中，所以不需要轉義反斜線。呼叫過程如下：

def f = new File('test.template')
engine = new GStringTemplateEngine()
template = engine.createTemplate(f).make(binding)
println template.toString()

輸入結果如下：

Dear "Sam Pullara",
So nice to meet you in "The Big Apple".
See you in December,
Groovy-Dev

5. XmlTemplateEngine

XmlTemplateEngine適用於輸入模板輸出結果都是XML樣式的場景。可以在模板的任意表達式中使用${expression} 和 $variable符號。同時也支援特殊的標籤：<gsp:scriptlet> (使用者插入程式碼片段) and <gsp:expression> (用於輸入結果的程式碼片段).

註解和處理指令在處理的過程中會被移除，同時特殊的XML符號比如：<,>, " 和 '會被相應的XML符號轉義。輸出結果將按照標準的XML輸出格式進行縮排。gsp:tags 定義的Xmlns名稱空間會被移除但是其他的名稱空間將會被保留（可能轉換成XML樹中等效的結果）。

正常情況下，模板原檔案會儲存在單獨的檔案中，但是下面的例子提供一個String型別的XML模板。

def binding = [firstname: 'Jochen', lastname: 'Theodorou', nickname: 'blackdrag', salutation: 'Dear']
def engine = new groovy.text.XmlTemplateEngine()
def text = '''\
 <document xmlns:gsp='http://groovy.codehaus.org/2005/gsp' xmlns:foo='baz' type='letter'>
 <gsp:scriptlet>def greeting = "${salutation}est"</gsp:scriptlet>
 <gsp:expression>greeting</gsp:expression>
 <foo:to>$firstname "$nickname" $lastname</foo:to>
 How are you today?
 </document>
'''
def template = engine.createTemplate(text).make(binding)
println template.toString()

輸出結果如下：

<document type=’letter’> Dearest <foo:to xmlns:foo=’baz’> Jochen &quot;blackdrag&quot; Theodorou </foo:to> How are you today? </document>

6. The MarkupTemplateEngine

此模板引擎主要適用於生成XML風格類似的標記(XML, XHTML, HTML5, …),但是也可以用於生成任意文字。和傳統的模板引擎不同的是，此模板引擎基於DSL。如下模板樣例：

xmlDeclaration()
cars {
   cars.each {
       car(make: it.make, model: it.model)
   }
}

如果用下面的資料模型填充：

model = [cars: [new Car(make: 'Peugeot', model: '508'), new Car(make: 'Toyota', model: 'Prius')]]

渲染的結果：

<?xml version='1.0'?> <cars><car make='Peugeot' model='508'/><car make='Toyota' model='Prius'/></cars>

此模板引擎的主要特點：

• 標記構建器風格的語法
• 模板編譯成位元組程式碼
• 渲染迅速
• 可選擇的模板資料型別校驗
• 包含
• 國際化支援
• 碎片化/佈局