在Spring Boot中应用FreeMarker模板引擎主要涉及以下几个步骤:
1. 引入FreeMarker依赖
首先,在Spring Boot项目的 pom.xml
文件中加入FreeMarker的依赖。这一步确保了项目能够使用FreeMarker模板引擎:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
2. 配置FreeMarker属性
在 application.properties
或 application.yml
中配置FreeMarker的属性。这些配置控制了FreeMarker模板的行为和特性,例如模板加载路径、编码方式等:
spring.freemarker.template-loader-path=classpath:/templates/
spring.freemarker.suffix=.ftl
spring.freemarker.charset=UTF-8
spring.freemarker.check-template-location=true
3. 创建FreeMarker模板
在项目的资源目录(通常是 src/main/resources
)下创建一个 templates
文件夹,并在其中编写FreeMarker模板文件。例如,创建一个名为 example.ftl
的文件,文件内容可以是:
<html>
<body>
<h1>Welcome ${name}!</h1>
</body>
</html>
这里 ${name}
是一个模板变量,将在渲染时被替换。
4. 编写控制器
在Spring Boot应用中创建一个控制器,使用 Model
对象传递数据到FreeMarker模板。例如:
@Controller
public class ExampleController {
@GetMapping("/greet")
public String greeting(@RequestParam(name="name", required=false, defaultValue="World") String name, Model model) {
model.addAttribute("name", name);
return "example"; // 对应example.ftl模板
}
}
在这个示例中,当访问 /greet
路径时,控制器会处理请求并将 name
参数的值传递给模板。
5. 运行和测试
运行Spring Boot应用,并在浏览器中访问相应的URL(如 http://localhost:8080/greet?name=YourName
)。这时,FreeMarker模板会被渲染,并显示个性化的问候语。
注意事项:
- 确保模板文件的后缀与配置中的
spring.freemarker.suffix
属性一致。 - 使用合适的数据结构传递给模板,如Map或自定义对象,以便在模板中方便地引用数据。
- 在开发过程中,可以开启模板缓存的相关配置,以便于快速加载更改后的模板。
通过以上步骤,可以在Spring Boot应用中顺利集成并使用FreeMarker模板引擎,实现动态网页内容的生成。
云服务器/高防CDN推荐
蓝易云国内/海外高防云服务器推荐
海外免备案云服务器链接:www.tsyvps.com
蓝易云安全企业级高防CDN:www.tsycdn.com
持有增值电信营业许可证:B1-20222080【资质齐全】
蓝易云香港五网CN2 GIA/GT精品网络服务器。拒绝绕路,拒绝不稳定。