bboss.org.apache.velocity.app

类 VelocityEngine

java.lang.Object

bboss.org.apache.velocity.app.VelocityEngine

所有已实现的接口:

RuntimeConstants

public class VelocityEngine
extends java.lang.Object
implements RuntimeConstants

This class provides a separate new-able instance of the Velocity template engine. The alternative model for use is using the Velocity class which employs the singleton model.

Velocity will call the parameter-less init() at the first use of this class if the init() wasn't explicitly called. While this will ensure that Velocity functions, it probably won't function in the way you intend, so it is strongly recommended that you call an init() method yourself if you use the default constructor.

字段概要

从接口继承的字段 bboss.org.apache.velocity.runtime.RuntimeConstants

COUNTER_INITIAL_VALUE, COUNTER_NAME, DEBUG_PREFIX, DEFAULT_RUNTIME_DIRECTIVES, DEFAULT_RUNTIME_PROPERTIES, DEFINE_DIRECTIVE_MAXDEPTH, DIRECTIVE_IF_TOSTRING_NULLCHECK, ENCODING_DEFAULT, ERROR_PREFIX, ERRORMSG_END, ERRORMSG_START, EVALUATE_CONTEXT_CLASS, EVENTHANDLER_INCLUDE, EVENTHANDLER_INVALIDREFERENCES, EVENTHANDLER_METHODEXCEPTION, EVENTHANDLER_NULLSET, EVENTHANDLER_REFERENCEINSERTION, FILE_RESOURCE_LOADER_CACHE, FILE_RESOURCE_LOADER_PATH, HAS_NEXT_NAME, INFO_PREFIX, INPUT_ENCODING, INTERPOLATE_STRINGLITERALS, INTROSPECTOR_RESTRICT_CLASSES, INTROSPECTOR_RESTRICT_PACKAGES, MAX_NUMBER_LOOPS, NUMBER_OF_PARSERS, OUTPUT_ENCODING, PARSE_DIRECTIVE_MAXDEPTH, PARSER_POOL_CLASS, PARSER_POOL_SIZE, PROVIDE_SCOPE_CONTROL, RESOURCE_LOADER, RESOURCE_MANAGER_CACHE_CLASS, RESOURCE_MANAGER_CLASS, RESOURCE_MANAGER_DEFAULTCACHE_SIZE, RESOURCE_MANAGER_LOGWHENFOUND, RUNTIME_LOG, RUNTIME_LOG_ERROR_STACKTRACE, RUNTIME_LOG_INFO_STACKTRACE, RUNTIME_LOG_LOGSYSTEM, RUNTIME_LOG_LOGSYSTEM_CLASS, RUNTIME_LOG_REFERENCE_LOG_INVALID, RUNTIME_LOG_WARN_STACKTRACE, RUNTIME_REFERENCES_STRICT, RUNTIME_REFERENCES_STRICT_ESCAPE, SET_NULL_ALLOWED, SKIP_INVALID_ITERATOR, STRICT_MATH, TRACE_PREFIX, UBERSPECT_CLASSNAME, UNKNOWN_PREFIX, VM_ARGUMENTS_STRICT, VM_BODY_REFERENCE, VM_CONTEXT_LOCALSCOPE, VM_LIBRARY, VM_LIBRARY_AUTORELOAD, VM_LIBRARY_DEFAULT, VM_MAX_DEPTH, VM_MESSAGES_ON, VM_PERM_ALLOW_INLINE, VM_PERM_ALLOW_INLINE_REPLACE_GLOBAL, VM_PERM_INLINE_LOCAL, WARN_PREFIX

构造器概要

构造器

构造器和说明
VelocityEngine() Init-less CTOR
VelocityEngine(java.util.Properties p) Construct a VelocityEngine instance with the specified initial properties.
VelocityEngine(java.lang.String propsFilename) Construct a VelocityEngine with the initial properties defined in the file propsFilename

方法概要

