groovy.text.markup

Class BaseTemplate

java.lang.Object

groovy.text.markup.BaseTemplate

All Implemented Interfaces:

Writable

public abstract class BaseTemplate
extends Object
implements Writable

All templates compiled through MarkupTemplateEngine extend this abstract class, which provides a number of utility methods to generate markup. An instance of this class can be obtained after calling Template.make() or Template.make(java.util.Map))} on a template generated by MarkupTemplateEngine.createTemplate(java.io.Reader).

It is advised to use a distinct template instance for each thread (or more simply, each rendered document) for thread safety and avoiding mixing models.

For the application needs, it is possible to provide more helper methods by extending this class and configuring the base template class using the TemplateConfiguration.setBaseTemplateClass(Class) method.

Author:

Cedric Champeau

Constructor Summary

Constructors

Constructor and Description
BaseTemplate(MarkupTemplateEngine templateEngine, Map model, Map<String,String> modelTypes, TemplateConfiguration configuration)

Method Summary

Methods

Modifier and Type	Method and Description
BaseTemplate	comment(Object cs) Renders the supplied object using its Object.toString() method inside a comment markup block (<!-- ...
Map	getModel()
Writer	getOut() Convenience method to return the current writer instance.
void	includeEscaped(String templatePath) Includes contents of another file, not as a template but as escaped text.
void	includeGroovy(String templatePath) Includes another template inside this template.
void	includeUnescaped(String templatePath) Includes contents of another file, not as a template but as unescaped text.
Object	methodMissing(String tagName, Object args) This is the main method responsible for writing a tag and its attributes.
void	newLine() Adds a new line to the output.
BaseTemplate	pi(Map<?,?> attrs) Renders processing instructions.
abstract Object	run()
Object	tryEscape(Object contents) Escapes the string representation of the supplied object if it derives from CharSequence, otherwise returns the object itself.
Writer	writeTo(Writer out) Main method used to render a template.
BaseTemplate	xmlDeclaration() Renders an XML declaration header.
BaseTemplate	yield(Object obj) Renders the object provided as parameter using its Object.toString() method, The contents is rendered after being escaped for XML, enforcing valid XML output.
BaseTemplate	yieldUnescaped(Object obj) Renders the object provided as parameter using its Object.toString() method, The contents is rendered as is, unescaped.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BaseTemplate

public BaseTemplate(MarkupTemplateEngine templateEngine,
            Map model,
            Map<String,String> modelTypes,
            TemplateConfiguration configuration)

Method Detail

getModel

public Map getModel()

run

public abstract Object run()

yieldUnescaped

public BaseTemplate yieldUnescaped(Object obj)
                            throws IOException

Renders the object provided as parameter using its Object.toString() method, The contents is rendered as is, unescaped. This means that depending on what the Object.toString() method call returns, you might create invalid markup.

Parameters:

obj - the object to be rendered unescaped

Returns:

this template instance

Throws:

IOException

yield

public BaseTemplate yield(Object obj)
                   throws IOException

Renders the object provided as parameter using its Object.toString() method, The contents is rendered after being escaped for XML, enforcing valid XML output.

Parameters:

obj - the object to be rendered

Returns:

this template instance

Throws:

IOException

comment

public BaseTemplate comment(Object cs)
                     throws IOException

Renders the supplied object using its Object.toString() method inside a comment markup block (<!-- ... -->). The object is rendered as is, unescaped.

Parameters:

cs - the object to be rendered inside an XML comment block.

Returns:

this template instance.

Throws:

IOException

xmlDeclaration

public BaseTemplate xmlDeclaration()
                            throws IOException

Renders an XML declaration header. If the declaration encoding is set in the template configuration, then the encoding is rendered into the declaration.

Returns:

this template instance

Throws:

IOException

pi

public BaseTemplate pi(Map<?,?> attrs)
                throws IOException

Renders processing instructions. The supplied map contains all elements to be rendered as processing instructions. The key is the name of the element, the value is either a map of attributes, or an object to be rendered directly. For example:

pi("xml-stylesheet":[href:"mystyle.css", type:"text/css"])

will be rendered as:

     <?xml-stylesheet href='mystyle.css' type='text/css'?>
 

Parameters:

attrs -

Returns:

Throws:

IOException

methodMissing

public Object methodMissing(String tagName,
                   Object args)
                     throws IOException

This is the main method responsible for writing a tag and its attributes. The arguments may be:

• a closure
in which case the closure is rendered inside the tag body
• a string
, in which case the string is rendered as the tag body
• a map of attributes
in which case the attributes are rendered inside the opening tag

or a combination of (attributes,string), (attributes,closure)

Parameters:

tagName - the name of the tag

args - tag generation arguments.

Returns:

Throws:

IOException

includeGroovy

public void includeGroovy(String templatePath)
                   throws IOException,
                          ClassNotFoundException

Includes another template inside this template.

Parameters:

templatePath - the path to the included resource.

Throws:

IOException

ClassNotFoundException

includeEscaped

public void includeEscaped(String templatePath)
                    throws IOException

Includes contents of another file, not as a template but as escaped text.

Parameters:

templatePath -

Throws:

IOException

includeUnescaped

public void includeUnescaped(String templatePath)
                      throws IOException

Includes contents of another file, not as a template but as unescaped text.

Parameters:

templatePath -

Throws:

IOException

tryEscape

public Object tryEscape(Object contents)

Escapes the string representation of the supplied object if it derives from CharSequence, otherwise returns the object itself.

Parameters:

contents - an object to be escaped for XML

Returns:

an escaped string, or the object itself

getOut

public Writer getOut()

Convenience method to return the current writer instance.

Returns:

newLine

public void newLine()
             throws IOException

Adds a new line to the output. The new line string can be configured by TemplateConfiguration.setNewLineString(String)

Throws:

IOException

writeTo

public Writer writeTo(Writer out)
               throws IOException

Main method used to render a template.

Specified by:

writeTo in interface Writable

Parameters:

out - the Writer to which this Writable should output its data.

Returns:

a writer instance

Throws:

IOException