freemark模板引擎（一）

最新推荐文章于 2024-04-11 19:08:01 发布

转载最新推荐文章于 2024-04-11 19:08:01 发布 · 1.6k 阅读

文章标签：

#模板引擎 #freemarker

前端专栏收录该内容

7 篇文章

订阅专栏

本文介绍了FreeMarker模板引擎的基本概念及其在MVC架构中的作用，提供了详细的安装步骤和使用示例，展示了如何通过FreeMarker实现数据与表现层的分离。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、模板引擎概述

模板引擎可以让程序实现界面与数据分离，业务代码与逻辑代码的分离，这就提升了开发效率，良好的设计也使得代码复用变得更加容易。一般的模板引擎都包含一个模板解析器和一套标记语言，好的模板引擎有简洁的语法规则、强大的功能、高效的渲染效率、详尽的帮助说明与不断的更新与维护。常见的前端模板引擎有：
这里写图片描述

常用的java后台模板引擎：jsp、FreeMarker、Velocity等。
这里写图片描述

二、freeMark简介

FreeMarker是一款模板引擎，即一种基于模板和要改变的数据，并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。模板编写为FreeMarkerTemplateLanguage(FTL)。它是简单的，专用的语言，不是像PHP那样成熟的编程语言。那就意味着要准备数据在真实编程语言中来显示，比如数据库查询和业务运算，之后模板显示已经准备好的数据。在模板中，你可以专注于如何展现数据，而在模板之外可以专注于要展示什么数据。

这种方式通常被称为MVC(模型视图控制器)模式，对于动态网页来说，是一种特别流行的模式。它帮助从开发人员(Java程序员)中分离出网页设计师(HTML设计师)。设计师无需面对模板中的复杂逻辑，在没有程序员来修改或重新编译代码时，也可以修改页面的样式。
而FreeMarker最初的设计，是被用来在MVC模式的Web开发框架中生成HTML页面的，它没有被绑定到Servlet或HTML或任意Web相关的东西上。它也可以用于非Web应用环境中。

特征与亮点

功能强大的模板语言：有条件的块，迭代，赋值，字符串和算术运算和格式化，宏和函数，编码等更多的功能；
多用途且轻量：零依赖，输出任何格式，可以从任何地方加载模板（可插拔），配置选项丰富；
智能的国际化和本地化：对区域设置和日期/时间格式敏感。
XML处理功能：将dom-s放入到XML数据模型并遍历它们，甚至处理他们的声明
通用的数据模型：通过可插拔适配器将java对象暴露于模板作为变量树。
FreeMarker是免费的，基于Apache许可证2.0版本发布。

获得FreeMarker

官网：http://freemarker.org/
中文帮助文档：https://sourceforge.net/projects/freemarker/files/chinese-manual/
下载FreeMarker jar包：下载地址http://freemarker.org/freemarkerdownload.html
使用Maven依赖jar包：

<dependency>
  <groupId>org.freemarker</groupId>
  <artifactId>freemarker-gae</artifactId>
  <version>2.3.25-incubating</version>
</dependency>

FreeMarker用途

生成HTML Web页面，如作为MVC框架的视图
动态页面静态化等
代码生成器

三、freemark实例

模板 + 数据模型 = 输出，FreeMarker基于设计者和程序员是具有不同专业技能的不同个体的观念，他们是分工劳动的：设计者专注于表示——创建HTML文件、图片、Web页面的其它可视化方面；程序员创建系统，生成设计页面要显示的数据。总之实现了数据与表现的分离。
1、新建一个maven项目
2、配置pom.xml，增加freemark的maven依赖，配置如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.w2cboy</groupId>
    <artifactId>FreeMarkerDemo</artifactId>
    <version>0.0.1</version>
    <dependencies>
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.23</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
        </dependency>
    </dependencies>
</project>

3、添加模板目录文件夹 templates，在此下面添加名为“product.ftl”的FreeMarker模板，模板的内容如下：

4、解析模板
使用FreeMarker可以读取到模板内容，将数据与模板绑定并渲染出结果，很好的实现了表现与数据分离。新建一个测试类，代码如下：

public class FreemarkTest {
public static void main(String[] args) throws Exception {

        //创建一个freemarker.template.Configuration实例，它是存储 FreeMarker 应用级设置的核心部分
        //指定版本号
        Configuration cfg=new Configuration(Configuration.VERSION_2_3_22);
        //设置模板目录
        cfg.setDirectoryForTemplateLoading(new File("src/main/java/com/w2cboy/templates"));
        //设置默认编码格式
        cfg.setDefaultEncoding("UTF-8");

        //数据
        Map<String, Object> product = new HashMap<String, Object>();
        product.put("name", "Huwei P8");
        product.put("price", "3985.7");
        product.put("users", new String[]{"Tom","Jack","Rose"});

        //从设置的目录中获得模板
        Template temp = cfg.getTemplate("product.ftl");

        //合并模板和数据模型
        Writer out = new OutputStreamWriter(System.out);
        temp.process(product, out);

        //关闭
        out.flush();
        out.close();
    }
}