org.springframework.ui.velocity
Class VelocityEngineUtils

java.lang.Object
  org.springframework.ui.velocity.VelocityEngineUtils

public abstract class VelocityEngineUtils
extends Object

Utility class for working with a VelocityEngine. Provides convenience methods to merge a Velocity template with a model.

Since:

22.01.2004

Author:

Juergen Hoeller

Constructor Summary

VelocityEngineUtils()

Method Summary

static void	mergeTemplate(VelocityEngine velocityEngine, String templateLocation, Map model, Writer writer) Merge the specified Velocity template with the given model and write the result to the given Writer.
static void	mergeTemplate(VelocityEngine velocityEngine, String templateLocation, String encoding, Map model, Writer writer) Merge the specified Velocity template with the given model and write the result to the given Writer.
static String	mergeTemplateIntoString(VelocityEngine velocityEngine, String templateLocation, Map model) Merge the specified Velocity template with the given model into a String.
static String	mergeTemplateIntoString(VelocityEngine velocityEngine, String templateLocation, String encoding, Map model) Merge the specified Velocity template with the given model into a String.

Methods inherited from class java.lang.Object

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

Constructor Detail

VelocityEngineUtils

public VelocityEngineUtils()

Method Detail

mergeTemplate

public static void mergeTemplate(VelocityEngine velocityEngine,
                                 String templateLocation,
                                 Map model,
                                 Writer writer)
                          throws VelocityException

Merge the specified Velocity template with the given model and write the result to the given Writer.

Parameters:

velocityEngine - VelocityEngine to work with

templateLocation - the location of template, relative to Velocity's resource loader path

model - the Map that contains model names as keys and model objects as values

writer - the Writer to write the result to

Throws:

VelocityException - if the template wasn't found or rendering failed

mergeTemplate

public static void mergeTemplate(VelocityEngine velocityEngine,
                                 String templateLocation,
                                 String encoding,
                                 Map model,
                                 Writer writer)
                          throws VelocityException

Merge the specified Velocity template with the given model and write the result to the given Writer.

Parameters:

velocityEngine - VelocityEngine to work with

templateLocation - the location of template, relative to Velocity's resource loader path

encoding - the encoding of the template file

model - the Map that contains model names as keys and model objects as values

writer - the Writer to write the result to

Throws:

VelocityException - if the template wasn't found or rendering failed

mergeTemplateIntoString

public static String mergeTemplateIntoString(VelocityEngine velocityEngine,
                                             String templateLocation,
                                             Map model)
                                      throws VelocityException

Merge the specified Velocity template with the given model into a String.

When using this method to prepare a text for a mail to be sent with Spring's mail support, consider wrapping VelocityException in MailPreparationException.

Parameters:

velocityEngine - VelocityEngine to work with

templateLocation - the location of template, relative to Velocity's resource loader path

model - the Map that contains model names as keys and model objects as values

Returns:

the result as String

Throws:

VelocityException - if the template wasn't found or rendering failed

See Also:

MailPreparationException

mergeTemplateIntoString

public static String mergeTemplateIntoString(VelocityEngine velocityEngine,
                                             String templateLocation,
                                             String encoding,
                                             Map model)
                                      throws VelocityException

Merge the specified Velocity template with the given model into a String.

When using this method to prepare a text for a mail to be sent with Spring's mail support, consider wrapping VelocityException in MailPreparationException.

Parameters:

velocityEngine - VelocityEngine to work with

templateLocation - the location of template, relative to Velocity's resource loader path

encoding - the encoding of the template file

model - the Map that contains model names as keys and model objects as values

Returns:

the result as String

Throws:

VelocityException - if the template wasn't found or rendering failed

See Also:

MailPreparationException