freemark模板引擎(一)

时间:2022-08-24 09:15:51

一、模板引擎概述

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

常用的java后台模板引擎:jsp、FreeMarker、Velocity等。
freemark模板引擎(一)

二、freeMark简介

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

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

特征与亮点

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

获得FreeMarker

  1. 官网:http://freemarker.org/
  2. 中文帮助文档:https://sourceforge.net/projects/freemarker/files/chinese-manual/
  3. 下载FreeMarker jar包:下载地址http://freemarker.org/freemarkerdownload.html
  4. 使用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();
}
}