FreeMarker笔记

已于 2023-03-20 18:34:45 修改
阅读量85 收藏 1
点赞数 1
分类专栏： 笔记 Java 框架 文章标签： java servlet spring
于 2023-02-26 21:08:11 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_45783700/article/details/129231650
版权
笔记 同时被 3 个专栏收录
56 篇文章 1 订阅
订阅专栏
Java
7 篇文章 0 订阅
订阅专栏
框架
4 篇文章 0 订阅
订阅专栏

FreeMarker

FreeMarker是一个模板引擎，就是一种基于模板和要改变的数据，并用来生成输出文本(HTML网页、配置文件、电子邮件等)的通用工具，是一个Java类库，是一个可以嵌入到开发项目中的一个组件

常见的模板引擎还有:

  • JSP: Servlet专用，不能单独使用
  • Thymeleaf: 新技术，功能强大，执行的效率比较低
  • Velocity: 很久没有更新，SpringBoot官方在1.4版本后也不再对其进行支持

入门案例

  • 准备阶段:
  1. 导入依赖
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

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

<!-- freemarker起步依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
  1. 配置FreeMarker
server:
  port: 8899
spring:
  application:
    name: freemarker-demo
  freemarker:
    template-loader-path: classpath:/templates/ # freemarker模板的路径，默认就是classpath:/templates/ 在resources目录下创建templates
    suffix: .ftl  # freemarker模板文件后缀，默认是ftlh

  1. 准备模板

    在resources/templates目录下新建模板文件，例(00-basic.ftl):

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Hello World!</title>
</head>
<body>
<b>普通文本 String 展示：</b><br><br>
Hello ${name} <br>
<hr>
<b>对象Student中的数据展示：</b><br/>
姓名：${stu.name}<br/>
年龄：${stu.age}
<hr>
</body>
</html>
  • 方式1

  1. 后端控制器

    先准备个实体类:

    @Data
public class Student {
    private String name;
    private String age;
    private float money;
    private Date birthDay;
}

    准备Controller:

    @Controller // 因为返回的是一种字符串，不能返回json，不能用RestController
public class HelloController {

    @GetMapping("/basic")
    public String hello(Model model) {
        model.addAttribute("name", "freemarker");

        Student student = new Student();
        student.setName("XLrong");
        student.setAge("23");
        student.setMoney(123.45F);

        model.addAttribute("stu", student);

        return "00-basic";
    }
}

  2. 测试

    浏览器搜索: http://localhost:8899/basic，显示:

在这里插入图片描述

  • 方式2

  1. 编写测试用例

    @SpringBootTest(classes = FreeMarkerApp.class)
@RunWith(SpringRunner.class)
public class FreeMarkerTest {
    @Autowired
    Configuration configuration;    // 和FreeMarker相关的包下

    @Test
    public void freeMarkerTest() throws IOException, TemplateException {
        // 1. 获取模板
        Template template = configuration.getTemplate("00-basic.ftl");

        HashMap<String, Object> map = new HashMap<>();
        map.put("name", "freemarker way2");

        Student student = new Student();
        student.setName("XLrong way2");
        student.setAge("23 way2");
        student.setMoney(111.11F);

        map.put("stu", student);

        // 2. 静态化
        // 输出文件到什么地方
        template.process(map, new FileWriter("D:/00-basic.html"));
    }
}
    1. 测试

    本地磁盘中有文件生成

    在这里插入图片描述

    打开html文件

    在这里插入图片描述

FreeMarker语法

基本语法种类

  • 注释: <#-- -->，介于其之间的内容会被FreeMarker忽略

    <#-- This is a FreeMarker ex -->

  • 插值: ${...}，FreeMarker会用真实的值代替${...}，只使用插值，不做其他处理，但不传数据或者传空数据进，会报错

    ${name}

  • FTL指令: 和HTML标记类似，名字前加#予以区分，FreeMarker会解析标签中的表达式或逻辑

    <#>FTL指令</#>

  • 文本: 仅文本信息，这些不是FreeMarker的注释、插值、FTL指令的内容会被FreeMarker忽略解析，直接输出内容

    <#-- 普通文本 -->
