Spring Boot 集成 Freemarker 实战指南

鲍珍博Quinn

于 2024-08-16 07:45:58 发布

阅读量837

点赞数 9

本文链接：https://blog.youkuaiyun.com/gitblog_00423/article/details/141236936

版权

Spring Boot 集成 Freemarker 实战指南

springboot-freemarker包含框架有：SpringBoot、SpringMVC、MyBaits、Bootstrap3、Freemarker；有完整的UI、增删改查及分页，防SQL注入、XSS攻击拦截等项目地址:https://gitcode.com/gh_mirrors/sp/springboot-freemarker

项目介绍

本项目 springboot-freemarker 是一个示例，展示了如何在 Spring Boot 应用程序中有效地集成 Freemarker 模板引擎。Freemarker 是一个强大且灵活的模板语言，广泛用于生成动态网页内容、邮件正文等，它允许开发者与设计师分离工作，专注于各自领域的代码。

项目快速启动

步骤1: 添加依赖

首先，确保你的 pom.xml 文件中包含了 Spring Boot Starter Web 和 Freemarker 的依赖项：

<!-- 引入Spring Boot Starter Web -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- 引入Spring Boot Starter Freemarker -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

步骤2: 配置Freemarker

在 application.properties 或 application.yml 中配置 Freemarker 相关路径，例如：

spring.freemarker.template-loader-path=classpath:/templates/
spring.freemarker.suffix=.ftl

步骤3: 创建模板

在 src/main/resources/templates 目录下创建一个简单的 index.ftl 文件作为首页：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Welcome to Spring Boot with Freemarker</title>
</head>
<body>
    <h1>Hello, ${name}!</h1>
</body>
</html>

步骤4: 编写控制器

接下来，在 src/main/java/com/example 包下创建一个控制器类，比如 HomeController.java：

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

@Controller
public class HomeController {

    @GetMapping("/")
    public String home(Model model) {
        model.addAttribute("name", "Spring Boot User");
        return "index";
    }
}

步骤5: 运行应用

启动您的 Spring Boot 应用，访问 http://localhost:8080/，您将看到欢迎页面显示“Hello, Spring Boot User!”。

应用案例和最佳实践

在实际开发中，除了基本的视图渲染外，Freemarker的灵活性体现在数据处理、循环、条件判断和宏定义等方面。为了优化性能和代码可维护性，推荐的做法包括：

利用宏：将重复使用的模板片段封装成宏。
数据模型清晰化：传给模板的数据结构应尽量简洁明了。
缓存策略：对于静态内容较多的页面，可以考虑启用Freemarker的缓存机制，减少服务器端计算。

典型生态项目

虽然此项目本身就是围绕Spring Boot和Freemarker的一个小生态，但在更广泛的上下文中，Spring Boot集成了许多其他技术，如MyBatis、Hibernate等，与Freemarker结合使用时，可以构建功能丰富且维护便捷的web应用。此外，Freemarker不仅限于网页模板，它也可以应用于生成报告、邮件模版等领域，是现代软件架构中的多面手。

通过遵循以上步骤和最佳实践，您可以迅速上手Spring Boot与Freemarker的集成，进一步探索其在各种应用场景下的强大能力。