简介：Freemarker是一个广泛应用于Java Web开发的模板引擎，通过简单的语法控制数据模型并渲染为文本输出。本文实例详解了如何在Freemarker模板中使用 <#list> 指令遍历list集合，包括基本迭代、条件判断、索引访问、长度信息、遍历子列表、反向遍历等核心功能。掌握这些技巧可显著提升动态模板构建的灵活性和效率，并与Java后端配合实现动态页面生成。
1. Freemarker模板引擎概述
在现代Web开发中，模板引擎是构建动态网页的重要组成部分。Freemarker作为一个老牌的模板引擎，因其高性能和灵活性在Java领域得到广泛应用。它能够帮助开发者将数据与HTML或其他格式的模板文件分离，从而实现业务逻辑和展示逻辑的解耦。Freemarker的核心功能包括变量输出、控制结构（如循环和条件判断）、宏定义等，使得开发者可以更专注于业务代码的编写，而不必过多地纠缠于视图层面的细节。
接下来，我们将深入探讨Freemarker中用于数据迭代的 <#list> 指令，它是实现模板循环显示数据的关键工具。此外，本章还将介绍Freemarker的基本用法和安装配置，为后续章节的学习打下坚实的基础。通过本章的学习，读者将掌握Freemarker模板引擎的基本概念，并能够理解其在Web应用开发中的实际作用。
2. <#list> 指令基础使用方法
2.1 <#list> 指令的基本语法
2.1.1 <#list> 指令的作用和结构
在Freemarker模板中， <#list> 指令用于遍历集合（如List、Map等），是构建动态内容不可或缺的一个组件。使用 <#list> 指令可以按照指定格式输出集合中的每一个元素，并且可以对元素进行处理。
<#list> 的基本结构如下：
<#list collection as item>
<#-- 这里可以访问每个元素 item -->
其中， collection 代表要遍历的集合， as 关键字用来指定遍历时的变量名（在这个例子中是 item ）。
2.1.2 <#list> 指令的简单示例
假设我们有一个用户列表，需要输出每个用户的名字和年龄，可以使用以下的Freemarker模板代码：
<#list users as user>
用户名: ${user.name}, 年龄: ${user.age}
在这个例子中， users 是一个包含用户对象的列表， user 是 <#list> 指令定义的变量，用来代表列表中的每个用户对象，我们可以通过 ${user.name} 和 ${user.age} 访问到用户对象的属性。
2.2 <#list> 指令的遍历过程
2.2.1 遍历集合的顺序控制
通常情况下， <#list> 指令会按照集合的原始顺序进行遍历，但Freemarker也提供了几种方法来自定义遍历的顺序。
可以通过指定开始索引和结束索引来控制遍历的范围：
<#list users?sequence(start_index, end_index) as user>
${user.name}
在这里， ?sequence 是一个内建函数，允许我们指定遍历的起始索引（ start_index ）和结束索引（ end_index ），从而实现对遍历顺序的控制。
2.2.2 遍历过程中的数据处理
在遍历过程中，除了顺序控制之外，我们还可以对数据进行其他类型的处理。比如排序：
<#list users?sort_by("age") as user>
用户名: ${user.name}, 年龄: ${user.age}
这里的 ?sort_by 是一个内建函数，根据 age 属性对用户列表进行排序后再进行遍历。
2.2 <#list> 指令的遍历过程
2.2.1 遍历集合的顺序控制
要精确控制遍历的顺序，可以利用Freemarker提供的 <#if> 条件语句进行进一步的控制。例如，假设我们要在遍历过程中只输出年龄大于18岁的用户：
<#list users as user>
<#if user.age gt 18>
用户名: ${user.name}, 年龄: ${user.age}
在这里， <#if> 语句内部的 gt 是“greater than”的简写，表示“大于”的比较操作，只有当用户的年龄大于18时，才会输出该用户的姓名和年龄。
2.2.2 遍历过程中的数据处理
除了排序和条件筛选，我们还可以对遍历的数据进行过滤、分组等操作。例如，使用 ?filter 内建函数来过滤集合，只保留符合特定条件的元素：
<#list users?filter("age gt 18") as user>
用户名: ${user.name}, 年龄: ${user.age}
这个例子展示了如何使用 ?filter 函数结合条件表达式来过滤出年龄大于18岁的用户，并且在遍历时只处理这些符合条件的用户。
通过以上方式，我们可以看到 <#list> 指令在基本遍历之外还提供了一系列强大的数据处理功能，使模板的逻辑更加丰富和灵活。
flowchart TB
A[开始遍历] --> B[遍历条件判断]
B -->|条件满足| C[执行遍历中的操作]
B -->|条件不满足| D[跳过当前元素]
C --> E[是否遍历结束?]
D --> E
E -->|未结束| B
E -->|已结束| F[结束遍历]以上是一个简化的Mermaid流程图，展示了遍历过程中可能遇到的决策流程。在实际应用中，通过条件控制和数据处理，可以构建出非常复杂的遍历逻辑。
代码块展示及逻辑分析
<#list users as user>
<#if user.age gt 18>
用户名: ${user.name}, 年龄: ${user.age}
上述代码块中的逻辑分析如下：
<#list users as user>：这行代码用于遍历一个名为users的集合，并将当前遍历到的元素赋值给变量user。<#if user.age gt 18>：这是一个条件判断语句，检查当前遍历到的用户对象的age属性是否大于18。${user.name}, 年龄: ${user.age}<br/>：当条件满足时，输出当前用户的名字和年龄信息，并换行。- 每次循环迭代时，
<#list>指令自动移动到下一个元素，并重复上述过程直到集合中所有元素遍历完毕。
通过这段代码，我们可以很清晰地理解在Freemarker模板中如何控制遍历过程，并根据实际需求进行数据处理。
3. 条件判断在遍历中的应用
3.1 条件判断的基本用法
在数据展示和处理过程中，根据不同的业务需求，我们往往需要对遍历过程中的元素进行条件判断，以决定是否执行某个动作或者以何种形式展示数据。 <#if> 语句是Freemarker模板引擎提供的条件判断功能，它允许模板作者根据模板变量的值来控制内容的显示与否。
3.1.1 条件语句的结构和示例
<#if> 语句的基本结构如下：
<#if 条件表达式>
// 当条件为真时执行的代码
<#elseif 其他条件表达式>
// 当以上条件都不满足，且此条件为真时执行的代码
<#else>
// 所有条件都不满足时执行的代码
这里是一个简单的示例，展示如何在遍历列表时使用 <#if> 语句进行条件判断：
<#assign list = ["apple", "banana", "cherry"]>
<#list list as item>
Item
Is Fruit
${item}
<#if item == "apple" || item == "banana" || item == "cherry">
Yes
<#else>
No
在这个例子中，我们创建了一个包含三个水果名称的列表，并且通过 <#if> 语句判断每个条目是否为水果。如果是，则在表格中显示“Yes”，否则显示“No”。
3.1.2 条件语句在遍历中的使用
条件语句在遍历中的应用非常广泛，它不仅仅用来控制显示内容，还可以对数据进行筛选、排序等操作。例如，在处理复杂的数据结构时，我们可以根据条件语句来过滤出符合特定条件的元素：
<#assign complexList = [{name: "John", age: 30}, {name: "Jane", age: 25}, {name: "Bob", age: 40}]>
<#list complexList as item>
<#if item.age > 25>
- ${item.name}
在这个例子中，我们仅列出年龄超过25岁的人员名字。通过 <#if> 语句在 <#list> 指令内部的应用，可以实现更灵活的数据处理。
3.2 条件判断与 <#list> 指令的结合
3.2.1 条件判断在遍历中的高级应用
在复杂的业务逻辑中，可能会需要根据多个条件进行综合判断，例如在表格中，我们希望对于某些特定的条件显示不同的颜色来突出显示信息：
<#list list as item>
Item
Category
Highlight
${item.name}
${item.category}
<#if item.highlight == "high">
${item.highlight}
<#elseif item.highlight == "medium">
${item.highlight}
<#elseif item.highlight == "low">
${item.highlight}
在上述代码中，我们使用 <#if> 和 <#elseif> 来展示不同优先级条件的结果，并通过内联样式改变文本的颜色来达到高亮效果。
3.2.2 结合条件判断的遍历实例解析
让我们来看一个更复杂的例子，这个例子中将使用嵌套的 <#if> 语句来实现多条件判断：
<#assign products = [
{name: "Product1", price: 100, category: "Electronics"},
{name: "Product2", price: 50, category: "Books"},
{name: "Product3", price: 200, category: "Electronics"},
{name: "Product4", price: 30, category: "Books"}
]>
<#list products as product>
<#if product.price < 100>
<#else>
Name
Price
Category
Special Offer
${product.name}
$${product.price}
${product.category}
<#if product.category == "Electronics">
Free shipping!
<#elseif product.category == "Books">
10% off!
在这个例子中，我们定义了一个 products 列表，其中包含产品名称、价格和类别。然后使用 <#list> 语句来遍历这些产品。对于每个产品，我们根据其价格和类别来决定是否显示特殊优惠信息。如果产品是电子产品且价格小于100，则提供免费送货；如果是书籍，则提供10%的折扣。
通过这样的条件判断，我们不仅能够控制每个产品的显示方式，还能够基于产品属性提供个性化的优惠信息。这种模式在实际的电商网站模板中非常常见，能够有效地引导用户消费。
在下一章节中，我们将深入探讨索引访问技巧以及如何利用索引访问和长度信息来进一步优化我们的数据展示过程。
4. 索引访问与长度信息获取
4.1 索引访问的技巧
4.1.1 访问元素的索引方法
在使用Freemarker模板引擎进行数据展示时，除了按照遍历顺序输出集合中的元素，还常常需要通过索引直接访问元素。这在处理列表、数组等有序集合时显得尤为重要。索引访问可以让我们获取到指定位置的数据，例如获取第一个元素、最后一个元素或中间任意位置的元素。
在Freemarker中，可以使用 index 变量来访问当前 <#list> 指令处理的元素索引。默认情况下， index 变量从0开始计数。如果需要从1开始，可以通过 start 属性来设置 <#list> 指令的起始索引。
一个基本的索引访问示例如下：
<#list items as item>
${item!}
<#-- 通过index访问当前元素的索引 -->
<#-- 默认情况下，第一个元素的索引是0 -->
<#-- ${index+1} 可以得到从1开始的索引 -->
Index of this element: ${index + 1}
在上述示例中，如果 items 是一个包含多个元素的列表，那么 ${index + 1} 会输出当前元素的序号（从1开始）。
4.1.2 结合索引访问的遍历优化
结合索引访问的遍历不仅可以帮助我们访问特定位置的元素，还可以通过索引进行遍历优化。例如，某些情况下我们可能只需要遍历列表的一部分，或者是需要根据索引位置做出特定操作。
例如，如果你只对列表中的前三个元素感兴趣，可以这样写：
<#list items as item>
<#if index < 3>
${item!}
在这个示例中， <#if> 指令结合 index 变量，确保只有当元素索引小于3时才输出该元素。这样就实现了只遍历列表的前三个元素。
4.1.3 索引访问的高级技巧
除了简单的索引访问之外，索引还可以用于实现一些高级功能，如分页、随机选择元素等。
例如，创建一个简单的分页效果，可以结合索引和列表长度来实现：
<#assign pageSize = 10>
<#list items?limit(pageSize) as item>
${item!}
<#-- 获取当前元素的索引 -->
<#assign currentIndex = index>
<#-- 检查是否为当前页的最后元素 -->
<#if (currentIndex + 1) % pageSize == 0>
<#-- 输出分页信息 -->
Page ${pageNo}
<#assign pageNo = pageNo + 1> 在这个例子中，我们设置了每页显示10个元素，并通过判断当前元素是否为当前页的最后一个元素来输出分页信息。注意，这里 pageNo 是当前的页码，需要在模板中适当的位置进行初始化和更新。
4.2 获取集合长度信息
4.2.1 集合长度获取方法
在处理集合数据时，获取集合的长度是一个常用的操作，尤其是在遍历集合时，我们经常需要知道集合的总大小，以便进行循环的控制或者其他条件判断。Freemarker提供了两种方式来获取集合的长度： .size() 方法和 size 变量。
- 使用
.size()方法获取集合长度：
<#assign itemsSize = items?size>- 使用
size变量获取集合长度：
<#assign itemsSize = items?length> 在上述两个示例中， items 是我们要处理的集合变量， itemsSize 将会存储集合的长度。
4.2.2 集合长度在遍历中的应用实例
结合集合长度进行遍历可以实现很多有用的场景。例如，在模板中显示总页数，或者进行元素的分组显示。
以下是一个展示如何在遍历中利用集合长度实现分组显示的实例：
<#assign itemsSize = items?size>
<#list 0..(itemsSize?div(5)) as index>
<#-- 每5个元素分为一组 -->
Group ${index + 1}:
<#list 0..4 as offset>
<#-- 根据分组计算当前元素的索引 -->
<#assign currentIndex = index * 5 + offset>
<#if currentIndex < itemsSize>
${items[currentIndex]!}
在这个示例中，我们使用了两个嵌套的 <#list> 指令。外层列表以5为步长遍历，用于分组。内层列表遍历每组的5个元素。通过计算 currentIndex ，我们能够访问当前组的元素。这个方法可以动态地根据集合大小将数据分组，非常适用于制作分页、分组列表等需求。
通过以上示例，我们可以看到索引访问和集合长度获取在Freemarker模板中的实际应用，以及如何将这些技巧结合起来，优化模板中的数据遍历和展示逻辑。
5. 遍历复杂集合的方法
在实际开发中，我们经常会遇到需要遍历复杂集合的情况。复杂集合不仅包含基本类型，还可能嵌套有其他集合，如子列表、Map对象等。本章节将探讨如何高效遍历这些复杂集合，并对各种高级遍历技巧进行分析。
5.1 遍历子列表的技巧
5.1.1 子列表遍历的场景和方法
在处理具有多层结构的数据时，子列表的遍历变得尤为重要。例如，在处理表格数据时，每一行可能包含多个列数据，而每一列又可能是一个列表，这样就构成了一个二维列表结构。
<#list data?items as row>
<#list row?items as cell>
${cell}
在上述示例中，首先遍历外层列表 data ，其每一项 row 代表子列表，接着遍历子列表中的每一个元素 cell 。通过这种嵌套的 <#list> 指令，我们能够轻松处理和展示复杂数据结构。
5.1.2 结合子列表遍历的复杂应用
当我们需要在遍历过程中添加某些特定条件判断或数据处理时，子列表的遍历就显得更加灵活。例如，我们可能需要在遍历过程中找到最大值或最小值。
<#list data as row>
<#if row_max?? && row_max < row>
<#assign row_max = row>
在上述代码中，通过 <#if> 条件语句和 <#assign> 赋值语句，我们可以跟踪并记录遍历过程中的最大值 row_max 。
5.2 遍历Map集合的策略
5.2.1 Map集合遍历的基本方法
Map集合的遍历通常涉及键（key）和值（value）的处理。在Freemarker中，可以使用 .keys 和 .values 方法来访问Map对象的键集合和值集合。
<#list myMap?keys as key>
Key: ${key}, Value: ${myMap[key]}
这段代码展示了如何遍历Map对象的键，并通过键来访问对应的值。
5.2.2 高级Map遍历技术及其应用
在处理复杂数据时，我们可能需要按照某种条件筛选Map中的数据，或者需要将Map数据进行排序。
<#list myMap?keys?sort as key>
${key}: ${myMap[key]}
上述代码使用了 ?sort 过滤器来对键进行排序，这样我们就可以按照键的字母顺序来展示Map中的数据。
5.3 反向遍历List集合的实现
5.3.1 反向遍历List集合的需求和方法
在某些场景下，我们需要从后向前遍历List集合。例如，在生成报表时，我们希望从最新的数据开始展示。
<#list data?reverse as item>
${item}
这段代码通过在 <#list> 指令后加上 ?reverse 过滤器，实现了List集合的反向遍历。
5.3.2 反向遍历的应用实例与分析
反向遍历尤其适用于日志分析、历史记录查看等场景。例如，在一个聊天室的日志中，最新的消息往往是最需要关注的。
<#-- 假设myLogList是按时间戳排序的日志列表 -->
<#list myLogList?reverse as logEntry>
Time: ${logEntry.time}, Message: ${logEntry.message}
通过上述反向遍历代码，我们能够快速地展示最新的聊天记录，从而提高用户体验。
以上就是遍历复杂集合的方法。通过掌握Freemarker模板引擎对各种数据结构的遍历技巧，开发者能够更有效地处理复杂的数据展示需求。在接下来的章节中，我们将进一步探讨如何优化Freemarker模板的性能以及如何处理异常情况。
简介：Freemarker是一个广泛应用于Java Web开发的模板引擎，通过简单的语法控制数据模型并渲染为文本输出。本文实例详解了如何在Freemarker模板中使用 <#list> 指令遍历list集合，包括基本迭代、条件判断、索引访问、长度信息、遍历子列表、反向遍历等核心功能。掌握这些技巧可显著提升动态模板构建的灵活性和效率，并与Java后端配合实现动态页面生成。
浙公网安备 33010602011771号