限定符和类型	方法和说明
void	addProperty(java.lang.String key, java.lang.Object value) Add a Velocity Runtime property.
void	clearProperty(java.lang.String key) Clear a Velocity Runtime property.
void	debug(java.lang.Object message) 已过时。 Use getLog() and call warn() on it.
void	error(java.lang.Object message) 已过时。 Use getLog() and call warn() on it.
boolean	evaluate(Context context, java.io.Writer writer, java.lang.String logTag, java.io.InputStream instream) 已过时。 Use evaluate( Context context, Writer writer, String logTag, Reader reader )
boolean	evaluate(Context context, java.io.Writer writer, java.lang.String logTag, java.io.Reader reader) Renders the input reader using the context into the output writer.
boolean	evaluate(Context context, java.io.Writer out, java.lang.String logTag, java.lang.String instring) renders the input string using the context into the output writer.
java.lang.Object	getApplicationAttribute(java.lang.Object key) Return an application attribute (which can be any Object) that was set by the application in order to be accessible from any component of the system that gets a RuntimeServices.
Log	getLog() Returns a convenient Log instance that wraps the current LogChute.
java.lang.Object	getProperty(java.lang.String key) Get a Velocity Runtime property.
Template	getTemplate(java.lang.String name) Returns a Template from the Velocity resource management system.
Template	getTemplate(java.lang.String name, java.lang.String encoding) Returns a Template from the Velocity resource management system.
void	info(java.lang.Object message) 已过时。 Use getLog() and call warn() on it.
void	init() initialize the Velocity runtime engine, using the default properties of the Velocity distribution
void	init(java.util.Properties p) initialize the Velocity runtime engine, using default properties plus the properties in the passed in java.util.Properties object
void	init(java.lang.String propsFilename) initialize the Velocity runtime engine, using default properties plus the properties in the properties file passed in as the arg
void	initTemplate(Resource template)
void	initTemplate(Resource template, java.lang.String encoding)
boolean	invokeVelocimacro(java.lang.String vmName, java.lang.String logTag, java.lang.String[] params, Context context, java.io.Writer writer) Invokes a currently registered Velocimacro with the params provided and places the rendered stream into the writer.
void	loadDirective(java.lang.String directiveClass) Instantiates and loads the directive with some basic checks.
boolean	mergeTemplate(java.lang.String templateName, Context context, java.io.Writer writer) 已过时。 Use mergeTemplate( String templateName, String encoding, Context context, Writer writer )
boolean	mergeTemplate(java.lang.String templateName, java.lang.String encoding, Context context, java.io.Writer writer) merges a template and puts the rendered stream into the writer
void	removeDirective(java.lang.String name) Remove a directive.
boolean	resourceExists(java.lang.String resourceName) Determines if a resource is accessable via the currently configured resource loaders.
void	setApplicationAttribute(java.lang.Object key, java.lang.Object value) Sets an application attribute (which can be any Object) that will be accessible from any component of the system that gets a RuntimeServices.
void	setExtendedProperties(org.apache.commons.collections.ExtendedProperties configuration) Set an entire configuration at once.
void	setProperty(java.lang.String key, java.lang.Object value) Set a Velocity Runtime property.
boolean	templateExists(java.lang.String resourceName) 已过时。 Use resourceExists(String) instead.
void	warn(java.lang.Object message) 已过时。 Use getLog() and call warn() on it.

从类继承的方法 java.lang.Object

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

构造器详细资料

VelocityEngine

public VelocityEngine()

Init-less CTOR

VelocityEngine

public VelocityEngine(java.lang.String propsFilename)

Construct a VelocityEngine with the initial properties defined in the file propsFilename

VelocityEngine

public VelocityEngine(java.util.Properties p)

Construct a VelocityEngine instance with the specified initial properties.

方法详细资料

init

public void init()

initialize the Velocity runtime engine, using the default properties of the Velocity distribution

init

public void init(java.lang.String propsFilename)

initialize the Velocity runtime engine, using default properties plus the properties in the properties file passed in as the arg

参数:

propsFilename - file containing properties to use to initialize the Velocity runtime

init

public void init(java.util.Properties p)

initialize the Velocity runtime engine, using default properties plus the properties in the passed in java.util.Properties object

参数:

p - Proprties object containing initialization properties

setProperty

public void setProperty(java.lang.String key,
                        java.lang.Object value)

Set a Velocity Runtime property.

参数:

key -

value -

addProperty

public void addProperty(java.lang.String key,
                        java.lang.Object value)

Add a Velocity Runtime property.

参数:

key -

value -

clearProperty

public void clearProperty(java.lang.String key)

Clear a Velocity Runtime property.

参数:

