groovy.text
[Java] Class GStringTemplateEngine

java.lang.Object
  groovy.text.TemplateEngine
      groovy.text.GStringTemplateEngine

public class GStringTemplateEngine
extends TemplateEngine

Processes template source files substituting variables and expressions into placeholders in a template source text to produce the desired output using a streaming approach. This engine has equivalent functionality to the SimpleTemplateEngine but creates the template using writable closures making it potentially more scalable for large templates or in streaming scenarios.

The template engine uses JSP style <% %> script and <%= %> expression syntax or GString style expressions. The variable 'out' is bound to the writer that the template is being written to.

Frequently, the template source will be in a file but here is a simple example providing the template as a string:

 def binding = [
     firstname : "Grace",
     lastname  : "Hopper",
     accepted  : true,
     title     : 'Groovy for COBOL programmers'
 ]
 def engine = new groovy.text.GStringTemplateEngine()
 def text = '''\
 Dear <%= firstname %> $lastname,

 We <% if (accepted) print 'are pleased' else print 'regret' %> \
 to inform you that your paper entitled
 '$title' was ${ accepted ? 'accepted' : 'rejected' }.

 The conference committee.
 '''
 def template = engine.createTemplate(text).make(binding)
 println template.toString()
 

 Dear Grace Hopper,

 We are pleased to inform you that your paper entitled
 'Groovy for COBOL programmers' was accepted.

 The conference committee.
 

 <servlet>
   <servlet-name>GStringTemplate</servlet-name>
   <servlet-class>groovy.servlet.TemplateServlet</servlet-class>
   <init-param>
     <param-name>template.engine</param-name>
     <param-value>groovy.text.GStringTemplateEngine</param-value>
   </init-param>
 </servlet>
 

Authors:

tug@wilson.co.uk

Paul King

GStringTemplateEngine

public GStringTemplateEngine()

GStringTemplateEngine

public GStringTemplateEngine(ClassLoader parentLoader)

createTemplate

public Template createTemplate(Reader reader)

Copyright &copy; 2003-2013 The Codehaus. All rights reserved.