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代码分析任务由本组4人进行。出于个人未经他人允许即进行保密的原则，我仅就我分配到的任务部分进行说明，我分配到的部分为apache-freemarker-2.3.31-src\src\main\java\freemarker\ext部分的代码，该部分代码主要负责将文本按照合适的格式进行输出。
该部分包含的内容如下图。

准备工作

1，从相应官网下载源码

官网地址：http://freemarker.foofun.cn/
（1）点击官网最下方Overview下的Download
(2)可以看到Download下方的链接，点击相应的链接下载源码

2，查看源码确定内容分配

由各部分内容分析，确定apache-freemarker-2.3.31-src\src\main\java\freemarker下的文件为主要代码，根据直观代码量进行分配。
core为核心代码，分为一组；
ext为输出格式相关，分为一组；
cache和debug分为一组；
log和template分为一组。
本人仅负责分析ext部分，其余部分可查看相关文章进行了解。

正式工作

本文仅为解释分组情况，内容分配情况。具体代码分析将会在10月1日之后按照每周1篇的速度推出，尽情期待。

链接地址：http://freemarker.foofun.cn/