Freemarker

什么是Freemarker

FreeMarker 是一种基于模板的 Java 模板引擎，通常用于生成动态网页、配置文件、电子邮件内容等。它通过将数据模型（如 Java 对象、Map、List 等）与模板相结合来生成最终的输出。FreeMarker 使用简单的语法和指令来处理动态内容，非常适合与 Java Web 应用程序结合使用。

1.概述

后端数据+模板生成一个HTML静态页面

快速入门

1.引入依赖

   <dependencies>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
       </dependency>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-freemarker</artifactId>
       </dependency>

       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-test</artifactId>
       </dependency>
       <!-- lombok -->
       <dependency>
           <groupId>org.projectlombok</groupId>
           <artifactId>lombok</artifactId>
       </dependency>

       <!-- apache 对 java io 的封装工具库 -->
       <dependency>
           <groupId>org.apache.commons</groupId>
           <artifactId>commons-io</artifactId>
           <version>1.3.2</version>
       </dependency>
   </dependencies>

2.引入类和配置文件

配置文件

server:
  port: 8881 #服务端口
spring:
  application:
    name: freemarker-demo #指定服务名
  freemarker:
    cache: false  #关闭模板缓存，方便测试
    settings:
      template_update_delay: 0 #检查模板更新延迟时间，设置为0表示立即检查，如果时间大于0会有缓存不方便进行模板测试
    suffix: .ftl               #指定Freemarker模板文件的后缀名

3.准备模板

<!DOCTYPE html>
<html>
<!-- 我是一个注释 -->
<head>
    <meta charset="utf-8">
    <title>Hello World!</title>
</head>
<body>

<#-- freemarker的注释 -->
<h1>这是 ${name} 的主页 </h1>

<h3>我的主页我做主 ${msg} </h3>

</body>
</html>

4.编写代码

5.测试

指令

1.插入表达式

普通变量

${key}

对象

${对象名.属性}

测试

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.Date;

@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class Student {
    private String name;//姓名
    private int age;//年龄
    private Date birthday;//生日
    private Float money;//钱包
}

模板

<hr>
<b>对象Student中的数据展示：</b><br/>
姓名：${stu.name}<br/>
年龄：${stu.age}
<hr>

数据

//放对象
Student student = new Student();
student.setName("李四");
student.setMoney(1111F);
student.setBirthday(new Date());
student.setAge(20);
model.addAttribute("stu",student);

遍历集合

list

测试

模板

<#-- list 数据的展示 -->
<b>展示list中的stu数据:</b>
<br>
<table>
    <tr>
        <td>序号</td>
        <td>姓名</td>
        <td>年龄</td>
        <td>钱包</td>
    </tr>
    <#list stus as stu>
        <tr>
            <td>${stu_index+1}</td>
            <td>${stu.name}</td>
            <td>${stu.age}</td>
            <td>${stu.money}</td>
        </tr>
    </#list>
</table>
<hr>

数据

        //list
        List<Student> students = new ArrayList<>();
        students.add(new Student("AA",10,new Date(),1211F));
        students.add(new Student("BB",11,new Date(),1211F));
        students.add(new Student("CC",12,new Date(),1211F));
        model.addAttribute("stus",students);

Map

1.根据key获取值

方式：map[key]
map.key

2.遍历map

3.测试

模板

<#-- Map 数据的展示 -->
<b>map数据的展示：</b>
<br/><br/>
<a href="###">方式一：通过map['keyname'].property</a><br/>
输出stu1的学生信息：<br/>
姓名：${stuMap['stu1'].name}<br/>
年龄：${stuMap['stu1'].age}<br/>
<br/>
<a href="###">方式二：通过map.keyname.property</a><br/>
输出stu2的学生信息：<br/>
姓名：${stuMap.stu2.name}<br/>
年龄：${stuMap.stu2.age}<br/>

<br/>
<a href="###">遍历map中两个学生信息：</a><br/>
<table>
    <tr>
        <td>序号</td>
        <td>姓名</td>
        <td>年龄</td>
        <td>钱包</td>
    </tr>
    <#list stuMap?keys as key >
        <tr>
            <td>${key_index + 1}</td>
            <td>${stuMap[key].name}</td>
            <td>${stuMap[key].age}</td>
            <td>${stuMap[key].money}</td>
        </tr>
    </#list>
</table>
<hr>

数据

        //map
        Map<String, Object> map = new HashMap<>();
        map.put("stu1", new Student("YYY",10,new Date(),1211F));
        map.put("stu2", new Student("ZZZ",10,new Date(),1211F));
        model.addAttribute("stuMap",map);

3.逻辑判断

    <#list stus as stu >
        <#if stu.name=='AA'>
            <tr style="color: red">
                <td>${stu_index}</td>
                <td>${stu.name}</td>
                <td>${stu.age}</td>
                <td>${stu.money}</td>
            </tr>
            <#else >
            <tr>
                <td>${stu_index}</td>
                <td>${stu.name}</td>
                <td>${stu.age}</td>
                <td>${stu.money}</td>
            </tr>
        </#if>
    </#list>