Velocity基本标记说明.doc

Velocity是一个强大的模板引擎，常用于Java应用中的视图层，帮助开发者将静态模板与动态数据结合起来生成输出。在Velocity中，有一些基本的标记和语法，这些标记有助于构建模板并控制其行为。以下是对这些标记的详细说明： 1. **$velocityCount**：这是Velocity的一个内置变量，用于表示默认的循环索引，从1开始。如果你希望索引从0开始，你需要在`Velocity.properties`文件中进行设置。这个配置文件位于`velocity-1.4.jar`包内的`org/apache/velocity/runtime/defaults`目录下。 2. **#**：这个符号用于标识Velocity的脚本语句，包括条件判断（`#if`、`#else`、`#end`）、循环（`#foreach`）、包含（`#include`、`#parse`）、宏定义（`#macro`）等。例如，`#if($info.imgs)`会检查$info.imgs是否存在，然后根据结果显示图片。 3. **$**：用于标识对象或变量。例如，`$i`、`$msg`等。如果页面中有一个`$someonename`，Velocity会将其解析为变量`someonename`，若你想在`someone`变量后面紧跟`name`字符串，应写成`${someone}name`。 4. **{}**：用于明确地表示Velocity变量。当变量名可能与文本冲突时，使用花括号来区分。例如，`${someone}name`。 5. **!**：用于处理未定义的变量。`$!msg`会在`msg`变量不存在或者值为`null`时显示为空字符串，而`$msg`会直接显示变量名本身。 6. **#parse()** 和 **#include()**：`#include()`用于包含静态内容，不会解析其中的Velocity指令。而`#parse()`不仅包含内容，还会对内容中的Velocity脚本进行解析。 7. **#set()**：用于声明和赋值变量，例如`#set ($var=XXX)`将变量`var`设置为`XXX`的值。 8. **注释**：Velocity支持单行注释`##`和多行注释`#* ... *#`。 9. **变量 Variables**：以`$`开头，且第一个字符必须是字母。例如`$var`。 10. **Formal Reference Notation**：使用花括号将变量名与字符串分隔，如`#set ($user="csy")`，然后`${user}name`将返回`csyname`。`$username`直接输出`username`的值，而`$!username`在`username`未定义时返回空字符串。 11. **双引号与单引号**：`#set ($var="helo")`中，双引号内的内容会被解释为字符串。`test"$var"`将返回`testhello`，而`test'$var'`则保持引号内的内容不变。通过设置`stringliterals.interpolate=false`可以改变这种默认行为。 12. **逻辑运算符**：`=、&&、||、!`分别代表等于、逻辑与、逻辑或和逻辑非。这些运算符用于构建复杂的逻辑判断。 掌握这些基本标记和语法是使用Velocity进行模板开发的基础，它们允许你灵活地组合数据和结构，生成定制化的输出。在实际应用中，你还可以利用Velocity的其他高级特性，如宏、方法调用、自定义指令等，来提高模板的复用性和可维护性。