Freemarker中如何实现动态分组列表与子数据循环

在Freemarker模板开发中，动态分组列表与子数据循环是处理复杂数据展示的常见需求，比如将商品按照分类分组后展示每组下的商品列表，或者将用户按照部门分组后展示每个部门的成员信息。这种场景下不需要修改后端返回的原始数据，仅通过Freemarker的模板语法就能完成分组和循环逻辑。

核心实现思路

Freemarker本身没有内置的直接分组指令，但可以通过?group_by内置函数配合循环指令实现动态分组。核心逻辑是先使用?group_by按照指定字段对原始列表进行分组，得到分组后的键值对集合，然后遍历这个集合获取每个分组的键和对应的子数据列表，最后对子数据列表进行循环渲染。

基础数据准备

假设后端传递给模板的数据是一个商品列表，每个商品包含分类名称和商品名称两个属性，数据结构如下：

// 后端传递的数据结构示例
List<Map<String, Object>> productList = new ArrayList<>();
Map<String, Object> product1 = new HashMap<>();
product1.put("category", "数码产品");
product1.put("name", "无线耳机");
productList.add(product1);

Map<String, Object> product2 = new HashMap<>();
product2.put("category", "数码产品");
product2.put("name", "移动电源");
productList.add(product2);

Map<String, Object> product3 = new HashMap<>();
product3.put("category", "家居用品");
product3.put("name", "收纳箱");
productList.add(product3);

Map<String, Object> product4 = new HashMap<>();
product4.put("category", "家居用品");
product4.put("name", "台灯");
productList.add(product4);

// 将数据放入模板上下文
model.addAttribute("products", productList);

分组与子数据循环实现

使用?group_by函数按照category字段对商品列表进行分组，然后遍历分组结果即可实现动态分组和子数据循环：

<h3>商品分组列表</h3>
<#-- 按照category字段对商品列表进行分组 -->
<#assign groupedProducts = products?group_by("category")>
<#-- 遍历分组后的结果，groupKey是分组键，groupItems是对应的子数据列表 -->
<#list groupedProducts?keys as groupKey>
    <div class="group-item">
        <h4>分组：${groupKey}</h4>
        <ul>
            <#-- 遍历当前分组下的子数据 -->
            <#list groupedProducts[groupKey] as product>
                <li>商品名称：${product.name}</li>
            </#list>
        </ul>
    </div>
</#list>

多条件动态分组实现

如果需要按照多个条件组合分组，比如同时按照分类和品牌分组，可以先对原始数据进行处理，拼接组合字段后再分组：

<#-- 先给每个商品添加组合分组字段 -->
<#list products as product>
    <#assign product.combineKey = product.category + "_" + product.brand>
</#list>
<#-- 按照组合字段分组 -->
<#assign multiGrouped = products?group_by("combineKey")>
<#list multiGrouped?keys as groupKey>
    <div class="multi-group">
        <h4>分组标识：${groupKey}</h4>
        <ul>
            <#list multiGrouped[groupKey] as item>
                <li>${item.category} - ${item.brand} - ${item.name}</li>
            </#list>
        </ul>
    </div>
</#list>

注意事项

• ?group_by函数的参数必须是原始列表中每个元素都存在的属性名，否则会抛出异常。
• 分组后的结果是一个哈希表，遍历键的时候使用?keys指令，获取对应子列表的时候用分组结果[键名]的语法。
• 如果原始列表为空，?group_by会返回空哈希表，循环的时候不会执行任何内容，不需要额外做空判断。
• 子数据循环的时候如果需要获取索引，可以使用product_index变量，比如${product_index + 1}获取从1开始的序号。

常见场景扩展

如果需要对分组后的结果进行排序，比如按照分组名称升序排列，可以在遍历前对键列表进行排序：

<#-- 对分组键进行排序后再遍历 -->
<#list groupedProducts?keys?sort as groupKey>
    <div class="sorted-group">
        <h4>排序后分组：${groupKey}</h4>
        <ul>
            <#list groupedProducts[groupKey] as product>
                <li>${product.name}</li>
            </#list>
        </ul>
    </div>
</#list>

Freemarker动态分组列表循环子数据遍历修改时间：2026-06-18 07:39:39