Velocity 模板引擎使用指南 - 快速入门和示例代码 - 常规

Velocity 是一款基于 Java 的模板引擎，可以将数据和模板混合生成文本输出。Velocity 可以用来生成 HTML 页面、XML 文件或者任何其他文本输出。以下是 Velocity 的使用步骤：

引入 Velocity jar 包：在项目中引入 Velocity 的 jar 包，例如 velocity-1.7.jar。
编写模板文件：创建一个 Velocity 模板文件，文件后缀通常为 .vm。在模板文件中，可以使用 Velocity 提供的语法来访问数据、控制流程等。
创建 Velocity 引擎：在 Java 代码中创建 Velocity 引擎，可以使用 Velocity 提供的默认引擎或者自定义引擎。
设置模板路径和编码方式：设置模板文件的路径和编码方式，这样 Velocity 引擎才能找到模板文件并正确解析。
准备数据：在 Java 代码中准备数据，将数据存储在一个 Map 中，key 为数据的名称，value 为数据的值。
填充模板：使用 Velocity 引擎的 merge 方法将数据填充到模板中，生成输出文本。
输出结果：将生成的输出文本输出到文件或者控制台。

以下是一个简单的 Velocity 示例代码：

import org.apache.velocity.Template;
import org.apache.velocity.VelocityContext;
import org.apache.velocity.app.Velocity;

import java.io.BufferedWriter;
import java.io.FileWriter;
import java.util.HashMap;
import java.util.Map;

public class VelocityDemo {
    public static void main(String[] args) throws Exception {
        // 创建 Velocity 引擎
        Velocity.init();

        // 设置模板路径和编码方式
        String templatePath = "templates/hello.vm";
        String encoding = "UTF-8";

        // 准备数据
        Map<String, Object> data = new HashMap<>();
        data.put("name", "Velocity");

        // 填充模板
        VelocityContext context = new VelocityContext(data);
        Template template = Velocity.getTemplate(templatePath, encoding);
        BufferedWriter writer = new BufferedWriter(new FileWriter("output.txt"));
        template.merge(context, writer);

        // 输出结果
        writer.flush();
        writer.close();
    }
}

在上面的示例中，我们创建了一个 Velocity 引擎，设置了模板路径和编码方式，准备了数据，填充了模板，并将结果输出到文件。模板文件内容如下：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Hello, $name</title>
</head>
<body>
    <h1>Hello, $name</h1>
</body>
</html>

模板文件中使用了 $name 来引用数据，Velocity 引擎会将 $name 替换成实际的数据值。执行上面的代码后，输出的内容为：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Hello, Velocity</title>
</head>
<body>
    <h1>Hello, Velocity</h1>
</body>
</html>