Spring Boot入门（四）——使用模板FreeMaker
(1) freemarker介绍：
FreeMarker是一款模板引擎： 即一种基于模板和要改变的数据， 并用来生成输出文本（HTML网页、电子邮件、配置文件、源代码等）的通用工具。 它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。
(2) 新建spring-boot-freeMarker工程；
我们新建一个maven工程，取名为：spring-boot-freemarker
(3) 在pom.xml引入相关依赖；
这里使用freeMarker需要引入相关依赖包：spring-boot-starter-freemarker
1 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 2 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 3 <modelVersion>4.0.0</modelVersion> 4 5 <groupId>com.kfit</groupId> 6 <artifactId>spring-boot-velocity</artifactId> 7 <version>0.0.1-SNAPSHOT</version> 8 <packaging>jar</packaging> 9 10 <name>spring-boot-velocity</name> 11 <url>http://maven.apache.org</url> 12 13 <properties> 14 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 15 <!-- jdk版本号，angel在这里使用1.8，大家修改为大家本地配置的jdk版本号即可 --> 16 <java.version>1.8</java.version> 17 </properties> 18 19 <!-- 20 spring boot 父节点依赖, 21 引入这个之后相关的引入就不需要添加version配置， 22 spring boot会自动选择最合适的版本进行添加。 23 --> 24 <parent> 25 <groupId>org.springframework.boot</groupId> 26 <artifactId>spring-boot-starter-parent</artifactId> 27 <version>1.4.1.RELEASE</version><!-- 1.4.1.RELEASE , 1.3.3.RELEASE--> 28 </parent> 29 30 <dependencies> 31 <dependency> 32 <groupId>junit</groupId> 33 <artifactId>junit</artifactId> 34 <scope>test</scope> 35 </dependency> 36 37 <!-- spring boot web支持：mvc,aop... --> 38 <dependency> 39 <groupId>org.springframework.boot</groupId> 40 <artifactId>spring-boot-starter-web</artifactId> 41 </dependency> 42 43 <!-- 引入freeMarker的依赖包. --> 44 <dependency> 45 <groupId>org.springframework.boot</groupId> 46 <artifactId>spring-boot-starter-freemarker</artifactId> 47 </dependency> 48 49 </dependencies> 50 </project>
(4) 编写启动类；
启动类没有什么特别之处，不过多介绍，请看代码：
1 package com.kfit;
2
3 import org.springframework.boot.SpringApplication;
4 import org.springframework.boot.autoconfigure.SpringBootApplication;
5
6 @SpringBootApplication
7 public class App {
8 publicstaticvoid main(String[] args) {
9 SpringApplication.run(App.class, args);
10 }
11 }
(5) 编写模板文件hello.ftl;
编写一个hello.ftl文件，此文件的路径在src/main/resources/templates下，其中hello.ftl文件的内容如下：
1 <html>
2 <body>
3 welcome ${name} to freemarker!
4 </body>
5 </html>
(6) 编写访问类HelloController;
有了模板文件之后，我们需要有个Controller控制类，能够访问到hello.ftl文件，这里也很简单，具体看如下代码：
1 package com.kfit.demo.web;
2
3 import java.util.Map;
4
5 import org.springframework.stereotype.Controller;
6 import org.springframework.web.bind.annotation.RequestMapping;
7
8 @Controller
9 public class HelloController {
10
11 @RequestMapping("/hello")
12 public String hello(Map<String,Object> map){
13 map.put("name", "[zsliu]");
14 return "hello";
15 }
16
17 }
(7) 测试；
好了，到这里，我们就可以启动我们的程序进行测试了，访问地址：
http://127.0.0.1:8080/hello ，如果你在浏览器中看到如下信息：
welcome [zsliu] to freemarker! 那么说明你的demo ok 了。
(8) freemarker配置；
在spring boot的application.properties属性文件中为freemarker提供了一些常用的配置,如下：
1 ######################################################## 2 ###FREEMARKER (FreeMarkerAutoConfiguration) 3 ######################################################## 4 spring.freemarker.allow-request-override=false 5 spring.freemarker.cache=true 6 spring.freemarker.check-template-location=true 7 spring.freemarker.charset=UTF-8 8 spring.freemarker.content-type=text/html 9 spring.freemarker.expose-request-attributes=false 10 spring.freemarker.expose-session-attributes=false 11 spring.freemarker.expose-spring-macro-helpers=false 12 #spring.freemarker.prefix= 13 #spring.freemarker.request-context-attribute= 14 #spring.freemarker.settings.*= 15 #spring.freemarker.suffix=.ftl 16 #spring.freemarker.template-loader-path=classpath:/templates/ #comma-separated list 17 #spring.freemarker.view-names= # whitelist of view names that can be resolved
(9) freemarker常用语法；
freemarker的语法并不是本节的重点，这里还是简单的介绍下几个常用的if else,list；
首先我们改造下HelloController的hello方法
1 @RequestMapping("/hello")
2 public String hello(Map<String,Object> map){
3 map.put("name", "[zsliu]");
4 map.put("gender",1);//gender:性别，1：男；0：女；
5
6 List<Map<String,Object>> friends =new ArrayList<Map<String,Object>>();
7 Map<String,Object> friend = new HashMap<String,Object>();
8 friend.put("name", "张三");
9 friend.put("age", 20);
10 friends.add(friend);
11 friend = new HashMap<String,Object>();
12 friend.put("name", "李四");
13 friend.put("age", 22);
14 friends.add(friend);
15 map.put("friends", friends);
16 return "hello";
17 }
这里我们返回了gender和friends的列表, 接下来我们看看怎么在freemarker进行展示呢?
1 <!DOCTYPE html>
2 <html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
3 xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
4 <head>
5 <title>Hello World!</title>
6 </head>
7 <body>
8 <p>
9 welcome ${name} to freemarker!
10 </p>
11
12
13 <p>性别：
14 <#if gender==0>
15 女
16 <#elseif gender==1>
17 男
18 <#else>
19 保密
20 </#if>
21 </p>
22
23
24 <h4>我的好友：</h4>
25 <#list friends as item>
26 姓名：${item.name} , 年龄${item.age}
27 <br>
28 </#list>
29
30 </body>
31 </html>
10) freemarker layout
freemarker layout主要处理具有相同内容的页面，比如每个网站的header和footer页面。
freemarker 的布局主要常见的两种方式是#import(“文件路径”)和#include(“文件路径”)，其中import和include的区别在于，include常用于公共部分的页面，如果要使用<#assign username=“张三”>涉及到内部函数以及变量声明之类的，使用import进行导入，如果在import中的页面含有页面当前将不会进行渲染。 我们编写一个header和footer，其中的header使用include引入，footer页面也使用include引入。
header.ftl内容：
1 <header>
2 This is a header,welcome ${name} to my web site!
3 </header>
4 <hr>
footer.ftl内容：
1 <hr>
2 <footer>
3 This is a footer,welcome ${name} to my web site!
4 </footer>
修改hello.ftl：
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
<head>
<title>Hello World!</title>
</head>
<body>
<#include "/header.ftl" >
<p>
welcome ${name} to freemarker!
</p>
<p>性别：
<#if gender==0>
女
<#elseif gender==1>
男
<#else>
保密
</#if>
</p>
<h4>我的好友：</h4>
<#list friends as item>
姓名：${item.name} , 年龄${item.age}
<br>
</#list>
<#include "/footer.ftl" >
</body>
</html>
到这里就ok了，我们访问/hello页面，应该会看到修改后的效果：
END
