freemaker js封装

FreeMarker 是一个流行的 Java 模板引擎，用于生成动态内容。它允许开发者将逻辑与表现分离，使得模板设计更加直观，同时保持了后端逻辑的清晰。FreeMarker 不是 JavaScript 的一部分，但可以在服务器端生成 JavaScript 代码，或者在客户端通过 AJAX 请求获取由 FreeMarker 生成的 JSON 数据。

基础概念

FreeMarker 使用模板文件来定义输出内容的结构和样式，这些模板文件通常包含文本和 FreeMarker 特定的指令。在模板文件中，可以使用变量、条件语句、循环等来控制输出内容。

类型

FreeMarker 主要有以下几种使用类型：

Web 页面渲染：与 Servlet、Spring MVC 等框架集成，用于生成 HTML 页面。
生成配置文件：可以用来生成 XML、JSON、Properties 文件等。
代码生成：可以用来生成 Java、JavaScript 等代码片段。

应用场景

Web 开发：与 Java Web 框架结合，用于动态生成网页内容。
报告生成：生成报表、统计图表等。
配置管理：动态生成应用程序的配置文件。

封装 FreeMarker

封装 FreeMarker 主要是为了简化模板的使用和提高代码的可维护性。可以通过创建一个工具类或者服务类来实现 FreeMarker 的初始化、模板加载、数据模型设置和模板渲染等操作。

以下是一个简单的 FreeMarker 封装示例：

import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateExceptionHandler;

import java.io.StringWriter;
import java.util.Map;

public class FreeMarkerUtil {

    private static Configuration cfg;

    static {
        cfg = new Configuration(Configuration.VERSION_2_3_30);
        // 设置模板目录
        cfg.setClassForTemplateLoading(FreeMarkerUtil.class, "/templates");
        // 设置异常处理器
        cfg.setDefaultEncoding("UTF-8");
        cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
        cfg.setLogTemplateExceptions(false);
        cfg.setWrapUncheckedExceptions(true);
        cfg.setFallbackOnNullLoopVariable(false);
    }

    public static String processTemplate(String templateName, Map<String, Object> dataModel) throws Exception {
        Template template = cfg.getTemplate(templateName);
        StringWriter out = new StringWriter();
        template.process(dataModel, out);
        return out.toString();
    }
}

使用封装后的 FreeMarker 工具类，可以简化模板渲染的过程：

Map<String, Object> data = new HashMap<>();
data.put("message", "Hello, FreeMarker!");
String renderedHtml = FreeMarkerUtil.processTemplate("hello.ftl", data);