普通文本

  • 定义一个变量:

    <#assign text="{'name':'XLrong','age':'23'}" />
集合指令
  • 后端代码:
@GetMapping("/list")
public String list(Model model){

    //------------------------------------
    Student stu1 = new Student();
    stu1.setName("小强");
    stu1.setAge(18);
    stu1.setMoney(1000.86f);
    stu1.setBirthday(new Date());

    //小红对象模型数据
    Student stu2 = new Student();
    stu2.setName("小红");
    stu2.setMoney(200.1f);
    stu2.setAge(19);

    //将两个对象模型数据存放到List集合中
    List<Student> stus = new ArrayList<>();
    stus.add(stu1);
    stus.add(stu2);

    //向model中存放List集合数据
    model.addAttribute("stus",stus);

    //------------------------------------

    //创建Map数据
    HashMap<String,Student> stuMap = new HashMap<>();
    stuMap.put("stu1",stu1);
    stuMap.put("stu2",stu2);
    // 3.1 向model中存放Map数据
    model.addAttribute("stuMap", stuMap);

    return "02-list";
}
  • FTL模板:
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Hello World!</title>
</head>
<body>
    
<#-- list 数据的展示 -->
<b>展示list中的stu数据:</b>
<br>
<br>
<table>
    <tr>
        <td>序号</td>
        <td>姓名</td>
        <td>年龄</td>
        <td>钱包</td>
    </tr>
    <#list stus as stu>
        <tr>
            <#-- key_indes 表示该对象的下标，从零开始 -->
            <td>${stu_index+1}</td>
            <td>${stu.name}</td>
            <td>${stu.age}</td>
            <td>${stu.money}</td>
        </tr>
    </#list>

</table>
<hr>
    
<#-- 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}</td>
            <td>${stuMap[key].name}</td>
            <td>${stuMap[key].age}</td>
            <td>${stuMap[key].money}</td>
        </tr>
    </#list>
</table>
<hr>
 
</body>
</html>
if指令

判断指令，常用的FTL指令，FreeMarker在解析时遇到if会进行判断，条件为真时输出if中的内容，否则会跳过内容不再输出

指令格式:

<#if></if>

<#-- 实例 -->
<#if 条件1>
<#elseif 条件2>
<#elseif 条件3>
<#else>
<#/if>
运算符
  • 加法： +
  • 减法： -
  • 乘法： *
  • 除法： /
  • 求模 (求余)： %

例:

<b>算数运算符</b>
<br/><br/>
    100+5 运算：  ${100 + 5}<br/>
    100 - 5 * 5运算：${100 - 5 * 5}<br/>
    5 / 2运算：${5 / 2}<br/>
    12 % 10运算：${12 % 10}<br/>
<hr>
比较运算符
  • =或者==:判断两个值是否相等.
  • !=:判断两个值是否不等.
  • >或者gt:判断左边值是否大于右边值
  • >=或者gte:判断左边值是否大于等于右边值
  • <或者lt:判断左边值是否小于右边值
  • <=或者lte:判断左边值是否小于等于右边值

FTL模板:

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Hello World!</title>
</head>
<body>

    <b>比较运算符</b>
    <br/>
    <br/>

    <dl>
        <dt> =/== 和 != 比较：</dt>
        <dd>
            <#if "xiaoming" == "xiaoming">
                字符串的比较 "xiaoming" == "xiaoming"
            </#if>
        </dd>
        <dd>
            <#if 10 != 100>
                数值的比较 10 != 100
            </#if>
        </dd>
    </dl>



    <dl>
        <dt>其他比较</dt>
        <dd>
            <#if 10 gt 5 >
                形式一：使用特殊字符比较数值 10 gt 5
            </#if>
        </dd>
        <dd>
            <#-- 日期的比较需要通过?date将属性转为data类型才能进行比较 -->
            <#if (date1?date >= date2?date)>
                形式二：使用括号形式比较时间 date1?date >= date2?date
            </#if>
        </dd>
    </dl>

    <br/>
