FreeMarker静态模版基础语法

原创已于 2025-05-09 10:21:44 修改 · 645 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言

于 2025-05-08 22:36:18 首次发布

微服务专栏收录该内容

10 篇文章

订阅专栏

FreeMarker基础语法在 Spring Boot 中的使用详解

FreeMarker 是一款以 简洁性 和 灵活性 见长的模板引擎，尤其适合需要动态生成文本但追求逻辑与展示分离的场景。其清晰的语法、强大的数据驱动能力，使其成为 Java 生态中广泛使用的工具。选择时需权衡项目需求：若需高度交互的现代 Web 应用，可考虑结合前端框架；若侧重服务端渲染或代码生成，FreeMarker 仍是经典选择。
在这里插入图片描述

1. 导入依赖

在 pom.xml 中添加 Spring Boot 官方提供的 FreeMarker Starter 依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

Spring Boot 会自动管理版本，无需手动指定。

2. 配置文件（`application.yml`）

在 src/main/resources/application.yml 中配置 FreeMarker：

spring:
  freemarker:
    template-loader-path: classpath:/templates/  # 模板存放路径
    cache: false  # 开发时关闭缓存，修改模板后立即生效
    charset: UTF-8
    check-template-location: true
    suffix: .ftl  # 模板文件后缀
    content-type: text/html

在这里插入图片描述

3. 简单例子

步骤 1：创建 Controller

@Controller
public class DemoController {
    @GetMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("name", "World");
        return "hello"; // 对应 templates/hello.ftl
    }
}

步骤 2：创建模板文件 hello.ftl

<!DOCTYPE html>
<html>
<head>
    <title>FreeMarker Demo</title>
</head>
<body>
    <h1>Hello, ${name}!</h1>
</body>
</html>

访问 http://localhost:8080/hello 会渲染出 Hello, World!。

4. 基本语法

插值表达式：${variable}
输出变量值，如 ${user.age}。
定义变量：
```
<#assign price = 100>
Price: ${price}
```
注释：
<#-- 这是注释，不会输出 -->

5. 集合指令 `<#list>`

遍历集合（List、数组等）：

<#list users as user>
    Index: ${user_index}  <#-- 内置索引（从0开始） -->
    Name: ${user.name}
    <#if user_has_next>, </#if>  <#-- 判断是否是最后一个元素 -->
</#list>

Controller 数据准备：

model.addAttribute("users", List.of(
    new User("Alice"),
    new User("Bob")
));

6. `if` 指令

条件判断：

<#if user.age < 18>
    未成年
<#elseif user.age == 18>
    刚成年
<#else>
    成年人
</#if>

7. 运算符

算术运算符：+, -, *, /, %
比较运算符：==, !=, >, >=, <, <=
逻辑运算符：&&, ||, !
空值处理运算符：
- !：默认值，如 ${name!"Anonymous"}（若 name 为空，显示 “Anonymous”）。
- ??：判断变量是否存在，如 <#if name??>...

8. 空值处理

避免因变量为 null 导致渲染错误：

默认值：
```
${user.address!"No address"}
```

安全判断：

<#if user.address??>
    Address: ${user.address}
<#else>
    Address not provided.
</#if>

9. 内建函数

FreeMarker 提供丰富的内置函数，通过 ? 调用：

字符串处理：

${"hello"?upper_case}  <#-- 输出 "HELLO" -->
${"Hello"?lower_case?cap_first}  <#-- 输出 "hello" → "Hello" -->

日期格式化：
```
${now?string("yyyy-MM-dd HH:mm:ss")}
```

集合操作：

${users?size}  <#-- 集合长度 -->
${users?join(", ")}  <#-- 将集合元素拼接为字符串 -->

数值处理：

${price?string.currency}  <#-- 格式化为货币，如 "$100.00" -->

总结

通过上述步骤，你可以在 Spring Boot 中快速集成 FreeMarker，利用其强大的模板功能实现动态页面渲染。重点掌握集合遍历、条件判断和空值处理，能有效提升开发效率。