Freemarker内置函数详解

"这篇文档主要介绍了Freemarker的常用内置函数，包括Sequence、Hash以及字符串操作的相关函数。" 在Freemarker模板语言中，内置函数是开发者常常利用的工具，以便在模板中进行数据处理和格式化。以下是文档中提到的一些关键函数： ### Sequence的内置函数 1. **`?first`**：返回序列（Sequence）的第一个元素。 2. **`?last`**：返回序列的最后一个元素。 3. **`?reverse`**：反转序列的顺序，使其元素倒序排列。 4. **`?size`**：获取序列的长度，即元素数量。 5. **`?sort`**：对序列中的元素按照默认的字符串排序规则进行排序。 6. **`?sort_by(value)`**：根据提供的属性`value`对序列中的对象进行排序。 ### Hash的内置函数 1. **`?keys`**：返回Hash中的所有键（Key），返回结果是一个Sequence。 2. **`?values`**：返回Hash中的所有值，返回结果也是一个Sequence。 ### 字符串操作函数 1. **`substring(start, end)`**：从字符串中截取子串，`start`为起始位置，`end`为结束位置。 2. **`cap_first`**：将字符串的第一个单词首字母转为大写。 3. **`uncap_first`**：将字符串的第一个单词首字母转为小写。 4. **`capitalize`**：将字符串中所有单词的首字母转为大写。 5. **`date`, `time`, `datetime`**：将符合特定格式的字符串转换为日期、时间或日期时间对象。 6. **`ends_with(substring)`**：检查字符串是否以指定的子串结尾，返回布尔值。 7. **`html`**：对字符串进行HTML转义，防止XSS攻击。 8. **`index_of(substring, start)`**：查找子串在字符串中的位置，返回索引值，未找到则返回-1；`start`可指定搜索起始位置。 在实际使用中，这些函数可以帮助开发者在Freemarker模板中更灵活地处理数据，例如，根据需求对列表进行排序、筛选，或者对文本进行格式化处理。需要注意的是，当使用这些函数时，确保数据类型和函数调用方式匹配，避免出现运行时错误。此外，对于日期和时间的转换，需要确保输入的字符串符合指定的日期格式，否则可能会抛出异常。