FreeMarker开发总结

骑猪看日落 2021-05-07 20:35 450阅读 0赞

### FreeMarker总结 ###

*   *  1.FreeMarker的定义
     *  2.FreeMarker工作原理图
     *  3.springboot工程中配置
     *  4.常用方法

## 1.FreeMarker的定义 ##

> FreeMarker是一个基于java的免费开源的模板引擎,基于文本的模板输出工具，有着丰富的表达式，还可以自定义表达式。Freemarker可以将后端准备好的数据，通过Freemarker表达式在前端页面展示出来。在软件项目中常常用来生成HTML的 Web页面，可以基于模板生成输出文件，导出复杂样式的excel。

## 2.FreeMarker工作原理图 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl8zOTAyNTM2Mg_size_16_color_FFFFFF_t_70_pic_center]

## 3.springboot工程中配置 ##

1.  添加maven依赖

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

1.  在springboot项目中的yml配置

spring:
      freemarker:
        cache: false
        suffix: .ftl
        template-loader-path: classpath:/templates
        content-type: text/html; charset=utf-8
        settings:
          number_format: 0   # 数字不进行千分位自动转换，比较大的数字会带有逗号，如1,000

## 4.常用方法 ##

在说方法前，先吐槽一下Freemarker比较恶心的地方，就是空错误，如果你页面表达式是null，就会报错，所以在使用的时候要先进行空判断，有时候页面报错就是因为这个。

1.获取元素值

<#if (msg)!="">
         ${msg}
    </#if>

2.获取map中的值

${map["name"]}

3.foreach，循环输出list，先判断是否

<#if students ?? && students ?size gt 0>
    	   <#list students as student>
    		    ${student.name}
    		    ${student.age}
    		    ${student.sex}
    	   </#list>
    </#if>

4.逻辑判断，if…else方法，  
字符串类型判断

<#if type == 1>
        type=1                                 
    <#elseif type == 2>
        type=2
    </#if>

布尔值类型判断

<#if (booleanVal?string('yes', 'no'))=='yes'>
       <span> 对 </span>
    <#else>
       <span> 错 </span>
    </#if>

多个值进行if判断

<#if flag=="1">
    	<span> 1 </span>
    <#elseif flag=="2">
    	<span> 2 </span>
    <#elseif flag=="3">
    	<span> 3 </span>
    <#else> 
    	<span> 除了1、2、3之外 </span>
    </#if>

5.获取session中的值，如后端在session中保存userId，使用Freemarker  
在session中保存userId的值

request.getSession().setAttribute("userId",userId);

在页面使用freemarker表达式，为避免userId的值是空就会报错，所以要先判断一下

<#if Session["userId"]?exists> 
    	${Session["userId"]} 
    </#if>

6.Freemarker格式化时间

// 输出时间格式 2020-05-09 13:59:32
    
    ${createTime?string('yyyy-MM-dd hh:mm:ss')}

7.使用include标签，引入其他页面  
抽出公共页面代码，取名right.ftl,如下

在需要引入该代码的页面中，使用include标签

<#include "right.ftl">

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl8zOTAyNTM2Mg_size_16_color_FFFFFF_t_70_pic_center]: /images/20210505/f758a815e4dc4b5e9a2a813b5924148f.png