key - of property to clear

setExtendedProperties

public void setExtendedProperties(org.apache.commons.collections.ExtendedProperties configuration)

Set an entire configuration at once. This is useful in cases where the parent application uses the ExtendedProperties class and the velocity configuration is a subset of the parent application's configuration.

参数:

configuration -

getProperty

public java.lang.Object getProperty(java.lang.String key)

Get a Velocity Runtime property.

参数:

key - property to retrieve

返回:

property value or null if the property not currently set

evaluate

public boolean evaluate(Context context,
                        java.io.Writer out,
                        java.lang.String logTag,
                        java.lang.String instring)
                 throws ParseErrorException,
                        MethodInvocationException,
                        ResourceNotFoundException

renders the input string using the context into the output writer. To be used when a template is dynamically constructed, or want to use Velocity as a token replacer.

参数:

context - context to use in rendering input string

out - Writer in which to render the output

logTag - string to be used as the template name for log messages in case of error

instring - input string containing the VTL to be rendered

返回:

true if successful, false otherwise. If false, see Velocity runtime log

抛出:

ParseErrorException - The template could not be parsed.

MethodInvocationException - A method on a context object could not be invoked.

ResourceNotFoundException - A referenced resource could not be loaded.

evaluate

public boolean evaluate(Context context,
                        java.io.Writer writer,
                        java.lang.String logTag,
                        java.io.InputStream instream)
                 throws ParseErrorException,
                        MethodInvocationException,
                        ResourceNotFoundException,
                        java.io.IOException

已过时。 Use evaluate( Context context, Writer writer, String logTag, Reader reader )

Renders the input stream using the context into the output writer. To be used when a template is dynamically constructed, or want to use Velocity as a token replacer.

参数:

context - context to use in rendering input string

writer - Writer in which to render the output

logTag - string to be used as the template name for log messages in case of error

instream - input stream containing the VTL to be rendered

返回:

true if successful, false otherwise. If false, see Velocity runtime log

抛出:

ParseErrorException

MethodInvocationException

ResourceNotFoundException

java.io.IOException

evaluate

public boolean evaluate(Context context,
                        java.io.Writer writer,
                        java.lang.String logTag,
                        java.io.Reader reader)
                 throws ParseErrorException,
                        MethodInvocationException,
                        ResourceNotFoundException

Renders the input reader using the context into the output writer. To be used when a template is dynamically constructed, or want to use Velocity as a token replacer.

参数:

context - context to use in rendering input string

writer - Writer in which to render the output

logTag - string to be used as the template name for log messages in case of error

reader - Reader containing the VTL to be rendered

返回:

true if successful, false otherwise. If false, see Velocity runtime log

抛出:

ParseErrorException - The template could not be parsed.

MethodInvocationException - A method on a context object could not be invoked.

ResourceNotFoundException - A referenced resource could not be loaded.

从以下版本开始:

Velocity v1.1

invokeVelocimacro

public boolean invokeVelocimacro(java.lang.String vmName,
                                 java.lang.String logTag,
                                 java.lang.String[] params,
                                 Context context,
                                 java.io.Writer writer)

Invokes a currently registered Velocimacro with the params provided and places the rendered stream into the writer.
Note : currently only accepts args to the VM if they are in the context.

参数:

vmName - name of Velocimacro to call

logTag - string to be used for template name in case of error. if null, the vmName will be used

params - keys for args used to invoke Velocimacro, in java format rather than VTL (eg "foo" or "bar" rather than "$foo" or "$bar")

context - Context object containing data/objects used for rendering.

writer - Writer for output stream

返回:

true if Velocimacro exists and successfully invoked, false otherwise.

mergeTemplate

public boolean mergeTemplate(java.lang.String templateName,
                             Context context,
                             java.io.Writer writer)
                      throws ResourceNotFoundException,
                             ParseErrorException,
                             MethodInvocationException

已过时。 Use mergeTemplate( String templateName, String encoding, Context context, Writer writer )

Merges a template and puts the rendered stream into the writer. The default encoding that Velocity uses to read template files is defined in the property input.encoding and defaults to ISO-8859-1.

参数:

templateName - name of template to be used in merge

context - filled context to be used in merge

writer - writer to write template into

返回:

true if successful, false otherwise. Errors logged to velocity log.

抛出:

