freemarker 知识点入门

最新推荐文章于 2022-08-06 11:19:01 发布

原创最新推荐文章于 2022-08-06 11:19:01 发布 · 752 阅读

0 ·

CC 4.0 BY-SA版权

本文介绍了FreeMarker模板引擎的基本概念及工作原理，包括如何利用模板和数据模型生成动态网页内容。详细阐述了FreeMarker的数据模型结构，如哈希表、序列等，并提供了具体的示例。

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

什么是FreeMarker？
FreeMarker 是一款模板引擎：即一种基于模板、用来生成输出文本(任何来自于HTML
格式的文本用来自动生成源代码)的通用工具。它是为Java 程序员提供的一个开发包，或者
说是一个类库。它不是面向最终用户的，而是为程序员提供的一款可以嵌入他们所开发产品
的应用程序。
FreeMarker实际上是被设计用来生成HTML页面，尤其是通过实现了基于MVC(Model
View Controller，模型-视图-控制器)模式的Java Servlet应用程序

Java 程序准备的数据来进行显示(比如SQL数据库查询)，FreeMarker仅仅是使
用模板生成文本页面来呈现已经准备好的数据而已。

要记得一句话 模板 + 数据模型 = 输出

模板文件
同样是静态的HTML代码，但是除了这些HTML代码外，代码中还包括了一些FreeMarker
指令元素，这些指令就能够做到动态效果。

例如

<html> 
<head> 
  <title>Welcome!</title> 
</head> 
<body> 
  <h1>Welcome ${user}!</h1> 
  <p>Our latest product: 
  <a href="${latestProduct.url}">${latestProduct.name}</a>! 
</body> 
</html>

这个模板存放在Web服务器上，看上去像是静态的HTML页面。但不管何时，只要有
人来访问这个页面，FreeMarker将会介入执行，然后动态转换模板，用最新的数据内容替换
模板中${…}的部分（例如：用Big Joe或者其他的访问者的用户名来代替${user}），生成普通
的HTML文本并发送结果到访问者的Web浏览器中去显示。所以访问者的Web浏览器会接
收到类似于第一个HTML示例的内容（也就是说，显示普通的HTML文本而没有FreeMarker
的指令），因为浏览器也不会感知到FreeMarker在服务器端被调用了。模板文件本身（存储
在Web服务器端的文件）在这个过程中也不会改变什么，所以这个转换过程发生在一次又
一次的访问中。这样就保证了显示的信息总是即时的。

data-model数据模型

例如上例的数据可以是这样

(root) 
  | 
  +- user = "Big Joe" 
  | 
  +- latestProduct 
      | 
      +- url = "products/greenmouse.html" 
      | 
      +- name = "green mouse"

注：为了避免误解：数据模型并不是文本文件，上面所描述的只是一种数据模型的表现形式。
它来自于Java 对象，但这会成为Java 程序员要面对的问题。

到了这里。具体介绍下常用的数据模型

hash哈希表

具体可以是这样

(root) 
  | 
  +- animals 
  |   | 
  |   +- mouse 
  |   |   |    
  |   |   +- size = "small" 
  |   |   |    
  |   |   +- price = 50 
  |   | 
  |   +- elephant 
  |   |   |    
  |   |   +- size = "large" 
  |   |   |    
  |   |   +- price = 5000 
  |   | 
  |   +- python 
  |       |    
  |       +- size = "medium" 
  |       |    
  |       +- price = 4999 
  | 
  +- test = "It is a test" 
  | 
  +- whatnot 
      | 
      +- because = "don't know"

哈希表通过可查找的名称来输出值

例如想得到动物鼠大小的具体描述可以用${animals.mouse.size}

标量表示仅存储单值的变量（size，price，text和because）

还有一种

sequences序列也是一种非常重要的变量，它们和哈希表变量相似，但是它们不存储所
包含变量的名称，而是按顺序存储子变量。这样，就可以使用数字索引来访问这些子变量。
在这种数据模型中，animal和whatnot.fruits就是序列:

(root) 
  | 
  +- animals 
  |   | 
  |   +- (1st) 
  |   |   | 
  |   |   +- name = "mouse" 
  |   |   | 
  |   |   +- size = "small" 
  |   |   | 
  |   |   +- price = 50 
  |   | 
  |   +- (2nd) 
  |   |   | 
  |   |   +- name = "elephant" 
  |   |   | 
  |   |   +- size = "large" 
  |   |   | 
  |   |   +- price = 5000 
  |   | 
  |   +- (3rd) 
  |       | 
  |       +- name = "python" 
  |       | 
  |       +- size = "medium" 
  |       | 
  |       +- price = 4999 
  | 
  +- whatnot 
      | 
      +- fruits 
          | 
          +- (1st) = "orange" 
          | 
          +- (2nd) = "banana"

可以使用数组的方括号方式来访问一个序列的子变量。索引从零开始（从零开始是程序
员写代码的传统习惯），那么就意味着序列第一项的索引是0，第二项的索引是1，并以此类
推。要得到第一个动物的名称的话，那么就应该这么写代码：animals[0].name。要
得到whatnot.fruits（就是”banana”这个字符串）的第二项，那么就应该这么来
写:whatnot.fruits[1]。

标量的具体类型字符串：这是文本类型，数字：这是数字值类型，日期/时间：这是时间日期类型。布尔值：对应对/错（是/否，开/关等）这样仅仅代表正反的值。

总结：
数据模型可以被看做是树状结构的。
标量存储单一的值，这种类型的值可以是字符串，数字，日期/时间或者是布尔值。
哈希表是存储变量和与其相关且有唯一标识名称变量的容器。
序列是存储有序变量的容器。存储的变量可以通过数字索引来检索，索引通常从零开始。

下面是

模板

最简单的模板是普通HTML文件（或者是其他任何文本文件—FreeMarker 本身不属于
HTML）。当客户端访问页面时，FreeMarker要发送HTML代码至客户端浏览器端显示。如果
想要页面动起来，就要在HTML中放置能被FreeMarker所解析的特殊部分。

例如插值 ${…}

FTL tags标签是FreeMarker 的指令而且是不会直接输出出来的东西。这些标签的使用一般以符号#
开头。用户自定义的FTL标签使用@符号来代替#

Comments注释：FreeMarker的注释和HTML的注释相似，但是它用<#--和-->来分
隔的。任何介于这两个分隔符（包含分隔符本身）之间内容会被FreeMarker 忽略，就不会
输出出来了。

directives 指令：就是所指的FTL 标签常用指令示例 <#if str=="hello">hello</#if> 与程序中if比较类似,表示str如果等于hello，就会执行hello,否则不执行