FreeMarker源码分析（一）

2021SC@SDUSC

FreeMarker简要介绍

FreeMarker 是一款 模板引擎： 即一种基于模板和要改变的数据， 并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。 它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。

模板编写为FreeMarker Template Language (FTL)。它是简单的，专用的语言， 不是 像PHP那样成熟的编程语言。 那就意味着要准备数据在真实编程语言中来显示，比如数据库查询和业务运算， 之后模板显示已经准备好的数据。在模板中，你可以专注于如何展现数据， 而在模板之外可以专注于要展示什么数据。

这种方式通常被称为 MVC (模型 视图 控制器) 模式，对于动态网页来说，是一种特别流行的模式。 它帮助从开发人员(Java 程序员)中分离出网页设计师(HTML设计师)。设计师无需面对模板中的复杂逻辑， 在没有程序员来修改或重新编译代码时，也可以修改页面的样式。

而FreeMarker最初的设计，是被用来在MVC模式的Web开发框架中生成HTML页面的，它没有被绑定到 Servlet或HTML或任意Web相关的东西上。它也可以用于非Web应用环境中。

FreeMarker 是 免费的， 基于Apache许可证2.0版本发布。

任务分配

本次关于对FreeMarker核心源码的分析任务由我们组四人进行，下面我仅对我个人的任务进行简要介绍。

我的工作主要是对log和Template两部分分析，此部分代码位于apache-freemarker-2.3.31-src\src\main\java\freemarker\log和apache-freemarker-2.3.31-src\src\main\java\freemarker\Template下

log是日志，主要用于进行执行的情况，对程序进展进行一定的记录。

 

Template则是模板类，提供了字符串可以转换的各种样式，例如html，邮件内容等等，是free marker中很重要的一部分。

 

准备工作

1、源码下载

官网地址：FreeMarker Java Template Engine
（1）点击官网最下方Overview下的Download
(2)可以看到Download下方的链接，点击相应的链接下载源码

2，查看源码确定任务分配

经过小组成员讨论分析后，确定apache-freemarker-2.3.31-src\src\main\java\freemarker下的文件为主要核心代码，然后根据代码量进行分配。

 

该目录下的文件夹core为核心代码，分为一组；
ext为输出格式相关，分为一组；
cache和debug分为一组；
log和template分为一组。

本人负责log和template

正式工作

本文仅为解释分组情况，任务分配情况，以及说明FreeMarker源代码的下载和安装配置。具体代码分析将会在10月1日之后以每周1篇的速度发布。