背景
FreeMarker是一个基于Java的模板引擎,专注于使用MVC软件架构生成动态网页。不过它是一个通用的模板引擎,不依赖于servlets或HTTP或HTML,因此它通常用于生成源代码,配置文件或电子邮件。
FreeMarker 是 免费的, 基于Apache许可证2.0版本发布。
开发者 | Jonathan Revusky, Attila Szegedi, Dániel Dékány, and others |
---|---|
稳定版本 | 2.3.28(2018年4月4日) |
编程语言 | Java |
操作系统 | 跨平台 |
类型 | 模板引擎 |
许可协议 | Apache License 2.0 |
网站 | freemarker.org |
用处
用来在MVC模式的Web开发框架中生成HTML页面
特征
FreeMarker的一些亮点:
- 强大的模板语言:条件块,迭代,赋值,字符串和算术运算和格式,宏和函数(包括其他模板),默认转义(可选)等
- 多用途和轻量级:零依赖性,任何输出格式,可以从任何位置加载模板(可插拔),许多配置选项
- 国际化/本地化意识:区域设置敏感的数字和日期/时间格式,本地化的模板变体。
- XML处理能力:将XML DOM放入数据模型并遍历它们,甚至进行声明式处理
- 通用的数据模型:Java对象通过可插拔适配器以变量树的形式暴露于模板,该适配器决定了模板如何看待它们。
环境配置
开发工具:IntelliJ IDEA
编译环境:JDK 1.8
操作系统:Windows
入门实例
1.整合SpringBoot
引入依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
配置模板
在setting->editor->File and code templates,点击添加
添加完模板代码后,点击确定。
属性配置
在application.properties文件中配置freemarker相关属性
#freemarker 配置
#设置是否允许HttpServletRequest属性覆盖(隐藏)控制器生成的同名模型属性。
spring.freemarker.allow-request-override=false
#设置是否允许HttpSession属性覆盖(隐藏)控制器生成的同名模型属性。
spring.freemarker.allow-session-override=false
#是否启用模板缓存。
spring.freemarker.cache=false
#设置编码格式
spring.freemarker.charset=UTF-8
#检查模板位置是否存在。
spring.freemarker.check-template-location=true
#内容类型值
spring.freemarker.content-type=text/html
#为这种技术启用MVC视图解决方案。
spring.freemarker.enabled=true
#设置是否应该在与模板合并之前将所有请求属性添加到模型中。
spring.freemarker.expose-request-attributes=true
#设置是否在与模板合并之前将所有HttpSession属性添加到模型中。
spring.freemarker.expose-session-attributes=true
#设置是否公开RequestContext供Spring宏库使用,名称为“SpringMacroRequestContext”。
#spring.freemarker.expose-spring-macro-helpers=true
#前缀,用于在构建URL时查看名称
#spring.freemarker.prefix=
#后缀,该后缀用于在构建URL时查看名称。
spring.freemarker.suffix=.ftl
#以逗号分隔的模板路径列表。
spring.freemarker.template-loader-path=classpath:/templates/
#可以解析的视图名称的白列表。
#spring.freemarker.view-names=
建立应用
1.在包目录下建立controller层,创建LoginController.Java
@Controller
public class LoginController {
@RequestMapping("/index")
public ModelAndView indexView() {
return new ModelAndView("index","message","Hello World!");
}
2.在resource目录下的templates(如果没有则新建)目录下新建一个index.ftl文件
3.生成的代码如下所示,并增加一条ftl表达式语句
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
${message}
</body>
</html>
4.运行SpringBoot项目,访问地址http://127.0.0.1:8080/index
可以看到,SpringBoot成功整合Freemarker。