org.apache.velocity.script

Class VelocityScriptEngineFactory

java.lang.Object

org.apache.velocity.script.VelocityScriptEngineFactory

All Implemented Interfaces:

javax.script.ScriptEngineFactory

public class VelocityScriptEngineFactory
extends Object
implements javax.script.ScriptEngineFactory

Constructor Summary

Constructors

Constructor and Description
VelocityScriptEngineFactory()

Method Summary

Methods

Modifier and Type	Method and Description
String	getEngineName() get engine name
String	getEngineVersion() get engine version
List<String>	getExtensions() get the list of file extensions handled by Velocity: vm, vtl, vhtml
String	getLanguageName() get language name
String	getLanguageVersion() get language version (same as engine version)
String	getMethodCallSyntax(String obj, String m, String... args) get Velocity syntax for calling method 'm' on bject 'obj' with provided arguments
List<String>	getMimeTypes() get the list of Velocity mime types
List<String>	getNames() get the list of names
String	getOutputStatement(String toDisplay) get VTL expression used to display specified string
String	getParameter(String key) get engine parameter for provided key
String	getProgram(String... statements) get whole VTL program given VTL lines
javax.script.ScriptEngine	getScriptEngine() get a Velocity script engine

Methods inherited from class java.lang.Object

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

Constructor Detail

VelocityScriptEngineFactory

public VelocityScriptEngineFactory()

Method Detail

getEngineName

public String getEngineName()

get engine name

Specified by:

getEngineName in interface javax.script.ScriptEngineFactory

Returns:

engine name, aka "Velocity"

getEngineVersion

public String getEngineVersion()

get engine version

Specified by:

getEngineVersion in interface javax.script.ScriptEngineFactory

Returns:

engine version string

getExtensions

public List<String> getExtensions()

get the list of file extensions handled by Velocity: vm, vtl, vhtml

Specified by:

getExtensions in interface javax.script.ScriptEngineFactory

Returns:

extentions list

getLanguageName

public String getLanguageName()

get language name

Specified by:

getLanguageName in interface javax.script.ScriptEngineFactory

Returns:

language name, aka "VTL"

getLanguageVersion

public String getLanguageVersion()

get language version (same as engine version)

Specified by:

getLanguageVersion in interface javax.script.ScriptEngineFactory

Returns:

language version string

getMethodCallSyntax

public String getMethodCallSyntax(String obj,
                         String m,
                         String... args)

get Velocity syntax for calling method 'm' on bject 'obj' with provided arguments

Specified by:

getMethodCallSyntax in interface javax.script.ScriptEngineFactory

Parameters:

obj -

m -

args -

Returns:

VTL call ${obj.m(args...)}

getMimeTypes

public List<String> getMimeTypes()

get the list of Velocity mime types

Specified by:

getMimeTypes in interface javax.script.ScriptEngineFactory

Returns:

singleton { 'text/x-velocity' }

getNames

public List<String> getNames()

get the list of names

Specified by:

getNames in interface javax.script.ScriptEngineFactory

Returns:

{ 'velocity', 'Velocity' }

getOutputStatement

public String getOutputStatement(String toDisplay)

get VTL expression used to display specified string

Specified by:

getOutputStatement in interface javax.script.ScriptEngineFactory

Parameters:

toDisplay -

Returns:

escaped string #[[toDisplay]]#

getParameter

public String getParameter(String key)

get engine parameter for provided key

Specified by:

getParameter in interface javax.script.ScriptEngineFactory

Parameters:

key -

Returns:

found parameter, or null

getProgram

public String getProgram(String... statements)

get whole VTL program given VTL lines

Specified by:

getProgram in interface javax.script.ScriptEngineFactory

Parameters:

statements - VTL lines

Returns:

lines concatenated with carriage returns

getScriptEngine

public javax.script.ScriptEngine getScriptEngine()

get a Velocity script engine

Specified by:

getScriptEngine in interface javax.script.ScriptEngineFactory

Returns:

a new Velocity script engine