<hr>
</body>
</html>

注:

  • =和!=可以用于字符串、数值和日期来比较是否相等
  • =和!=两边必须是相同类型的值,否则会产生错误
  • 字符串 "x" 、"x " 、**"X"**比较是不等的.因为FreeMarker是精确比较
  • 其它的运行符可以作用于数字和日期,但不能作用于字符串
  • 使用**gt等字母运算符代替>会有更好的效果,因为 FreeMarker会把>**解释成FTL标签的结束字符
  • 可以使用括号来避免这种情况,如:<#if (x>y)>
逻辑运算符
  • 逻辑与:&&
  • 逻辑或:||
  • 逻辑非:!

注: 逻辑运算符只能作用于布尔类型，否则会报错

FTL模板:

<b>逻辑运算符</b>
    <br/>
    <br/>
    <#if (10 lt 12 )&&( 10  gt  5 )  >
        (10 lt 12 )&&( 10  gt  5 )  显示为 true
    </#if>
    <br/>
    <br/>
    <#if !false>
        false 取反为true
    </#if>
<hr>
空值处理
  • 判断某变量是否存在时使用??
    <#if stus??>
    <#list stus as stu>
    	......
    </#list>
    </#if>
  • 缺失变量默认值使用!
<#-- 如果name为空则赋空字符串 -->
${name!''}

​ 如果是嵌套对象则建议使用()括起来

${(stu.bestFriend.name)!''}
内建函数

基础语法: 变量 ? 函数名称

  • 得到某个集合的大小: ${集合名?size}

  • 日期格式化

    • 显示年月日: ${today?date}
    • 显示时分秒：${today?time}
    • 显示日期+时间：${today?datetime}
    • 自定义格式化： ${today?string("yyyy年MM月")}

  • FreeMarker显示数字类型是会将数字以三位字符用逗号隔开，使用内建函数c可以将数字型转换为字符串类型: ${point?c}

  • 将字符串转换为对象:

    <#assign text="{'name':'XLrong','age':'23'}" />
