使用Apache Velocity生成邮件模板内容

什么是Apache Velocity？
Apache Velocity是一个提供模板服务的Java库，它允许你定义动态资源（如邮件、HTML页面等）。Velocity使用特殊的模板语言（VTL），让你可以轻松地将动态数据插入到模板中。

为什么选择Velocity？
简单性：Velocity的模板语言简单直观，易于学习和使用。
灵活性：可以用于多种场景，包括生成邮件、网页和其他文本内容。
强大的社区支持：作为Apache项目的一部分，Velocity拥有活跃的社区和丰富的资源。
初始化Velocity引擎
在使用Velocity之前，需要先初始化Velocity引擎。以下是一个简单的初始化示例：

java

public class VelocityInitializer {
    private static final String CLASS_LOADER = "file.resource.loader.class";
    private static final String CLASSPATH_RESOURCE_LOADER = "org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader";

    public static void initVelocity() {
        Properties p = new Properties();
        try {
            p.setProperty(CLASS_LOADER, CLASSPATH_RESOURCE_LOADER);
            p.setProperty(Velocity.ENCODING_DEFAULT, "UTF-8");
            Velocity.init(p);
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
}

使用Velocity生成邮件内容
一旦初始化了Velocity引擎，就可以使用它来生成邮件内容了。以下是一个使用Velocity模板生成邮件内容的示例：

java

import org.apache.velocity.VelocityContext;
import org.apache.velocity.app.Velocity;
import org.apache.velocity.runtime.RuntimeConstants;
import java.io.StringWriter;
import java.util.Map;

public class VelocityMailUtil {

    public static String genStrByVelocity(String velocityPath, Map<String, Object> mapParam) {
        if (velocityPath == null || velocityPath.trim().isEmpty()) {
            throw new IllegalArgumentException("模板路径不能为空！");
        }
        // 初始化Velocity引擎
        VelocityInitializer.initVelocity();
        // 创建Velocity上下文并添加参数
        VelocityContext velocityContext = new VelocityContext();
        mapParam.forEach(velocityContext::put);
        // 准备StringWriter以写入模板生成的文本
        StringWriter sw = new StringWriter();
        try {
            // 获取模板并合并上下文，生成最终的邮件内容
            Template tpl = Velocity.getTemplate(velocityPath, "UTF-8");
            tpl.merge(velocityContext, sw);
        } catch (Exception e) {
            throw new RuntimeException("生成邮件内容失败", e);
        }
        return sw.toString();
    }
}

示例：生成注册确认邮件
假设你有一个注册确认邮件的模板registerEmail.vm，你可以这样使用VelocityMailUtil来生成邮件内容：

java

Map<String, Object> params = new HashMap<>();
params.put("username", "用户名称");
params.put("link", "注册确认链接");

String emailContent = VelocityMailUtil.genStrByVelocity("/templates/registerEmail.vm", params);

总结
Apache Velocity提供了一种简单而强大的方法来生成邮件和其他文本内容。通过本文的示例，你可以在自己的应用程序中集成Velocity，以提高生成动态内容的效率。