ResourceNotFoundException

ParseErrorException

MethodInvocationException

mergeTemplate

public boolean mergeTemplate(java.lang.String templateName,
                             java.lang.String encoding,
                             Context context,
                             java.io.Writer writer)
                      throws ResourceNotFoundException,
                             ParseErrorException,
                             MethodInvocationException

merges a template and puts the rendered stream into the writer

参数:

templateName - name of template to be used in merge

encoding - encoding used in template

context - filled context to be used in merge

writer - writer to write template into

返回:

true if successful, false otherwise. Errors logged to velocity log

抛出:

ResourceNotFoundException

ParseErrorException

MethodInvocationException

从以下版本开始:

Velocity v1.1

getTemplate

public Template getTemplate(java.lang.String name)
                     throws ResourceNotFoundException,
                            ParseErrorException

Returns a Template from the Velocity resource management system.

参数:

name - The file name of the desired template.

返回:

The template.

抛出:

ResourceNotFoundException - if template not found from any available source.

ParseErrorException - if template cannot be parsed due to syntax (or other) error.

getTemplate

public Template getTemplate(java.lang.String name,
                            java.lang.String encoding)
                     throws ResourceNotFoundException,
                            ParseErrorException

Returns a Template from the Velocity resource management system.

参数:

name - The file name of the desired template.

encoding - The character encoding to use for the template.

返回:

The template.

抛出:

ResourceNotFoundException - if template not found from any available source.

ParseErrorException - if template cannot be parsed due to syntax (or other) error.

从以下版本开始:

Velocity v1.1

resourceExists

public boolean resourceExists(java.lang.String resourceName)

Determines if a resource is accessable via the currently configured resource loaders.

Note that the current implementation will not change the state of the system in any real way - so this cannot be used to pre-load the resource cache, as the previous implementation did as a side-effect.

The previous implementation exhibited extreme lazyness and sloth, and the author has been flogged.

参数:

resourceName - name of the resource to search for

返回:

true if found, false otherwise

从以下版本开始:

1.5

templateExists

public boolean templateExists(java.lang.String resourceName)

已过时。 Use resourceExists(String) instead.

参数:

resourceName -

返回:

True if the template exists.

另请参阅:

resourceExists(String)

getLog

public Log getLog()

Returns a convenient Log instance that wraps the current LogChute. Use this to log error messages. It has the usual methods you'd expect.

返回:

A log object.

从以下版本开始:

1.5

warn

public void warn(java.lang.Object message)

已过时。 Use getLog() and call warn() on it.

参数:

message -

info

public void info(java.lang.Object message)

已过时。 Use getLog() and call warn() on it.

参数:

message -

error

public void error(java.lang.Object message)

已过时。 Use getLog() and call warn() on it.

参数:

message -

debug

public void debug(java.lang.Object message)

已过时。 Use getLog() and call warn() on it.

参数:

message -

setApplicationAttribute

public void setApplicationAttribute(java.lang.Object key,
                                    java.lang.Object value)

Sets an application attribute (which can be any Object) that will be accessible from any component of the system that gets a RuntimeServices. This allows communication between the application environment and custom pluggable components of the Velocity engine, such as ResourceLoaders and LogChutes.

Note that there is no enforcement or rules for the key used - it is up to the application developer. However, to help make the intermixing of components possible, using the target Class name (e.g. com.foo.bar ) as the key might help avoid collision.

参数:

key - object 'name' under which the object is stored

value - object to store under this key

getApplicationAttribute

public java.lang.Object getApplicationAttribute(java.lang.Object key)

Return an application attribute (which can be any Object) that was set by the application in order to be accessible from any component of the system that gets a RuntimeServices. This allows communication between the application environment and custom pluggable components of the Velocity engine, such as ResourceLoaders and LogChutes.

参数:

key - object 'name' under which the object is stored

返回:

value object to store under this key

从以下版本开始:

1.5

removeDirective

public void removeDirective(java.lang.String name)

Remove a directive.

参数:

name - name of the directive.

loadDirective

public void loadDirective(java.lang.String directiveClass)

Instantiates and loads the directive with some basic checks.

参数:

directiveClass - classname of directive to load

initTemplate

public void initTemplate(Resource template)

initTemplate

public void initTemplate(Resource template,
                         java.lang.String encoding)