在当今的 Web 应用开发领域，选择合适的技术栈对于提升开发效率、优化用户体验至关重要。Spring Boot 作为一款备受青睐的 Java 开发框架，以其强大的自动配置和便捷的开发体验而闻名。而 FreeMarker 作为一种优秀的模板引擎，能够高效地生成动态网页内容。将 Spring Boot 3 与 FreeMarker 整合，能够为开发者带来诸多便利，极大地提升开发效率和应用性能。本文将深入探讨二者的整合过程及应用场景。

Spring Boot 3 与 FreeMarker 概述

Spring Boot 3 的特点与优势

Spring Boot 3 在 Spring 框架的基础上进一步简化了开发流程，提供了更加自动化的配置。它具备以下显著特点：

自动配置：通过自动配置机制，Spring Boot 3 能够根据项目的依赖自动配置相关的 Bean，大大减少了开发者手动配置的工作量。例如，在整合数据库时，只需要添加相应的依赖，Spring Boot 就能自动配置好数据源、事务管理器等。
快速开发：内置的 Starter 依赖使得项目的搭建变得异常简单。开发者只需添加所需的 Starter，如spring - boot - starter - web用于 Web 开发，即可快速构建项目基础结构。
微服务支持：Spring Boot 3 对微服务架构提供了良好的支持，通过集成 Spring Cloud 等组件，能够轻松构建分布式系统。

FreeMarker 模板引擎简介

FreeMarker 是一款基于 Java 的模板引擎，它允许开发者通过模板文件生成动态内容。其主要优势包括：

语法简单：FreeMarker 的模板语法简洁易懂，易于学习和掌握。例如，使用${}语法来引用数据，<#if>等指令进行条件判断。
分离业务逻辑与展示：通过将数据和展示逻辑分离，使得前端开发人员和后端开发人员可以更专注于各自的工作。后端开发人员负责提供数据，前端开发人员负责设计模板，提高了开发效率和代码的可维护性。
高性能：FreeMarker 经过优化，在生成大量动态内容时具有较高的性能表现，适合用于高并发的 Web 应用场景。

Spring Boot 3 中整合 FreeMarker 的详细步骤

添加依赖

首先，在项目的pom.xml文件中添加 FreeMarker 的依赖。在标签内添加以下代码：


    org.springframework.boot
    spring - boot - starter - freemarker

添加该依赖后，Spring Boot 会自动引入 FreeMarker 及其相关依赖，并配置好基本的模板引擎环境。

配置文件设置

在application.properties或application.yml文件中进行 FreeMarker 的相关配置。以application.yml为例，添加如下配置：

spring:
  freemarker:
    prefix: classpath:/templates/
    suffix:.ftl
    charset: UTF - 8
    cache: false

prefix指定了模板文件的前缀路径，这里设置为classpath:/templates/，表示模板文件存放在src/main/resources/templates目录下。
suffix指定了模板文件的后缀名，这里使用.ftl作为 FreeMarker 模板文件的后缀。
charset设置模板文件的字符集为 UTF - 8，以确保正确处理各种字符。
cache设置为false，表示关闭模板缓存，方便在开发过程中实时查看模板修改效果。在生产环境中，可以根据实际情况开启缓存以提高性能。

创建模板文件

在
src/main/resources/templates目录下创建 FreeMarker 模板文件。例如，创建一个名为index.ftl的文件，用于展示首页内容。以下是一个简单的模板示例：




    
    Spring Boot 3 + FreeMarker示例


    欢迎来到我的网站
    <#if user>
        您好，${user.name}！
    <#else>
        请先登录

在这个模板中，使用了 FreeMarker 的条件判断指令<#if>。如果user变量存在，则显示欢迎用户的信息；否则提示用户登录。

创建 Controller 处理请求

在 Spring Boot 项目中创建一个 Controller 类，用于处理用户请求并返回对应的模板视图。例如，创建一个HomeController类：

package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HomeController {

    @GetMapping("/")
    public String index(Model model) {
        // 模拟从数据库或其他数据源获取用户信息
        User user = new User("张三");
        model.addAttribute("user", user);
        return "index";
    }
}

class User {
    private String name;

    public User(String name) {
        this.name = name;
    }

    public String getName() {
        return name;
    }
}

在index方法中，创建了一个User对象并添加到Model中，然后返回index视图名。Spring Boot 会根据配置的视图解析器，找到对应的index.ftl模板文件，并将Model中的数据填充到模板中进行渲染。

Spring Boot 3 与 FreeMarker 整合的高级应用

FreeMarker 支持模板继承，通过模板继承可以提高模板的复用性。例如，创建一个基础模板base.ftl，包含通用的页面结构，如头部、导航栏和底部等：




    
    <#if pagetitle>${pageTitle}</#if>


    
        我的网站
    
    
        
            首页
            关于我们
        
    
    <#-- -->
    <#nested>
    
        版权所有 (c) 2025

然后，其他模板可以继承自base.ftl，并在<#nested>标签处填充自己的内容。例如，index.ftl可以修改为：

<#ftl extends='base.ftl'>
<#-- -->
<#assign pagetitle='首页'>
<#-- -->
<#block>
    欢迎来到我的网站
    <#if user>
        您好，${user.name}！
    <#else>
        请先登录

通过模板继承，减少了重复代码，提高了模板的维护性。

自定义指令

在 FreeMarker 中，开发者可以自定义指令来扩展模板引擎的功能。例如，创建一个自定义指令用于格式化日期：

package com.example.demo.freemarker;

import freemarker.core.Environment;
import freemarker.template.*;

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Map;

public class DateFormatDirective implements TemplateDirectiveModel {

    @Override
    public void execute(Environment environment, Map params, TemplateModel[] loopVars, TemplateDirectiveBody body) throws TemplateException, java.io.IOException {
        TemplateModel dateModel = (TemplateModel) params.get("date");
        if (dateModel!= null) {
            Date date = ((DateModel) dateModel).getAsDate();
            String pattern = (String) ((SimpleScalar) params.get("pattern")).getAsString();
            SimpleDateFormat sdf = new SimpleDateFormat(pattern);
            String formattedDate = sdf.format(date);
            environment.getOut().write(formattedDate);
        }
    }
}

然后，在 Spring Boot 的配置类中注册这个自定义指令：

package com.example.demo.config;

import com.example.demo.freemarker.DateFormatDirective;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer;

import java.util.HashMap;
import java.util.Map;

@Configuration
public class FreeMarkerConfig {

    @Bean
    public FreeMarkerConfigurer freeMarkerConfigurer() {
        FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();
        Map variables = new HashMap<>();
        variables.put("dateFormat", new DateFormatDirective());
        configurer.setFreemarkerVariables(variables);
        return configurer;
    }
}

在模板中使用自定义指令：

<@dateformat date='currentDate' pattern='yyyy - MM - dd' />

利用自定义指令，能够让模板功能变得更加灵活。

总结

通过以上步骤，我们成功地将 Spring Boot 3 与 FreeMarker 进行了整合，并展示了一些高级应用场景。这种整合不仅提高了开发效率，还使得 Web 应用的开发更加灵活和可维护。在实际项目中，开发者可以根据具体需求进一步优化和扩展。

Tags：freemarker循环list

网站首页 > 精选文章 / 正文

深入剖析 Spring Boot3 与 FreeMarker 的高效整合及应用

Spring Boot 3 与 FreeMarker 概述

Spring Boot 3 中整合 FreeMarker 的详细步骤

欢迎来到我的网站

Spring Boot 3 与 FreeMarker 整合的高级应用

我的网站

欢迎来到我的网站

总结

猜你喜欢