SpringBoot集成Freemarker模板技术

    FreeMarker 是一款 模板引擎： 即一种基于模板和要改变的数据，并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。
　　模板编写为FreeMarker Template Language (FTL)。它是简单的，专用的语言。该意味着要准备数据在真实编程语言中来显示，比如数据库查询和业务运算，之后模板显示已经准备好的数据。在模板中，你可以专注于如何展现数据，而在模板之外可以专注于要展示什么数据。
　　Freemarker的作用主要是将动态页面转换成微静态html页面，提高搜索引擎的收录。具体框架的介绍和用法可参考http://freemarker.foofun.cn。
　　SpringBoot框架提供了对Freemarker框架的集成操作，具体操作如下：
1. 加入额外的pom依赖：

<!-- Spring Boot Freemarker 模板 依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

完整pom.xml:

<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.sqy.package</groupId>
    <artifactId>spFreemarker</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.4.RELEASE</version>
        <relativePath /> <!-- lookup parent from repository -->
    </parent>
    <!-- 项目设置:编码格式UTF-8 -->
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <!--单元测试依赖 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>
        <!-- Spring Boot SpringMVC框架依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- Spring Boot 测试依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- 热部署 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <optional>true</optional>
            <!-- optional=true,依赖不会传递，该项目依赖devtools；之后依赖myboot项目的项目如果想要使用 devtools，需要重新引入 -->
            <scope>true</scope><!-- 热部署 -->
        </dependency>
        <!-- Spring Boot Freemarker 模板 依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-freemarker</artifactId>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <!-- SpringBoot插件 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
        <!-- SpringBoot项目打包jar名称 -->
        <finalName>demo</finalName>
    </build>
</project>

2.在application.properties配置freemarker配置或者使用默认模板位置/src/main/resources/templates/及默认后缀 .ftl 。

## Freemarker 配置
## 自定义模板文件配置路径 默认模板路径在resources/templates下,默认后缀.ftl
##spring.freemarker.template-loader-path=classpath:/web/
##spring.freemarker.cache=false
##spring.freemarker.charset=UTF-8
##spring.freemarker.check-template-location=true
##spring.freemarker.content-type=text/html
##spring.freemarker.expose-request-attributes=true
##spring.freemarker.expose-session-attributes=true
##spring.freemarker.request-context-attribute=request
##spring.freemarker.suffix=.ftl

3. 创建启动类。

package com.sqy.start;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Start {
    public static void main(String[] args) {
        SpringApplication.run(Start.class, args);
    }
}

4.创建Controller

package com.sqy.start.controller;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class StartController {
    @RequestMapping("/freeMarker")
    public String freeMarker(Map<String, Object> map) {
        map.put("name", "Joe");
        map.put("sex", 1);
        
        List<Map<String, Object>> friends = new ArrayList<Map<String,Object>>();
        Map<String, Object> friend = new HashMap<String, Object>();
        friend.put("name", "Jack");
        friend.put("age", 22);
        friends.add(friend);
        friend = new HashMap<String, Object>();
        friend.put("name", "Tom");
        friend.put("age", 21);
        friends.add(friend);
        map.put("friends", friends);
        return "freeMarker";
    }
}

5. 在templates文件夹下创建freemarker.flt文件，内容如下：

<!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>
　　<center>
　　　　<p>
　　　　　　welcome ${name} to freemarker!
　　　　</p>
　　　　<p>性别：
　　　　　　<#if sex==0>
　　　　　　　　女
15　　　　　　 <#elseif sex==1>
16　　　　　　　　 男
　　　　　　<#else>
18　　　　　　　　 保密
　　　　　　</#if>
　　　　</p>
　　　　<h4>我的好友：</h4>
　　　　<#list friends as item>
　　　　　　姓名：${item.name} , 年龄${item.age}
　　　　　　<br>
　　　　</#list>
　　</center>
</body>
</html>

6.启动项目

7.在浏览器中输入localhost:8080/freemarker，运行效果如下：