SpringBoot接入FreeMarker完整指南：依赖、配置与可运行样例

1
2
3
4
5
6
7
8

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

spring:
  freemarker:
    enabled: true
    # 模板加载位置，多个用逗号分隔，jar 内外混部时都列出
    template-loader-path: classpath:/templates/
    suffix: .ftl
    charset: UTF-8
    check-template-location: true
    # 开发期关缓存（改模板刷新即生效），生产记得开回 true
    cache: false
    expose-request-attributes: false
    expose-session-attributes: false
    expose-spring-macro-helpers: true
    # FreeMarker 原生 Settings，直接透传
    settings:
      # 防止数字被格式化成 1,000 千分位（高频坑）
      number_format: 0.##
      datetime_format: yyyy-MM-dd HH:mm:ss
      date_format: yyyy-MM-dd
      time_format: HH:mm:ss
      # null 值不抛异常，显示空
      classic_compatible: true
      template_update_delay: 0

server:
  port: 8080

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

/**
 * 页面控制器：演示 Model 数据渲染与模板复用
 */
@Controller
@RequestMapping("/page")
public class PageController {

    /** 用户列表页：Model 属性直接在 ftl 中按名访问 */
    @GetMapping("/users")
    public String users(Model model) {
        List<Map<String, Object>> users = new ArrayList<>();
        Map<String, Object> u1 = new HashMap<>();
        u1.put("name", "Anttu");
        u1.put("age", 28);
        u1.put("vip", true);
        users.add(u1);

        model.addAttribute("title", "用户列表");
        model.addAttribute("users", users);
        return "user/detail";      // -> classpath:/templates/user/detail.ftl
    }

    /** 首页 */
    @GetMapping("/index")
    public String index() {
        return "index";
    }
}

1
2
3
4
5
6

@GetMapping("/mv")
public ModelAndView mv() {
    ModelAndView mv = new ModelAndView("index");
    mv.addObject("title", " ModelAndView 渲染");
    return mv;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

/**
 * FreeMarker 全局配置：注入全站共享变量与共享方法
 */
@Configuration
public class FreemarkerConfig {

    @Autowired
    private freemarker.template.Configuration freemarkerConfiguration;

    @PostConstruct
    public void init() {
        Map<String, Object> shared = new HashMap<>();
        shared.put("siteName", "Anttu Blog");
        shared.put("version", "v1.2.0");
        // 模板里直接 ${site.siteName} 使用
        freemarkerConfiguration.setSharedVariable("site", shared);

        // 也可以注入共享方法，模板里 ${moneyCents(1050)}
        try {
            freemarkerConfiguration.setSharedVariable("moneyCents",
                    new MoneyCentsMethod());
        } catch (TemplateModelException e) {
            throw new IllegalStateException("注册共享方法失败", e);
        }
    }
}