不灭的焱

先参考文章：【Spring MVC】集成 FreeMarker ，把 FreeMarker  jar包 配置好。

1. 使用步骤

• 第一步：创建一个Configuration对象，直接new一个对象。构造方法的参数就是freemarker对应的版本号。
• 第二步：设置模板文件所在的路径。
• 第三步：设置模板文件使用的字符集。一般就是utf-8。
• 第四步：加载一个模板，创建一个模板对象。
• 第五步：创建一个模板使用的数据集，可以是pojo也可以是map，一般是Map。
• 第六步：创建一个Writer对象，一般创建一FileWriter对象，指定生成的文件名。
• 第七步：调用模板对象的process方法输出文件。
• 第八步：关闭流。

@Test  
public void makeFile() throws Exception {  
    // 第一步：创建一个Configuration对象，直接new一个对象。构造方法的参数就是freemarker对应的版本号。  
    Configuration configuration = new Configuration(Configuration.VERSION_2_3_31);  
    
    // 第二步：设置模板文件所在的路径。  
    configuration.setDirectoryForTemplateLoading(new File("D:/java/IdeaProjects/jianbao/SpringMVC-Demo/src/main/webapp/WEB-INF/view"));  
    
    // 第三步：设置模板文件使用的字符集。一般就是utf-8.  
    configuration.setDefaultEncoding("utf-8");  
    
    // 第四步：加载一个模板，创建一个模板对象。  
    Template template = configuration.getTemplate("hello.ftl");  
    
    // 第五步：创建一个模板使用的数据集，可以是pojo也可以是map。一般是Map。  
    Map<String, Object> dataModel = new HashMap<>();
    
    // 向数据集中添加数据  
    dataModel.put("hello", "this is my first freemarker test.");  
    
    // 第六步：创建一个Writer对象，一般创建一FileWriter对象，指定生成的文件名。  
    Writer out = new FileWriter(new File("D:/123/hello.html"));  
    
    // 第七步：调用模板对象的process方法输出文件。  
    template.process(dataModel, out);  
    
    // 第八步：关闭流。  
    out.close();  
 }  

2. 模板语法

(1) 访问map的key

${key}

(2) 访问pojo中的属性

Student对象。学号、姓名、年龄、

${key.property}

<ul>
    <li>取学生的信息：</li>
    <li>学号：${stu.id}</li>
    <li>姓名：${stu.name}</li>
    <li>年龄：${stu.age}</li>
</ul>

(3) 取集合中的数据

循环使用格式：

<#list 要循环的数据 as 循环后的数据>

</#list>

示例：

<ol>
    <dt>学生列表</dt>
    <#list studentList as student>
        <dd>学号：${student.id}</dd>
        <dd>姓名：${student.name}</dd>
        <dd>年龄：${student.age}</dd>
    </#list>
</ol>

ArrayList<Student> studentList = new ArrayList<>();

Student stu1 = new Student();
stu1.setId(2);
stu1.setName("张三");
stu1.setAge(19);
studentList.add(stu1);

Student stu2 = new Student();
stu2.setId(3);
stu2.setName("李四");
stu2.setAge(20);
studentList.add(stu2);

Student stu3 = new Student();
stu3.setId(4);
stu3.setName("王二");
stu3.setAge(21);
studentList.add(stu3);

dataModel.put("studentList", studentList);

(4) 取循环中的下标

<#list studentList as student>
    ${student_index}
</#list>

(5) 判断

<#if student_index % 2 == 0>

<#else>

</#if>

(6) 日期类型格式化

直接取值:${date}(date是属性名)如果传来的是一个Date型数据会报错

${birthday?date} 2016-9-13
${birthday?time} 17:53:55
${birthday?datetime} 2016-9-13 17:53:55

示例：

当前日期：${addTime?date} <br/>
当前时间：${addTime?time} <br/>
当前日期和时间：${addTime?datetime} <br/>
自定义日期格式：${addTime?string("yyyyMM/dd HH:mm:ss")} <br/>

(7) Null 值处理

如果直接取一个不存在的值（值为null）时会报异常

${aaa}

处理：${aaa!"默认值"} 或者 ${aaa!} 代表空字符串

null值处理：${myVal!"myVal为null"} <br/>
null值处理：
<#if myVal2??>
    myVal2不为空时。。。
<#else>
    myVal2为空时###
</#if>

(8) Include标签

<#include "模板名称">

<#include "hello.ftl"/>

3. 使用Spring的 FreeMarker 配置对象，生成静态页面

(1) 业务逻辑：

• 1、从spring容器中获得FreeMarkerConfigurer对象。
• 2、从FreeMarkerConfigurer对象中获得Configuration对象。
• 3、使用Configuration对象获得Template对象。
• 4、创建数据集
• 5、创建输出文件的Writer对象。
• 6、调用模板对象的process方法，生成文件。
• 7、关闭流。

(2) Java代码

package com.jianbao.controller;

import freemarker.template.Configuration;
import freemarker.template.Template;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer;

import java.io.*;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

@Controller
public class HtmlController {
    @Autowired
    private FreeMarkerConfigurer freeMarkerConfigurer;

    @GetMapping("/make_html")
    @ResponseBody
    public String makeHtml() throws Exception {
        // 1.从Spring容器中获取FreeMakerConfigurer对象。
        // 2.从FreeMarkerConfigurer对象中获取Configuration对象
        Configuration configuration = freeMarkerConfigurer.getConfiguration();

        // 3.使用Configration对象获取Template对象
        Template template = configuration.getTemplate("hello.ftl");

        // 4.创建数据集
        Map<String, Object> dataModel = new HashMap<>();
        dataModel.put("title", "用户个人信息");
        dataModel.put("userName", "温建宝");
        dataModel.put("age", 18);

        // 5.创建输出文件的Writer对象。
        Writer out = new OutputStreamWriter(new FileOutputStream("D:/123/hello.html"), StandardCharsets.UTF_8);

        // 6.调用模板对象的process()方法，生成文件。
        template.process(dataModel, out);

        // 7.关闭流
        out.close();

        return "ok";
    }
    
    @RequestMapping("/")
    @ResponseBody
    public String index() {
        return "default page";
    }
}