本文共 1540 字，大约阅读时间需要 5 分钟。

FreeMarker技术总结

FreeMarker的定义

FreeMarker 是一个基于Java的免费开源模板引擎，专注于文本模板输出，提供丰富的表达式支持和自定义功能。它能够将后端准备好的数据通过模板引擎的表达式在前端页面展示，常用于生成复杂样式的HTML网页或导出Excel文件。

FreeMarker的工作原理

FreeMarker 的工作原理简单明了。它通过模板文件定义数据的呈现方式，将后端数据与模板结合，生成最终的输出文件。用户可以通过定义丰富的表达式来实现对数据的格式化和布局设计。

Spring Boot项目中的FreeMarker配置

在Spring Boot项目中使用FreeMarker进行渲染，需要完成以下几个步骤：

   
    
    
     org.springframework.boot
    
    
    
     spring-boot-starter-freemarker
    
   

2. 在 application.properties 文件中配置FreeMarker的相关设置：

spring.freemarker.cache=false
spring.freemarker.suffix=.ftl
spring.freemarker.template-loader-path=classpath:/templates
spring.freemarker.content-type=text/html; charset=utf-8
spring.freemarker.settings=number_format=0

常用FreeMarker方法

在实际使用过程中，FreeMarker 提供了丰富的表达式和标签，可以帮助开发者高效实现数据的显示和格式化。以下是一些常用的方法示例：

3. 获取元素值

<#if msg?="">
    <# ridiculer_gmtLegend>
        ${msg}
    
    
    

2. 获取Map中的值

${map["name"]}

3. 循环输出List数据

<#if students?exists and students?size gt 0>
    <#list students as student>
        ${student.name} - ${student.age} - ${student.sex}
    
      
      

4. 条件判断

<#if type == 1>
    类型：1
       
<#elseif type == 2>
    类型：2
       
<#else>
    类型：其它
       

5. 获取Session中的值

<#if Session["userId"]?exists>
    用户ID：${Session["userId"]}
        

6. 格式化时间

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

7. 导入公共模板

<#include "right.ftl"/>

常见问题与注意事项

8. 空错误处理：FreeMarker 在表达式中遇到空值时会报错，因此在使用时需要先进行空判断。
9. 缓存问题：默认情况下，FreeMarker 会缓存模板渲染结果，建议在开发环境中关闭缓存。
10. 数据格式化：需要谨慎处理大数值的格式化，避免出现不可预期的显示结果。

通过以上方法和配置，可以充分发挥FreeMarker 的强大功能，在项目开发中提高效率和代码质量。

转载地址：http://btdpz.baihongyu.com/