<#assign data=text?eval />
XLrong2000
关注
  • 1
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
FreeMarker笔记整理
qq_43524048的博客
04-12 341
FreeMarkerFreeMarker环境搭建FreeMarker数据类型布尔型日期型数值型字符串类型字符串空值处理sequence类型（序列类型）hash类型FreeMarKer常用指令自定义变量的指令 assign逻辑判断指令 if elseif elselist指令自定义指令 macro占位置零nested导入指令import包含指令include案例FreeMarker页面静态化FreeMarker运算符FreeMarker学习资源 FreeMarker环境搭建 新建一个maven项目 在pom
freemarker笔记
12-05
freemaerker前端开发，个人参考别人的东西做的笔记，今天因为要c币，所有上传上来，有需要的可以看下
Freemarker笔记
IT__LS的博客
06-23 132
1. 页面静态化介绍 我们需要思考一个问题，就是对于页面来说，每次用户访问这页面都需要查询数据库获取动态数据进行展示，而且这页面的访问量是比较大的，这就对数据库造成了很大的访问压力，并且数据库中的数据变化频 率并不高。那我们需要通过什么方法为数据库减压并提高系统运行性能呢？答案就是页面静态化。页面静态化其实就是将原来的动态网页(例如通过ajax请求动态获取数据库中的数据并展示的网页)改为 通过静态化技术生成的静态网页，这样用户在访问网页时，服务器直接给用户响应静态html页面，没有 了动态查询数据库的过
freemarker笔记复盘
ITMAN009的博客
03-13 186
freemarker map 遍历 空格消除
freemarker 笔记
catandjava的专栏
09-07 924
1.加减乘除发 每次加1 获得的结果：1 ，2 ， 3 ，4 ，5 ... 每次减1 获得的结果：4 ，3 ，2 ，1 ，0 对2求余 class="split_line"class="noma" (inCount*2) 2.list 遍历指点条数 取前3条 ${g.name} 或者 ${g.name}
FreeMarker笔记1
08-08
=2：按索引3：|| &&例子8： #else例子9： 时间格式例子10：null处理提示方式一：提示方式二：提示方式三：例子11：宏定义1:2：（扩展）Fr
jar包增量更新分析
junlaiyan的专栏
05-16 253
借助jdeps分析出jar包的增量文件
java实现拼图小游戏
monkey108的博客
05-16 617
本文主要提供用java实现的拼图小游戏源代码。
c【语言】了解指针，爱上指针（1）
yzqy_的博客
05-16 902
在计算机中，数据是存储在内存中的，cpu从内存中读取数据，为了方便读取数据，内存又被划分为了一个个的内存单元，一个内存单元的大小就是一字节，一字节等于8bit位，我们给内存进行编号，这个编号就是地址，在c语言中给这个地址起了个名字。是的，亲爱的读者你肯定发现了，&a、p和pc输出的地址是一样的,但&a+1与p+1输出的地址是一样的00EFF940，一次都跳过了4字节，而pc+1输出的却是00EFF93D，一次只跳过一个字节。但是硬件与硬件之间是相互独立的，这该如何实现数据传输呢？”答案当然是否定的。
命令执行漏洞（二）
XLbb的博客
05-15 904
POST方法，S2-045-bypass-2漏洞存在！,程序更改为S2-045-bypass-2漏洞测试模式, 响应码: 200。POST方法，S2-046-bypass漏洞存在！POST方法，S2-045-bypass漏洞存在！POST方法，S2-046-1漏洞存在！POST方法，S2-046-2漏洞存在！POST方法，S2-046-3漏洞存在！POST方法，S2-045-1漏洞存在！POST方法，S2-045-3漏洞存在！POST方法，S2-045-2漏洞存在！POST方法，S2-045-4漏洞存在！
java数据结构与算法(验证二叉搜索树)
磐门的博客
05-17 247
节点返回空为ture,节点的值不在对应数据大小范围内返回false。将验证二叉搜索树计算同样可以转换为相同子问题，所以比较适合用递归。node为root的左节点时，max更新为root.val。node为root的右节点时，min更新为root.val。
Kubernetes 审计日志采集与分析最佳实践
观测云的博客
05-17 1021
​Kubernetes 在 1.7 版本中发布了审计（Audit）日志功能，通过审计日志，我们能够非常清晰的知道 K8S 集群到底发生了什么事情。
java导出excel动态加载多sheet多复杂表头
weixin_43931108的博客
05-14 249
java导出excel动态加载多sheet多复杂表头
解决 SpringBoot 的 Date、LocalDateTime 变成时间戳和数组的问题，创建自定义对象消息转换器
最新发布
shijialeya
05-18 378
解决 SpringBoot 的 Date、LocalDateTime 变成时间戳和数组的问题，创建自定义对象消息转换器进行数据格式化。
Android Model引入其他aar包 导致无法打包成aar
qq_27400335的博客
05-16 342
Android Model引入其他aar包 导致无法打包成aar
SpringBoot事件发布与监听，观察者模式使用
小哇
05-16 215
可以发现，用户注册与信息推送强耦合，用户注册其实到存库成功，就已经算是完成了，后面的信息推送都是额外的操作，甚至信息推送失败报错，还会影响API接口的结果，如果在同一事务，报错信息不捕获，还会导致事务回滚，存库失败。本文记录springboot使用@EventListener监听事件、ApplicationEventPublisher.publishEvent发布事件实现业务解耦。
freemarker
07-27
虽然FreeMarker具有一些编程能力，但通常由Java程序准备要显示的数据，然后由FreeMarker生成页面。它不是一个Web应用框架，而是适合作为Web应用框架的一个组件。FreeMarker与容器无关，可以应用于非Web应用程序环境...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值