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

在当下的Web开发领域，模板引擎在前后端数据渲染中扮演着至关重要的角色。Freemarker作为一款成熟且功能强大的模板引擎，广泛应用于各类Java Web项目中。在实际业务场景里，开发者经常会遇到需要将扁平的列表数据按照特定维度进行分组展示的需求。例如，将订单按照日期分组、将员工按照部门归类，或者将商品按照类别进行划分。通过Freemarker提供的内置函数，我们可以在不改变后端原始数据结构的前提下，优雅地在模板层完成动态分组与子数据的嵌套循环渲染。

动态分组的核心机制与数据准备

Freemarker本身并没有提供类似于SQL中GROUP BY那样的专属分组指令，但它提供了一个极为强大的内置函数 ?group_by。这个函数的核心作用是根据指定的属性名，将一个序列转换成一个哈希表。在这个哈希表中，键是分组依据的属性值，而值则是具有该属性值的所有元素组成的子序列。理解这一底层转换机制，是掌握动态分组列表与子数据循环的关键所在。通过这种转换，原本一维的列表数据被重构为具有层级关系的键值对集合，为后续的嵌套渲染奠定了数据基础。

为了在模板中顺利进行分组操作，后端控制器需要传递结构清晰的列表数据。通常情况下，后端会构建一个包含多个对象的列表，每个对象都具备用于分组的公共属性。以下是一段典型的Java后端代码，展示了如何构建包含分类、品牌和名称属性的商品数据集合，并将其注入到模板的上下文中，为后续的模板渲染做好充分的数据准备。

// 后端构建商品数据列表并注入模板上下文
List<Map<String, Object>> productList = new ArrayList<>();

Map<String, Object> item1 = new HashMap<>();
item1.put("category", "电子产品");
item1.put("brand", "品牌A");
item1.put("name", "智能手机");
productList.add(item1);

Map<String, Object> item2 = new HashMap<>();
item2.put("category", "电子产品");
item2.put("brand", "品牌B");
item2.put("name", "平板电脑");
productList.add(item2);

Map<String, Object> item3 = new HashMap<>();
item3.put("category", "家用电器");
item3.put("brand", "品牌A");
item3.put("name", "空气净化器");
productList.add(item3);

// 将列表数据传递给Freemarker模板
model.addAttribute("productList", productList);

单条件与多条件分组的模板实现

在准备好基础数据后，我们就可以在Freemarker模板中利用 ?group_by 函数进行单条件分组了。具体的实现逻辑是，首先调用该函数对原始列表进行分组，得到一个哈希表结果。接着，通过遍历这个哈希表的键集合，获取每一个分组的标识。在每一次外层循环内部，再利用获取到的键去哈希表中提取对应的子数据列表，并进行内层的嵌套循环渲染。这种双层循环的结构能够完美契合前端页面中常见的分组容器与列表项的DOM结构需求，使得代码逻辑与页面结构高度一致。

然而，实际业务往往比单条件分组更为复杂。有时我们需要根据多个字段的组合来进行分组，比如同时依据商品的分类和品牌进行归类。由于 ?group_by 函数仅支持单一属性名作为参数，我们需要在分组前对数据进行预处理。可以通过遍历原始列表，为每个元素动态计算并赋值一个组合键属性，然后再基于这个新生成的组合键属性进行分组操作。这种方式虽然增加了一次前置遍历，但极大地扩展了分组的灵活性。

<h3>商品单条件分组展示</h3>
<#-- 使用内置函数按照category字段进行分组 -->
<#assign groupedData = productList?group_by("category")>

<#-- 遍历分组后的哈希表键集合 -->
<#list groupedData?keys as categoryKey>
    <div class="group-container">
        <h4>当前分类：${categoryKey}</h4>
        <ul>
            <#-- 根据键获取子列表并进行内层循环 -->
            <#list groupedData[categoryKey] as product>
                <li>商品名称：${product.name}，品牌：${product.brand}</li>
            </#list>
        </ul>
    </div>
</#list>

<h3>商品多条件组合分组展示</h3>
<#-- 遍历原始列表，动态拼接组合键 -->
<#list productList as item>
    <#assign item.compositeKey = item.category + "-" + item.brand>
</#list>

<#-- 按照新生成的组合键进行分组 -->
<#assign multiGroupedData = productList?group_by("compositeKey")>

<#list multiGroupedData?keys as compositeKey>
    <div class="multi-group-container">
        <h4>组合分类：${compositeKey}</h4>
        <ul>
            <#list multiGroupedData[compositeKey] as product>
                <li>${product.name}</li>
            </#list>
        </ul>
    </div>
</#list>

分组结果的排序与高级处理技巧

在完成基础的分组与循环渲染后，我们通常还需要对展示结果进行进一步的优化。例如，后端返回的数据顺序可能是随机的，但前端展示时往往要求分组名称按照字母或拼音顺序排列。Freemarker提供了丰富的序列处理函数，我们可以在获取分组键集合后，直接使用 ?sort 函数对键进行升序排序，从而确保渲染出的分组列表具备良好的可读性和一致性。这种在模板层直接进行排序的方式，避免了后端为了特定的展示顺序而进行额外的数据加工。

此外，在处理分组和子数据循环时，还有一些细节和注意事项需要开发者牢记。首先，传递给 ?group_by 的属性名必须在列表的每个元素中都存在，否则会引发模板解析异常，因此在数据封装阶段需保证字段的完整性。其次，如果原始列表为空，该函数会返回一个空的哈希表，此时外层循环自然不会执行，因此无需额外编写繁琐的空值判断逻辑。最后，在内层子数据循环中，若需展示序号，可借助Freemarker自动生成的索引变量来实现，这为构建带有序号的复杂列表提供了极大的便利。

<h3>分组键排序与序号展示</h3>
<#assign sortedGroupedData = productList?group_by("category")>

<#-- 对分组键进行升序排序后再遍历 -->
<#list sortedGroupedData?keys?sort as categoryKey>
    <div class="sorted-group">
        <h4>排序后分类：${categoryKey}</h4>
        <ol>
            <#-- 使用内置索引变量展示序号 -->
            <#list sortedGroupedData[categoryKey] as product>
                <li>序号 ${product_index + 1}：${product.name}</li>
            </#list>
        </ol>
    </div>
</#list>

综上所述，利用Freemarker的内置函数实现动态分组列表与子数据循环，是一种高效且优雅的模板层数据处理方案。通过合理运用数据分组、嵌套循环、多条件组合以及结果排序等技巧，开发者能够轻松应对各种复杂的列表展示需求。掌握这些核心机制与高级处理技巧，不仅能够减少后端的数据转换压力，还能显著提升模板代码的可维护性与渲染性能。在未来的项目实践中，建议大家继续深入探索Freemarker的其他内置函数，以构建更加灵活和强大的视图层逻辑。

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