springboot freemarker
时间: 2025-01-04 22:36:02 浏览: 35
如何在 Spring Boot 中集成和配置 FreeMarker 模板引擎
添加 Maven 依赖
为了使 Spring Boot 支持 FreeMarker,在 pom.xml
文件中需加入特定的依赖项。具体来说,应包含如下所示的依赖:
<!-- Freemarker 依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
<!-- Web 依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
这些依赖确保了应用程序能够识别并处理 FreeMarker 的模板文件[^2]。
配置 application.properties 或 application.yml
接着,应在配置文件里指定 FreeMarker 模板的位置以及其扩展名。对于采用 .properties
格式的配置文件而言,可以这样设置:
spring.freemarker.template-loader-path=classpath:/templates/
spring.freemarker.suffix=.ftl
如果偏好 YAML 格式,则相应的配置会是这样的形式:
spring:
freemarker:
template-loader-path: classpath:/templates/
suffix: .ftl
上述配置指定了模板加载路径为类路径下的 /templates/
目录,并设定了模板文件的标准后缀名为 .ftl
[^1]。
创建控制器 (Controller)
创建一个新的控制器来渲染页面。下面是一个简单的例子展示如何返回一个视图名称给前端:
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class HelloController {
@GetMapping("/hello")
public String hello(Model model) {
model.addAttribute("message", "Hello, world!");
return "hello"; // 这里的 'hello' 对应 templates/hello.ftl 路径下的模板文件
}
}
这段代码定义了一个处理器方法用于响应来自浏览器的请求并将数据传递到 FreeMarker 模板以便呈现给用户。
编写 FreeMarker 模板
最后一步是在资源目录下建立对应的 HTML+FTL 结构的模板文档。比如可以在 src/main/resources/templates/
下新建一个叫做 hello.ftl
的文件,内容可能像这样:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Hello Page</title>
</head>
<body>
<h1>${message}</h1>
</body>
</html>
此模板利用 ${}
表达式语法获取由控制器传来的变量值并显示出来。
通过以上步骤就可以成功地在一个基于 Spring Boot 构建的应用程序内集成了 FreeMarker 模板引擎。
相关推荐


















