1. 假设在一个在线商店的应用系统中需要一个html页面, 和下面这个页面类似:
<!DOCTYPE html>
<html>
<head>
<title>手机专卖</title>
<meta charset="utf-8" />
</head>
<body>
<h1>欢迎: 张三</h1>
<p>最新商品: <a href="products/mobile.html">华为P40</a></p>
</body>
</html>
2. 这里的用户名(上面的"张三"), 应该是登录这个网页的访问者的名字, 并且最新产品的数据应该来自于数据库, 这样它才能随时更新。那么不能直接在html页面中输入它们, 不能使用静态的html代码。此时, 可以使用要求输出的模板。模板和静态html是相同的, 只是它会包含一些FreeMarker将它们变成动态内容的指令:
<!DOCTYPE html>
<html>
<head>
<title>手机专卖</title>
<meta charset="utf-8" />
</head>
<body>
<h1>欢迎: ${user}</h1>
<p>最新商品: <a href="${latestProduct.url}">${latestProduct.name}</a></p>
</body>
</html>
3. 模板文件存放在Web服务器上, 就像通常存放静态html页面那样。当有人来访问这个页面, FreeMarker将会介入执行, 然后动态转换模板, 用最新的数据内容替换模板中${...}的部分, 之后将结果发送到访问者的Web浏览器中。访问者的Web浏览器就会接收到例如第一个html示例那样的内容(也就是没有FreeMarker指令的html代码), 访问者也不会察觉到服务器端使用的FreeMarker。 (当然, 存储在Web服务器端的模板文件是不会被修改的; 替换也仅仅出现在Web服务器的响应中。)
4. 请注意, 模板并没有包含程序逻辑来查找当前的访问者是谁, 或者去查询数据库获取最新的产品。显示的数据是在FreeMarker之外准备的, 通常是一些"真正的"编程语言(比如Java) 所编写的代码。模板作者无需知道这些值是如何计算出的。事实上, 这些值的计算方式可以完全被修改, 而模板可以保持不变, 而且页面的样式也可以完全被修改而无需改动模板。当模板作者(设计师)和程序员不是同一人时, 显示逻辑和业务逻辑相分离的做法是非常有用的, 即便模板作者和程序员是一个人, 这么来做也会帮助管理应用程序的复杂性。保证模板专注于显示问题(视觉设计, 布局和格式化)是高效使用模板引擎的关键。
5. 为模板准备的数据整体被称作为 数据模型。 模板作者要关心的是, 数据模型是树形结构(就像硬盘上的文件夹和文件), 在视觉效果上, 数据模型可以是:
6. 上面只是一个形象化显示; 数据模型不是文本格式, 它来自于Java对象。对于Java程序员来说, root就像一个有getUser()和getLatestProduct()方法的Java对象, 或者是有"user"和"latestProducts"键值的Java Map对象。相似地, latestProduct就像是有getUrl()和getName()方法的Java对象, 或者是有"url"和"name"键值的Java Map对象。
7. 可以从数据模型中选取这些值, 使用user和latestProduct.name表达式即可。如果我们类推, 数据模型就像一个文件系统, 那么"(root)"和latestProduct就对应着目录(文件夹), 而user, url和name就是这些目录中的文件。
8. 总的来说, 模板和数据模型是FreeMarker来生成输出(比如第一个展示的HTML)所必须的: 模板 + 数据模型 = 输出。