Velocity模板中的注释

Velocity ——VTL模板中的注释

注释允许在模板中包含描述文字，而这些文字不会被放置到模板引擎的输出中。注释是一种有效的提醒自己和向别人解释你的VTL语句要做什么事情的方法。你也可以把注释用来做其他你认为有用的用途。下面就是一个注释的例子。
## This is a single line comment.
一个单行的注释以##开始，直到行尾才结束。如果你要写很多行的注释，那么不用使用多各单行注释，VTL还提供了多行注释。多行注释以#*开始，以*#结束。下面是一个多行注释的例子。
This is text that is outside the multi-line comment.
Online visitors can see it.
#*
 Thus begins a multi-line comment. Online visitors won't
 see this text because the Velocity Templating Engine will
 ignore it.
*#
Here is text outside the multi-line comment; it is visible.
 
在使用Velocity引擎解析上面的模板时，输出的结果是：
 
This is text that is outside the multi-line comment.
Online visitors can see it.
 
Here is text outside the multi-line comment; it is visible.
 
可以看到，多行注释内的内容是不会输出的。
下面的例子阐明了注释的用法：
This text is visible. ## This text is not.
This text is visible.
This text is visible. #* This text, as part of a multi-line comment,
is not visible. This text is not visible; it is also part of the
multi-line comment. This text still not visible. *# This text is outside
the comment, so it is visible.
## This text is not visible.
用Velocity引擎解析上面的模板，输出的结果是：
 
This text is visible. This text is visible.
This text is visible. This text is outside
the comment, so it is visible.
 
在VTL中还有第三种注释：VTL注释块。VTL注释块用来保存如文档的作者、版本号等信息。例如：
#**
This is a VTL comment block and
may be used to store such information
as the document author and versioning
information:
@author
@version 5
*#

 

本文转载，已经找不到原出处！特此说明！