Freemarker 中的条件判断和循环结构

发布时间: 2023-12-15 20:47:57 阅读量: 320 订阅数: 24
# 1. 引言 ## 1.1 什么是Freemarker Freemarker是一个用Java语言编写的模板引擎,它以模板和数据为基础,生成输出文本。它的主要用途是生成HTML网页,通常与MVC(Model-View-Controller)架构一起使用。 ## 1.2 Freemarker的作用及优势 Freemarker的作用是通过模板将业务数据和展示内容分离,使得前端开发人员可以专注于页面的布局和样式,后端开发人员可以专注于业务数据的处理。Freemarker的优势包括: - **分离数据与展示**:模板和数据分离,可以让后端和前端开发并行工作。 - **可扩展性强**:支持自定义指令和函数,可根据实际需求进行扩展。 - **易学易用**:语法简单,上手快速,支持多种数据结构的处理。 - **模板重用**:支持模板的包含和引用,可以实现模板的复用。 ## 2. 条件判断 在Freemarker中,条件判断是一种常见的操作,它可以根据不同的条件执行不同的代码块。下面我们将介绍条件判断的基本用法。 ### 2.1 if语句的使用 if语句是最常见的条件判断语句之一,它用来判断一个条件是否为真,如果条件成立,则执行相应的代码块。下面是一个使用if语句的示例: ```java <#if condition> <!-- code block 1 --> <#elseif condition2> <!-- code block 2 --> <#else> <!-- code block 3 --> </#if> ``` 在上述示例中,`condition` 和 `condition2` 是不同的条件表达式,`<!-- code block 1 -->` 是当 `condition` 为真时要执行的代码块,`<!-- code block 2 -->` 是当 `condition2` 为真时要执行的代码块,`<!-- code block 3 -->`是当以上条件均不满足时要执行的代码块。 ### 2.2 if-else语句的用法 if-else语句是if语句的扩展,它可以在条件不满足时执行另外一段代码。下面是一个使用if-else语句的示例: ```java <#if condition> <!-- code block 1 --> <#else> <!-- code block 2 --> </#if> ``` 在上述示例中,`condition` 是一个条件表达式,`<!-- code block 1 -->` 是当 `condition` 为真时要执行的代码块,`<!-- code block 2 -->` 是当 `condition` 不满足时要执行的代码块。 ### 2.3 switch语句的应用 除了if语句,Freemarker还支持使用switch语句进行条件判断。switch语句根据给定的值匹配不同的case,并执行相应的代码块。下面是一个使用switch语句的示例: ```java <#switch variable> <#case case1> <!-- code block 1 --> <#case case2> <!-- code block 2 --> <#default> <!-- code block 3 --> </#switch> ``` 在上述示例中,`variable` 是要进行匹配的变量,`case1` 和 `case2` 是不同的匹配值,`<!-- code block 1 -->` 是当 `variable` 等于 `case1` 时要执行的代码块,`<!-- code block 2 -->` 是当 `variable` 等于 `case2` 时要执行的代码块,`<!-- code block 3 -->`是当以上条件均不满足时要执行的代码块。 通过上述示例,我们可以看出,在Freemarker中,通过条件判断语句可以根据不同的条件来执行不同的代码,从而实现更加灵活的逻辑控制。 # 3. 循环结构 在Freemarker中,循环结构用于对数据集合进行遍历和处理,方便我们对数据进行操作和展示。本章将介绍Freemarker中循环结构的基本用法以及一些高级应用。 ## 3.1 for循环的基本使用 在Freemarker中,我们可以使用for循环对一个数据集合进行遍历。下面是一个简单的for循环的示例代码: ```java <#list list as item> ${item} </#list> ``` - `list` 是需要遍历的数据集合,可以是一个数组、一个集合或者一个Map; - `item` 是每次循环中取出的数据项,可以用来输出或者进行其他操作。 例如,我们有一个数字数组 `[1, 2, 3, 4, 5]`,我们可以使用for循环将数组中的每个元素输出: ```java <#list [1, 2, 3, 4, 5] as num> ${num} </#list> ``` 运行结果如下: ``` 1 2 3 4 5 ``` ## 3.2 嵌套循环实现复杂数据结构的遍历 在某些情况下,我们可能需要对一个复杂的数据结构进行遍历,比如一个二维数组或者一个嵌套的集合。Freemarker提供了嵌套循环的功能,可以很方便地遍历这些复杂的数据结构。 下面是一个嵌套循环的示例代码,我们有一个二维数组 `[[1, 2, 3], [4, 5, 6], [7, 8, 9]]`: ```java <#list [[1, 2, 3], [4, 5, 6], [7, 8, 9]] as row> <#list row as num> ${num} </#list> </#list> ``` 运行结果如下: ``` 123456789 ``` 通过嵌套循环,我们将二维数组展开成了一维的数据输出。 ## 3.3 foreach循环的应用 Freemarker还提供了一个更简洁的循环结构 `foreach`,特别适用于对集合进行遍历。 下面是一个使用 `foreach` 循环遍历集合的示例代码: ```java <#assign list = [1, 2, 3, 4, 5]> <#foreach item in list> ${item} </#foreach> ``` 运行结果与之前的示例相同: ``` 1 2 3 4 5 ``` `foreach` 循环需要使用 `assign` 指令先进行赋值,然后在循环体内使用 `item` 变量进行输出或操作。 ## 3.4 总结 本章介绍了Freemarker中循环结构的基本用法以及嵌套循环和 `foreach` 循环的应用。通过这些循环结构,我们可以方便地对数据集合进行遍历和处理,实现灵活多样的数据展示和操作。 ### 4. 条件判断和循环结构的高级应用 在前面的章节中,我们已经了解了Freemarker中条件判断和循环结构的基本用法。接下来,我们将探讨一些高级应用,包括条件判断与循环的混合应用以及如何利用它们实现数据展示和处理的功能。 #### 4.1 条件判断与循环结构的混合应用 在实际开发中,我们经常会遇到需要根据不同条件判断进行不同操作的情况,同时可能还需要套用循环结构对一组数据进行处理。Freemarker提供了灵活的语法支持,可以很方便地实现条件判断与循环结构的混合应用。 例如,我们有一个学生成绩列表,需要根据每个学生的成绩进行分类,并计算每个分类的平均成绩。下面是一个示例的数据结构: ```java Map<String, List<Integer>> scores = new HashMap<>(); scores.put("语文", Arrays.asList(85, 90, 75)); scores.put("数学", Arrays.asList(80, 95, 70)); scores.put("英语", Arrays.asList(90, 85, 80)); ``` 我们可以使用条件判断和循环结构来完成这个需求,代码示例如下: ```freemarker <#assign subjects = scores?keys> <#list subjects as subject> <h2>${subject}</h2> <table> <tr> <th>学生名字</th> <th>成绩</th> </tr> <#list scores[subject] as score> <tr> <td>${score.studentName}</td> <td>${score.score}</td> </tr> </#list> </table> <p>平均成绩:${(scores[subject]?seq_sum) / (scores[subject]?size)}</p> </#list> ``` 在上述示例中,我们首先通过`scores?keys`获取所有科目名称,然后使用`<#list>`指令遍历每个科目。在每个科目下,我们使用嵌套的`<#list>`指令遍历对应科目的成绩列表,并展示学生的姓名和成绩。 最后,我们使用`?seq_sum`获取成绩列表的总和,使用`?size`获取成绩列表的长度,从而计算出平均成绩。 #### 4.2 利用条件判断和循环结构实现数据展示和处理 条件判断和循环结构在实际应用中经常用于数据展示和处理。下面我们通过一个示例来说明如何利用这两者实现特定功能。 假设我们有一个员工列表,每个员工有姓名、年龄和职务三个属性。我们需要在页面中展示每个部门的员工列表,并统计出每个部门的员工数量。 ```java Map<String, List<Employee>> employeesByDepartment = new HashMap<>(); List<Employee> devDepartment = Arrays.asList( new Employee("John", 28, "Engineer"), new Employee("Alice", 26, "Engineer") ); List<Employee> hrDepartment = Arrays.asList( new Employee("Mike", 30, "HR Specialist"), new Employee("Emily", 29, "HR Specialist"), new Employee("David", 27, "HR Specialist") ); employeesByDepartment.put("Development", devDepartment); employeesByDepartment.put("HR", hrDepartment); ``` 使用Freemarker,我们可以通过如下代码实现该功能: ```freemarker <#assign departments = employeesByDepartment?keys> <#list departments as department> <h2>${department}</h2> <ul> <#list employeesByDepartment[department] as employee> <li>${employee.name},${employee.age}岁,职务:${employee.title}</li> </#list> </ul> <p>员工数量:${employeesByDepartment[department]?size}</p> </#list> ``` 在上述示例中,首先通过`employeesByDepartment?keys`获取所有部门的名称。然后使用`<#list>`指令遍历每个部门,在每个部门下使用嵌套的`<#list>`指令遍历对应部门的员工列表,并展示员工的姓名、年龄和职务。 最后,我们使用`?size`获取员工列表的长度,即该部门的员工数量。 通过以上示例,我们可以看到,Freemarker强大的条件判断和循环结构功能可以实现各种复杂的数据展示和处理需求。 这里只是简单介绍了Freemarker中条件判断和循环结构的高级应用,实际应用场景还有很多,需要根据具体需求进行灵活运用。 在下一章节中,我们将总结Freemarker中条件判断和循环结构的基本用法,并提供一些实际应用场景的举例。 ###小结 通过本章节的学习,我们掌握了Freemarker中条件判断和循环结构的高级应用方法。我们可以根据具体需求,将条件判断和循环结构灵活地组合使用,实现各种复杂的数据展示、处理和统计功能。 在下一章节中,我们将通过提供一些实际应用场景的举例,进一步加深对条件判断和循环结构的理解和应用。 ### 5.2 实际应用场景举例 1. 电商网站的商品列表展示:根据商品的分类进行条件判断,使用循环结构遍历每个分类下的商品列表,并展示商品的名称、价格、图片等信息。 2. 博客系统的文章列表展示:根据文章的标签进行条件判断,使用循环结构遍历每个标签下的文章列表,并展示文章的标题、作者、发布日期等信息。 3. 学生成绩统计系统:根据学生的成绩进行条件判断,使用循环结构遍历每个学生的成绩,并计算出平均分、最高分、最低分等统计结果。 以上只是一些简单的示例,实际应用场景很多,如论坛系统、新闻网站、社交媒体等都可以利用Freemarker的条件判断和循环结构功能实现各种需求。 ### 6. 参考资料 1. Freemarker官方文档:https://freemarker.apache.org/docs/index.html 2. Freemarker教程:https://www.tutorialspoint.com/freemarker/index.htm 3. Freemarker入门指南:https://zh.freemarker.org/docs/dgui_quickstart.html 4. Freemarker语法参考:https://freemarker.apache.org/docs/ref.html ## 5. 小结 5.1 总结Freemarker中条件判断和循环结构的基本用法 在本章中,我们学习了Freemarker中条件判断和循环结构的基本用法。通过if语句和switch语句,我们可以根据不同的逻辑条件执行相应的代码块。而通过for循环和foreach循环,我们可以遍历数组、集合等复杂数据结构,对其进行处理和展示。 总结一下,条件判断和循环结构是Freemarker中非常重要的语法,能够帮助我们实现灵活的数据处理和展示。在实际开发中,我们经常会遇到需要根据不同条件去执行不同逻辑的情况,或者需要对一组数据进行遍历和处理。掌握了条件判断和循环结构的基本用法,我们将能够更高效地开发出符合需求的模板。 5.2 实际应用场景举例 下面是一些实际应用场景,帮助我们更好地理解条件判断和循环结构的应用。 * **动态生成导航栏**:通过判断当前页面的URL与导航栏中的链接是否匹配,可以动态生成当前页面高亮的导航栏。 * **遍历数据库查询结果**:利用循环结构,我们可以遍历数据库查询结果集,将其展示在页面上,实现数据的动态展示。 * **根据不同的角色显示不同内容**:通过if语句,我们可以根据用户的角色判断是否展示某些内容,实现权限控制。 * **列表页分页处理**:通过计算总数据条数和每页显示的数据量,利用循环结构和条件判断,我们能够实现列表页的分页处理。 这些仅仅只是条件判断和循环结构的一些应用场景的简要示例,实际开发中还会有更多的复杂情况和不同的需求。掌握了Freemarker中条件判断和循环结构的基本用法,我们可以根据具体的业务需求灵活运用,开发出更具有扩展性和可维护性的模板。 ## 6. 参考资料 以下是一些有关Freemarker条件判断和循环结构的参考资料,供大家深入了解和学习: - Freemarker官方文档:[https://freemarker.apache.org/docs/](https://freemarker.apache.org/docs/) - Freemarker教程 | 菜鸟教程:[https://www.runoob.com/freemarker/freemarker-tutorial.html](https://www.runoob.com/freemarker/freemarker-tutorial.html) - Freemarker入门教程 | 张鹏个人博客:[http://zhangpeng96.net/zp/1602810082.html](http://zhangpeng96.net/zp/1602810082.html) ```markdown ## 5. 小结 在本章中,我们详细介绍了Freemarker中条件判断和循环结构的基本用法。通过学习本章内容,我们可以总结如下: - 条件判断可以使用if语句进行简单的条件判断,也可以使用if-else语句进行多分支的条件判断,还可以使用switch语句进行多条件的匹配。 - 循环结构可以使用for循环对集合中的元素进行遍历,也可以通过嵌套循环实现复杂数据结构的遍历,还可以使用foreach循环简化遍历操作。 - 在高级应用部分,我们学习了如何将条件判断与循环结构相结合,以及如何利用它们实现数据的展示和处理。 通过本章的学习,我们对Freemarker中条件判断和循环结构有了全面的了解,并且掌握了它们的基本用法和高级应用技巧,为我们在实际开发中的应用打下了坚实的基础。 ### 5.2 实际应用场景举例 在实际项目中,我们经常会遇到需要根据条件进行数据展示或者处理的场景,也会有大量的数据需要遍历和处理。通过本章学习的内容,我们可以灵活运用条件判断和循环结构,解决这些实际问题,提高开发效率,为项目的顺利进行提供有力的支持。 我们鼓励大家在实际项目中多多尝试,不断深入理解并熟练运用Freemarker中条件判断和循环结构,从而成为优秀的应用开发者。 ## 6. 参考资料 ```
corwn 最低0.47元/天 解锁专栏
买1年送1年
点击查看下一篇
profit 百万级 高质量VIP文章无限畅学
profit 千万级 优质资源任意下载
profit C知道 免费提问 ( 生成式Al产品 )

相关推荐

docx
JAVA模版引擎Freemarker常用标签(一) 1. if指令 这是一个典型的分支控制指令,该指令的作用完全类似于Java语言中的if,if指令的语法格式如下: ... ... ... ... 例子如下: 60)>老年人 40)>中年人 20)>青年人 少年人 输出结果是:青年人 上面的代码中的逻辑表达式用括号括起来主要是因为里面有>符号,由于FreeMarker会将>符号当成标签的结束字符,可能导致程序出错,为了避免这种情况,我们应该在凡是出现这些符号的地方都使用括号. <#if animals.python.price Pythons are cheaper than elephants today. Pythons are not cheaper than elephants today. 2、 switch , case , default , break指令 这些指令显然是分支指令,作用类似于Java的switch语句,switch指令的语法结构如下: ... ... ... 3、 list, break指令 list指令是一个迭代输出指令,用于迭代输出数据模型中的集合,list指令的语法格式如下: ... 上面的语法格式中,sequence就是一个集合对象,也可以是一个表达式,但该表达式将返回一个集合对象,而item是一个任意的名字,就是被迭代输出的集合元素.此外,迭代集合对象时,还包含两个特殊的循环变量: item_index:当前变量的索引值 item_has_next:是否存在下一个对象 也可以使用指令跳出迭代 例子如下: ${x_index + 1}.${x}, We have these animals: NamePrice ${being.name}${being.price} Euros 输出为: We have these animals: NamePrice mouse50 Euros elephant5000 Euros python4999 Euros 4、include指令 include指令的作用类似于JSP的包含指令,用于包含指定页.include指令的语法格式如下: 在上面的语法格式中,两个参数的解释如下: filename:该参数指定被包含的模板文件 options:该参数可以省略,指定包含时的选项,包含encoding和parse两个选项,其中encoding指定包含页面时所用的解码集,而parse指定被包含文件是否作为FTL文件来解析,如果省略了parse选项值,则该选项默认是true. Test page Test page Blah blah... 5、 import指令 该指令用于导入FreeMarker模板中的所有变量,并将该变量放置在指定的Map对象中,import指令的语法格式如下: 上面的代码将导入/lib/common.ftl模板文件中的所有变量,将这些变量放置在一个名为com的Map对象中. 创建库 ? 下面是一个创建库的例子(假设保存在lib/my_test.ftl中): Copyright (C) ${date} Julia Smith. All rights reserved. Email: ${mail} ? 使用import指令导入库到模板中,Freemarker会为导入的库创建新的名字空间,并可以通过import指令中指定的散列变量访问库中的变量: ${my.mail} ${mail} 输出结果: Copyright (C) 1999-2002 Julia Smith. All rights reserved. Email: jsmith@acme.com jsmith@acme.com fred@acme.com 可以看到例子中使用的两个同名变量并没有冲突,因为它们位于不同的名字空间 l 可以使用assign指令在导入的名字空间中创建或替代变量,下面是一个例子: ${my.mail} ${my.mail} l 输出结果: jsmith@acme.com jsmith@other.com l 数据模型中的变量任何地方都可见,也包括不同的名字空间,下面是修改的库: Copyright (C) ${date} ${user}. All rights reserved. l 假设数据模型中的user变量的值是Fred,则下面的代码: ${my.mail} l 输出结果: Copyright (C) 1999-2002 Fred. All rights reserved. 1.6 算术运算符 FreeMarker表达式中完全支持算术运算,FreeMarker支持的算术运算符包括:+, - , * , / , % 看如下的代码: ${ x * x - 100 } ${ x /2 } ${ 12 } 输出结果是: -75 2.5 2 在表达式中使用算术运算符时要注意以下几点: 1,运算符两边的运算数字必须是数字 2,使用+运算符时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串再连接,如:${3 + "5"},结果是:35 使用内建的int函数可对数值取整,如: ${ (x/2)?int } ${ 1.1?int } ${ 1.999?int } ${ -1.1?int } ${ -1.999?int } 结果是:2 1 1 -1 -1 1.7 比较运算符 表达式中支持的比较运算符有如下几个: 1. =或者==:判断两个值是否相等. 2. !=:判断两个值是否不等. 3. >或者gt:判断左边值是否大于右边值 4. >=或者gte:判断左边值是否大于等于右边值 5. <或者lt:判断左边值是否小于右边值 6. 会有更好的效果,因为 FreeMarker会把>解释成FTL标签的结束字符,当然,也可以使用括号来避免这种情况,如:y)> 1.8 逻辑运算符 逻辑运算符有如下几个: 逻辑与:&& 逻辑或:|| 逻辑非:! 逻辑运算符只能作用于布尔值,否则将产生错误 1.9 内建函数 FreeMarker还提供了一些内建函数来转换输出,可以在任何变量后紧跟?,?后紧跟内建函数,就可以通过内建函数来轮换输出变量.下面是常用的内建的字符串函数: html:对字符串进行HTML编码 cap_first:使字符串第一个字母大写 lower_case:将字符串转换成小写 upper_case:将字符串转换成大写 trim:去掉字符串前后的空白字符 下面是集合的常用内建函数 size:获取序列中元素的个数 下面是数字值的常用内建函数 int:取得数字的整数部分,结果带符号 例如: ${test?html} ${test?upper_case?html} 结果是:Tom & Jerry TOM & JERRY 1.10 空值处理运算符 FreeMarker对空值的处理非常严格,FreeMarker的变量必须有值,没有被赋值的变量就会抛出异常,因为FreeMarker未赋值 的变量强制出错可以杜绝很多潜在的错误,如缺失潜在的变量命名,或者其他变量错误.这里所说的空值,实际上也包括那些并不存在的变量,对于一个Java的 null值而言,我们认为这个变量是存在的,只是它的值为null,但对于FreeMarker模板而言,它无法理解null值,null值和不存在的变 量完全相同. 为了处理缺失变量,FreeMarker提供了两个运算符: !: 指定缺失变量的默认值 ??: 判断某个变量是否存在 其中,!运算符的用法有如下两种: variable!或variable!defaultValue,第一种用法不给缺失的变量指定默认值,表明默认值是空字符串,长度为0的集合,或者长度为0的Map对象. 使用!指定默认值时,并不要求默认值的类型和变量类型相同.使用??运算符非常简单,它总是返回一个布尔值,用法为:variable??,如果该变量存在,返回true,否则返回false ########################### 最常用的概念 1、 scalars:存储单值 字符串:简单文本由单或双引号括起来。 数字:直接使用数值。 日期:通常从数据模型获得 布尔值:true或false,通常在标记中使用 2、 hashes:充当其它对象的容器,每个都关联一个唯一的查询名字 具有一个唯一的查询名字和他包含的每个变量相关联。 3、 sequences:充当其它对象的容器,按次序访问 使用数字和他包含的每个变量相关联。索引值从0开始。 4、 集合变量: 除了无法访问它的大小和不能使用索引来获得它的子变量:集合可以看作只能由指令使用的受限sequences。 5、 方法:通过传递的参数进行计算,以新对象返回结果 方法变量通常是基于给出的参数计算值在数据模型中定义。 6、 用户自定义FTL指令:宏和变换器 7、 节点 节点变量表示为树型结构中的一个节点,通常在XML处理中使用。 在模板里对sequences和hashes初始化 sequences 1. [“you”,”me”,”he”] 2. 1..100 3. [ {“Akey”:”Avalue”},{“Akey1”:”Avalue1”}, {“Bkey”:”Bvalue”},{“Bkey1”:”Bvalue1”}, ] hashes {“you”:”a”,”me”:”b”,”he”:”c”} 注释标志 旧版本的freemarker采用的是 注释 方法 sequences内置方法 sequence?first 返回sequence的第一个值;前提条件sequence不能是null sequence?last 返回sequence最后一个值 sequence?reverse 反转sequence的值 sequence?size 返回sequence的大小 sequence?sort 对sequence按里面的对象toString()的结果进行排序 sequence?sort_by(value) 对sequence 按里面的对象的属性value进行排序 如: sequence里面放入的是10 个user对象,user对象里面包含name,age等属性 sequence?sort_by(name) 表示所有的user按user.name进行排序 hashes内置方法 hash?keys 返回hash里的所有keys, 返回结果类型sequence hash?values 返回hash里的所有value, 返回结果类型sequence 模板 使用FTL(freeMarker模板语言)编写 组成部分 一、整体结构 1、注释:,不会输出。 2、文本:直接输出。 3、interpolation:由 ${var} 或 #{var} 限定,由计算值代替输出。 4、FTL标记 二.表达式 1、直接指定值: 1-1、字符串: 由双引号或单引号括起来的字符串,其中的特殊字符(如' " \等)需要转义。 1-2、raw字符串: 有一种特殊的字符串称为raw字符串,被认为是纯文本,其中的\和{等不具有特殊含义,该类字符串在引号前面加r,下面是一个例子: ${r"/${data}"year""}屏幕输出结果为:/${data}"year" 转义 含义 序列 \" 双引号(u0022) \' 单引号(u0027) \\ 反斜杠(u005C) \n 换行(u000A) \r Return (u000D) \t Tab (u0009) \b Backspace (u0008) \f Form feed (u000C) \l \a & \{ { \xCode 4位16进制Unicode代码 1-3、数字:直接输入,不需要引号 1)、精度数字使用“.”分隔,不能使用分组符号 2)、目前版本不支持科学计数法,所以“1E3”是错误的 3)、不能省略小数点前面的0,所以“.5”是错误的 4)、数字8、+8、08和8.00都是相同的 1-4、布尔值:true和false,不使用引号 1-5、序列:由逗号分隔的子变量列表,由[]方括号限定。 1)、子变量列表可以是表达式 2)、可以使用数字范围定义数字序列,不需要方括号限定,例如2..5等同于[2, 3, 4, 5],但是更有效率,可以定义反递增范围如:5..2。 1-6、散列(hash) 1)、由逗号分隔的键/值列表,由{}大括号限定,键和值之间用冒号分隔,如:{"key1":valu1,"key2":"character string"....} 2)、键和值都是表达式,但是键必须是字符串。 2、获取变量: 2-1、顶层变量:${变量名} 变量名只能是字母、数字、下划线、$、#、@ 的组合,且不能以数字开头。 2-2、散列:有两种方法 1)、点语法:变量名字和顶层变量的名字受同样的限制 2)、方括号语法:变量名字无限制,可以是任意的表达式的结果 book.author.name book.author.["name"] book["author"].name book["author"]["name"] 以上是等价的。 2-3、序列:使用散列的方括号语法获取变量,方括号中的表达式结果必须为数字。注意:第一个项目的索引为0。可以使用 [startindex..endindex]语法获取序列片段。 2-4、特殊变量:FreeMarker内定义变量,使用.variablename语法访问。 3、字符串操作 3-1、interpolation:使用${}或#{}在文本部分插入表达式的值,例如: ${"hello${username}!"} ${"${username}${username}${username}"} 也可以使用+来获得同样的结果: ${"hello"+username+"!"} ${username+username+username} 注意:${}只能用于文本部分而不能出现于标记内。 或都是错误的; 是正确的。 本例中user.login的值必须是布尔类型。 3-2、子串: 举例说明:假如user的值为"Big Joe" ${user[0]}${user[4]}结果是:BJ ${user[1..4]}结果是:ig J 4、序列操作 4-1、连接操作:可以使用+来操作,例如: ["title","author"]+["month","day"] 5、散列操作 5-1、连接操作:可以使用+来操作,如果有相同的KEY,则右边的值会替代左边的值,例如: {"title":散列,"author":"emma"}+{"month":5,"day":5}+{"month":6}结果month的值就是6。 6、算术运算 6-1、操作符:+、-、*、/、% 除+号以外的其他操作符两边的数据,必须都是数字类型。 如果+号操作符一边有一个字符型数据,会自动将另一边的数据转换为字符型数据,运算结果为字符型数据。 6-2、比较操作符: 1}、= 2}、== 3}、!= 4}、< 5}、 7}、>= 1-3的操作符,两边的数据类型必须相同,否则会产生错误 4-7的操作符,对于日期和数字可以使用,字符串不可以使用。 注意: 1}、FreeMarker是精确比较,所以"x" "x " "X"是不等的。 2}、因为对FTL来说是开始和结束标记,所以,可以用两种方法来避免这种情况: 一种是使用括号<#if (a 另一是使用替代输出,对应如下: < lt gt >= gte 6-3、逻辑操作符:只能用于布尔值,否则会出现错误。 &&(and)与运算 ||(or)或运算 !(not)非运算 6-4、内建函数:使用方法类似于访问散列的子变量,只是使用?代替.例如:${test?upper_case?html} 常用的内建函数列举如下: 1}、字符串使用: html:对字符串进行HTML编码 cap_first:字符串第一个字母大写 lower_first:字符串第一个字母小写 upper_case:将字符串转换成大写 trim:去掉字符前后的空白字符 2)、序列使用: size:获得序列中元素的数目 3)、数字使用: int:取得数字的整数部分 7、操作符的优先顺序: 后缀:[subbarName][subStringRange].(mathodParams) 一元:+expr、-expr、! (not) 内建:? 乘法:*、/、% 加法:+、- 关系:<、、>= (lt、lte、gt、gte) 相等:=、==、!= 逻辑与:&& (and) 逻辑或:|| (or) 数字范围:.. 四、interpolation inperpolation只能用于文本,有两种类型:通用interpolation及数字interpolation 1、通用interpolation 如${expr} 1-1、插入字符串值:直接输出表达式结果。 1-2、插入数字值:根据缺省格式(由setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string来格式化单个interpolation 如: ${answer} ${answer?string} ${answer?string.number} ${answer?string.currency} ${answer?string.percent} 1-3、插入日期值:根据缺省格式(由setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string来格式化单个interpolation 如: ${lastupdata?string("yyyy-MM-dd HH:mm:ss zzzz")} ${lastupdata?string("EEE,MMM d, ''yy")} ${lastupdata?string("EEEE,MMMM dd, yyyy,hh:mm:ss a '('zzz')'")} 1-4、插入布尔值:根据缺省格式(由setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string来格式化单个interpolation 如: ${foo?string("yes","no")} 2、数字interpolation: 有两种形式: 1)、#{expr} 2)、#{expr;format}:format可以用来格式化数字,format可以是如下: mX:小数部分最小X位 MX:小数部分最大X位 例如: #{x;M2} #{y;M2} #{x;m1} #{y;m1} #{x;m1M2} #{y;m1M2} 宏 宏和变换器变量是两种不同类型的用户自定义指令,他们的区别是: 宏可以在模板中用macro指令来定义 变换器是在模板外由程序定义 1、宏:和某个变量关联的模板片段,以便在模板中通过用户自定义指令使用该变量 1-1、基本用法: 例如: Hello JOE! 使用时: 如果没有体内容也可以用 1-2、变量: 1)、可以在宏定义之后定义参数,宏参数是局部变量,只在宏定义中有效。如: Hello ${person}! 使用时: and 输出为: Hello emma! Hello LEO! 注意:宏的参数是FTL表达式,所以,person=emma和上面的例子中具有不同的意义,这意味着将变量emma的值传给person,这个值可能是任意一种数据类型,甚至是一个复杂的表达式。 宏可以有多个参数,使用时参数的次序是无关的,但是只能使用宏中定义的参数,并且对所有参数赋值。如: Hello ${person}! 使用时: 正确 错误,color没有赋值,此时,如果在定义宏时为color定义缺省值这样的话,这个使用方法就是正确的。 错误,宏greet定义中未指定bgcolor这个参数 2、嵌套内容: 2-1、自定义指令可以有嵌套内容,使用指令,执行自定义指令开始和结束标记之间的模板片段。例如: hello Emma! 输出为 hello Emma! 2-2、指令可以被多次调用,例如 hello Emma! 输出为 hello Emma! hello Emma! hello Emma! hello Emma! 2-3、嵌套的内容可以是有效的FTL,例如: Hello ${person}! 输出为: Hello Emma! Hello Andrew! Hello Peter! 2-4、宏定义中的局部变量对嵌套内容是不可见的,例如: ${y}${count}/${x}: ${y?default("?")} ${x?default("?")} ${count?default("?")} 输出结果为 test 3/1:??? test 3/2:??? test 3/3:??? 2-5、在宏定义中使用循环变量,通常用来重复嵌套内容,基本用法为:作为nested指令的参数,传递循环变量的实际值,而在调用自定义指令时,在标记的参数后面指定循环变量的名字。 例如: ${c}. ${halfc} last! 输出结果是 1. 0.5 2. 1 3. 1.5 4. 2last! 注意:指定循环变量的数目和用户定义指令开始标记指定的不同不会有问题 调用时,少指定循环变量,多指定的值会不见 调用时,多指定循环变量,多余的循环变量不会被创建 二、在模板中定义变量 1、在模板中定义的变量有三种类型 1-1、plain变量:可以在模板的任何地方访问,包括使用include指令插入的模板,使用assign指令创建和替换。 1-2、局部变量:在宏定义体中有效,使用local指令创建和替换。 1-3、循环变量:只能存在于指令的嵌套内容,由指令(如list)自动创建。 注意: 1)、宏的参数是局部变量,不是循环变量。 2)、局部变量隐藏同名的plain变量 3)、循环变量隐藏同名的plain变量和局部变量。 例如: 1. ${x} 6. ${x} 7. ${x} 8. ${x} 9. ${x} 2. ${x} 3. ${x} 4. ${x} 5. ${x} 4)、内部循环变量隐藏同名的外部循环变量 ${x} ${x} ${x} ${x} ${x} 5)、模板中的变量会隐藏数据模型中的同名变量,如果需访问数据模型中的变量,使用特殊变量global。 例如: 假设数据模型中的user值为Emma ${user} ${.global.user} macro, nested, return 语法 ... ... ... 用例 Test text, and the params: ${foo}, ${bar}, ${baaz} 输出 Test text, and the params: a, b, 23 Test text, and the params: a, b, -1 Test text, and the params: a, Bar, 23 Test text, and the params: a, Bar, -1 定义循环输出的宏 ${title?cap_first}: ${x?cap_first} 输出结果 Animals: 包含body的宏 ${c}. ${halfc} Last! 输出 1. 0.5 2. 1 3. 1.5 4. 2 Last! t, lt, rt 语法 去掉左右空白和回车换行 去掉左边空白和回车换行 去掉右边空白和回车换行 取消上面的效果 B指令 freemarker指令有两种: 1、预定义指令:引用方式为 2、用户定义指令:引用方式为,引用用户定义指令时须将#换为@。 注意:如果使用不存在的指令,FreeMarker不会使用模板输出,而是产生一个错误消息。 freemarker指令由FTL标记来引用,FTL标记和HTML标记类似,名字前加#来加以区分。如HTML标记的形式为则FTL标记的形式是(此处h1标记和list指令没有任何功能上的对应关系,只是做为说明使用一下)。 有三种FTL标记: 1)、开始标记: 2)、结束标记: 3)、空标记: 注意: 1) FTL会忽略标记之中的空格,但是,<#和指令 与 </#和指令 之间不能有空格。 2) FTL标记不能够交叉,必须合理嵌套。每个开始标记对应一个结束标记,层层嵌套。 如: ${数据} game over! 注意事项: 1)、FTL对大小写敏感。所以使用的标记及interpolation要注意大小写。name与NAME就是不同的对象。是正确的标记,而则不是。 2)、interpolation只能在文本部分使用,不能位于FTL标记内。如是错误的,正确的方法是:,而且此处var必须为布尔值。 3)、FTL标记不能位于另一个FTL标记内部,注释例外。注释可以位于标记及interpolation内部。 if, else, elseif 语法 ... ... ... ... ... 用例 x is 1 x is 1 x is not 1 We have these animals: NamePrice ${being.name} ${being.price} Euros It is Big Joe It is not Big Joe switch, case, default, break 语法 ... ... ... ... 用例 字符串 This will be processed if it is small This will be processed if it is medium This will be processed if it is large This will be processed if it is neither 数字 1 2 d 如果x=1 输出 1 2, x=2输出 2, x=3 输出d list, break 语法 ... ... 关键字 item_index:是list当前值的下标 item_has_next:判断list是否还有值 用例 ${x_index + 1}. ${x}, 输出 1. winter, 2. spring, 3. summer, 4. autumn include 语法 or options包含两个属性 encoding=”GBK” 编码格式 parse=true 是否作为ftl语法解析,默认是true,false就是以文本方式引入.注意在ftl文件里布尔值都是直接赋值的如parse=true,而不是parse=”true” 用例 /common/copyright.ftl包含内容 Copyright 2001-2002 ${me} All rights reserved. 模板文件 Some test Yeah. 输出结果 Some test Yeah. Test page Test page Blah blah... Import 语法 类似于java里的import,它导入文件,然后就可以在当前文件里使用被导入文件里的宏组件 用例 假设mylib.ftl里定义了宏copyright那么我们在其他模板页面里可以这样使用 "my"在freemarker里被称作namespace compress 语法 ... 用来压缩空白空间和空白的行 用例 ( 1 2 3 4 5 ${moo} test only I said, test only ) 输出 (1 2 3 4 5 moo test only I said, test only) escape, noescape 语法 ... ... ... 用例 主要使用在相似的字符串变量输出,比如某一个模块的所有字符串输出都必须是html安全的,这个时候就可以使用该表达式 First name: ${firstName} Last name: ${lastName} Maiden name: ${maidenName} 相同表达式 First name: ${firstName?html} Last name: ${lastName } Maiden name: ${maidenName?html} assign 语法 or or or capture this or capture this 用例 生成变量,并且给变量赋值 给seasons赋予序列值 给变量test加1 给my namespage 赋予一个变量bgColor,下面可以通过my.bgColor来访问这个变量 将一段输出的文本作为变量保存在x里 下面的阴影部分输出的文本将被赋值给x ${n} Number of words: ${x?word_list?size} ${x} Hello ${user}! error true 同时也支持中文赋值,如: java ${语法} 打印输出: java global 语法 or or capture this 全局赋值语法,利用这个语法给变量赋值,那么这个变量在所有的namespace中是可见的,如果这个变量被当前的assign语法覆盖如 在当前页面里x=2将被隐藏,或者通过${.global.x}来访问[A2] setting 语法 用来设置整个系统的一个环境 locale number_format boolean_format date_format, time_format, datetime_format time_zone classic_compatible 用例 假如当前是匈牙利的设置,然后修改成美国 ${1.2} ${1.2} 输出 1,2 1.2 因为匈牙利是采用“,”作为十进制的分隔符,美国是用“.” C一些常用方法或注意事项 表达式转换类 ${expression}计算expression并输出 #{ expression }数字计算#{ expression ;format}安格式输出数字format为M和m M表示小数点后最多的位数,m表示小数点后最少的位数如#{121.2322;m2M2}输出121.23 数字循环 1..5 表示从1到5,原型number..number 对浮点取整数 ${123.23?int} 输出123 给变量默认值 ${var?default(“hello world”)?html}如果var is null那么将会被hello world替代 判断对象是不是null Mouse found 也可以直接${mouse?if_exists})输出布尔形 常用格式化日期 openingTime必须是Date型,详细查看freemarker文档 Reference->build-in referece->build-in for date ${openingTime?date} ${openingTime?date_time} ${openingTime?time} 添加全局共享变量数据模型 在代码里的实现 cfg = Configuration.getDefaultConfiguration(); cfg.setSharedVariable("global", "you good"); 页面实现可以通过global指令,具体查看指令里的global部分 直接调用java对象的方法 ${object.methed(args)} 字符串处理(内置方法) html安全输出 “abcsdfsf”?html 返回安全的html输出,替换掉html代码 xml安全输出 var?xml substring的用法 ${user[0]}${user[4]} ${user[1..4]} 输出 : ho ello 类似String.split的用法 “abc;def;ghi”?split(“;”)返回sequence 将字符串按空格转化成sequence,然后取sequence的长度 var?word_list 效果同 var?split(“ ”) var?word_list?size 取得字符串长度 var?length 大写输出字符 var?upper_case 小写输出字符 var?lower_case 首字符大写 var?cap_first 首字符小写 var?uncap_first 去掉字符串前后空格 var?trim 每个单词的首字符大写 var?capitalize 类似String.indexof: “babcdabcd”?index_of(“abc”) 返回1 “babcdabcd”?index_of(“abc”,2) 返回5 类似String.lastIndexOf last_index_of和String.lastIndexOf类似,同上 下面两个可能在代码生成的时候使用(在引号前加”\”) j_string: 在字符串引号前加”\” String BEAN_NAME = "${beanName?j_string}"; 打印输出: String BEAN_NAME = "The \"foo\" bean."; js_string: alert("Welcome ${user}!"); 打印输出: alert("Welcome Big Joe\'s \"right hand\"!"); 替换字符串 replace${s?replace(‘ba’, ‘XY’ )} ${s?replace(‘ba’, ‘XY’ , ‘规则参数’)}将s里的所有的ba替换成xy 规则参数包含:i r m s c f具体含义如下: ·i: 大小写不区分. ·f: 只替换第一个出现被替换字符串的字符串 ·r: XY是正则表达式 ·m: Multi-line mode for regular expressions. In multi-line mode the expressions ^ and $ match just after or just before, respectively, a line terminator or the end of the string. By default these expressions only match at the beginning and the end of the entire string. ·s: Enables dotall mode for regular expressions (same as Perl singe-line mode). In dotall mode, the expression . matches any character, including a line terminator. By default this expression does not match line terminators. ·c: Permits whitespace and comments in regular expressions. D freemarker在web开发中注意事项 freemarker与webwork整合 web中常用的几个对象 Freemarker的ftl文件中直接使用内部对象: ${Request ["a"]} ${RequestParameters["a"]} ${Session ["a"]} ${Application ["a"]} ${JspTaglibs ["a"]} 与webwork整合之后 通过配置的servlet 已经把request,session等对象置入了数据模型中 在view中存在下面的对象 我们可以在ftl中${req}来打印req对象 req - the current HttpServletRequest res - the current HttpServletResponse stack - the current OgnlValueStack ognl - the OgnlTool instance webwork - an instance of FreemarkerWebWorkUtil action - the current WebWork action exception - optional the Exception instance, if the view is a JSP exception or Servlet exception view view中值的搜索顺序 ${name}将会以下面的顺序查找name值 freemarker variables value stack request attributes session attributes servlet context attributes 在模板里ftl里使用标签 注意,如果标签的属性值是数字,那么必须采用nubmer=123方式给属性赋值 JSP页面 Keyword: Exclude: 模板ftl页面 Keyword: Exclude: 如何初始化共享变量 1. 初始化全局共享数据模型 freemark在web上使用的时候对共享数据的初始化支持的不够,不能在配置初始化的时候实现,而必须通过ftl文件来初始化全局变量。这是不能满主需求的,我们需要在servlet init的时候留出一个接口来初始化系统的共享数据 具体到和webwork整合,因为本身webwork提供了整合servlet,如果要增加全局共享变量,可以通过修改com.opensymphony.webwork.views.freemarker.FreemarkerServlet来实现,我们可以在这个servlet初始化的时候来初始化全局共享变量 与webwork整合配置 配置web.xml freemarker com.opensymphony.webwork.views.freemarker.FreemarkerServlet TemplatePath / NoCache true ContentType text/html template_update_delay 0 default_encoding GBK number_format 0.########## 1 freemarker *.ftl E高级方法 自定义方法 ${timer("yyyy-MM-dd H:mm:ss", x)} ${timer("yyyy-MM-dd ", x)} 在模板中除了可以通过对象来调用方法外(${object.methed(args)})也可以直接调用java实现的方法,java类必须实现接口TemplateMethodModel的方法exec(List args). 下面以把毫秒的时间转换成按格式输出的时间为例子 public class LongToDate implements TemplateMethodModel { public TemplateModel exec(List args) throws TemplateModelException { SimpleDateFormat mydate = new SimpleDateFormat((String) args.get(0))); return mydate.format(new Date(Long.parseLong((String)args.get(1))); } } 将LongToDate对象放入到数据模型中 root.put("timer", new IndexOfMethod()); ftl模板里使用 ${timer("yyyy-MM-dd H:mm:ss", x)} ${timer("yyyy-MM-dd ", x)} 输出 2001-10-12 5:21:12 2001-10-12 自定义 Transforms 实现自定义的文本或表达式的功能,允许对中间的最终文本进行解析转换 例子:实现str 将str转换成STR 的功能 代码如下: import java.io.*; import java.util.*; import freemarker.template.TemplateTransformModel; class UpperCaseTransform implements TemplateTransformModel { public Writer getWriter(Writer out, Map args) { return new UpperCaseWriter(out); } private class UpperCaseWriter extends Writer { private Writer out; UpperCaseWriter (Writer out) { this.out = out; } public void write(char[] cbuf, int off, int len) throws IOException { out.write(new String(cbuf, off, len).toUpperCase()); } public void flush() throws IOException { out.flush(); } public void close() { } } } 然后将此对象put到数据模型中 root.put("upcase", new UpperCaseTransform()); 在view(ftl)页面中可以如下方式使用 hello world 打印输出: HELLO WORLD F.Built-ins ${x?upper_case} – 小写变大写 ${test?html} - 转换为HTML编码格式 ${repeat("A", B)} – 复制B次A Example: ${test?html} ${test?upper_case?html} Assuming that test stores the string Tom & Jerry'', the output will be: Tom & Jerry TOM & JERRY --------- ${repeat("What", 3)} will print: :WhatWhatWhat 1. String内置的JavaScript转换: js_string 用途:用于JavaScript转义,转换',",换行等特殊字符 模板: alert("${errorMessage?js_string}"); 输出: alert("Readonly\'s pet name is \"Cross Bone\""); 2.内置的默认值处理:default 用途: 用于处理默认值 模本: User: ${userLogin.name?default("Anonymous")} ${(employee.department.manager.name)?default(" ")} 输出: User: Anonymous 注,可以对整个对象树加上(),再用内置处理器这种方便的做法,偶也是最近刚学会的,以前一直用很傻的方法做..... 3. Sequence内置的计数器: xxx_index 用途:显示序号 模板: ${e_index}. ${e.name} 输出: 1. Readonly 2. Robbin 4. Sequence内置的分段器: chunk 用途:某些比较BT的排版需求 模板: ${cell} ${cell} 输出: a b c d e f g h i j a b c d e f g h i j - - String ${"It's \"quoted\" and this is a backslash: \\"} ${'It\'s "quoted" and this is a backslash: } ${r"${foo}"} raw字符串,原封不动地现实引号中的内容 ps:前一种是用双引号来引用字符串,后一种是用单引号来引用字符串。 分别需要对双引号和单引号进行转义 ${"${user}${user}${user}${user}"} ${user + user + user + user} 效果相同 ★substring ${user[0]}${user[4]} ${user[1..4]} ${user[4..]} ★number 不支持科学计数法 小数点前面的零不能省略 ★sequences ${x} ${x} ${x} 数组的拼接 - ${user} ★hash - Joe is ${ages.Joe} - Fred is ${ages.Fred} - Julia is ${ages.Julia} 注意重复的键对应的值取最后的一个 ★运算 ${5/2?int} 显示2 cap_first : 首字母大写 capitalize: 所有单词首刺目大写 html : 转换为HTML格式 < replaced with replaced with > & replaced with & " replaced with " index_of : 显示元素所在的位置 "abcabc"?index_of("bc") 返回值为1(下标从0开始) Contains:判断是否存在字符 It contains "ice" 输出: It contains "ice" Replace :替换 split(“XX”):截取XX之后的字符 - ${x} 输出: - some - test - text starts_with :字符串由什么开始返回布尔型 trim :去掉空格 seq_index_of 数组中元素的位置 ${colors?seq_index_of("blue")} 输出: 2 Default : 设置变量的默认值 Exists:放在if句 如果没有….. Mouse found No mouse found Creating mouse... Mouse found No mouse found 输出 : No mouse found Creating mouse... Mouse found if_exists 放在一般语句 (${mouse?if_exists}) Creating mouse... (${mouse?if_exists}) 输出: () Creating mouse... (Jerry) 删除空白行和空格 ... 让此标记内的代码都执行<#escape 后的?参数 From: ${mailMessage.From} Subject: ${mailMessage.Subject} Message: ${mailMessage.htmlFormattedBody} ... 输出: From: ${mailMessage.From?html} Subject: ${mailMessage.Subject?html} Message: ${mailMessage.htmlFormattedBody} ... [A1]默认值 [A2]这里的abc叫做namespace chunk, is_date, last, root, j_string, contains, is_hash, long, float, ends_with, namespace, matches, time, values, seq_last_index_of, uncap_first, byte, substring, is_transform, web_safe, groups, seq_contains, is_macro, index_of, word_list, int, is_method, eval, parent, xml, number, capitalize, if_exists, rtf, node_type, double, is_directive, url, size, default, is_boolean, split, node_name, is_enumerable, seq_index_of, is_sequence, sort, is_node, sort_by, left_pad, cap_first, interpret, children, node_namespace, chop_linebreak, date, short, last_index_of, is_collection, ancestors, length, trim, datetime, is_string, reverse, c, keys, upper_case, js_string, has_content, right_pad, replace, is_hash_ex, new, is_number, is_indexable, lower_case, string, exists, html, first, starts_with ##############2222222222222222############### struts2.0 标签+ftl标签 FreeMarker中文API手册(完整) http://blog.csdn.net/junjun16818/article/details/6990068 三目: ${true?string('5','7')} ${line.class.simpleName} 你好 list里面是object数组 ${line[1]}:${line[0]} 取得list的长度: 0)> 截取字符串:${news.title.substring(0,14)}...${news.title?if_exists} 拆分字符数组 10)> 1.注释: 包含在 2.注意: 由于Freemarker会将>解释成FTL标记的结束字符,所以对于>和>=可以使用括号来避免这种情况,例如 y)> 3. 定义局部变量 4. 导入模板文件 指定名字空间 my 5. if指令 <#if animals.python.price Pythons are cheaper than elephants today. Pythons are not cheaper than elephants today. 6. list指令以及列表序号 第${being_index+1}个 ${being.name}${being.price} Euros ${x} - ${user} 输出结果是: - Joe - Fred - Julia - Kate include指令 7.判断是否为空 ${userInfo.userName?if_exists} 男女 checked 统计条件保证金返款数量 按年统计按月统计按日统计默认按日统计 8.截取字符串 ${carInfo.carNum.substring(0,1)} 9.freemarker的replace功能 替换字符串 replace 线路标签:${lineInfo.lineLableDescribe?replace('#','、')} ${s?replace(‘ba’, ‘XY’ )} ${s?replace(‘ba’, ‘XY’ , ‘规则参数’)}将s里的所有的ba替换成xy 规则参数包含: i r m s c f 具体含义如下: · i: 大小写不区分. · f: 只替换第一个出现被替换字符串的字符串 · r: XY是正则表达式 · m: Multi-line mode for regular expressions. In multi-line mode the expressions ^ and $ match just after or just before, respectively, a line terminator or the end of the string. By default these expressions only match at the beginning and the end of the entire string. · s: Enables dotall mode for regular expressions (same as Perl singe-line mode). In dotall mode, the expression . matches any character, including a line terminator. By default this expression does not match line terminators. · c: Permits whitespace and comments in regular expressions. 10.三目运算 ${true?string('5','7')} 11.string格式化单个Interpolation,下面是一个例子: ${answer} ${answer?string} ${answer?string.number} ${answer?string.currency} ${answer?string.percent} 输出结果是: $42.00 $42.00 42 $42.00 4,200% 12.插入日期值:根据缺省格式(由#setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string格式化单个Interpolation,下面是一个使用格式模式的例子: ${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")} ${lastUpdated?string("EEE, MMM d, ''yy")} ${lastUpdated?string("EEEE, MMMM dd, yyyy, hh:mm:ss a '('zzz')'")} 输出的结果类似下面的格式: 2003-04-08 21:24:44 Pacific Daylight Time Tue, Apr 8, '03 Tuesday, April 08, 2003, 09:24:44 PM (PDT) 13.插入布尔值:根据缺省格式(由#setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string格式化单个Interpolation,下面是一个例子: ${foo?string("yes", "no")} 输出结果是: yes 车型: 三厢轿车 Freemarker 内置函数 数字、字符串、日期格式化 一、 Sequence的内置函数 1. sequence?first 返回sequence的第一个值。 2. sequence?last 返回sequence的最后一个值。 3. sequence?reverse 将sequence的现有顺序反转,即倒序排序 4. sequence?size 返回sequence的大小 5. sequence?sort 将sequence中的对象转化为字符串后顺序排序 6. sequence?sort_by(value) 按sequence中对象的属性value进行排序 二、 Hash的内置函数 1. hash?keys 返回hash里的所有key,返回结果为sequence 2. hash?values 返回hash里的所有value,返回结果为sequence 例如: ${key}=${user[key]} 三、 操作字符串函数 1. substring(start,end)从一个字符串中截取子串 start:截取子串开始的索引,start必须大于等于0,小于等于end end: 截取子串的长度,end必须大于等于0,小于等于字符串长度,如果省略该参数,默认为字符串长度。 例子: ${‘str’?substring(0)}à结果为str ${‘str’?substring(1)}à结果为tr ${‘str’?substring(2)}à结果为r ${‘str’?substring(3)}à结果为 ${‘str’?substring(0,0)}à结果为 ${‘str’?substring(0,1)}à结果为s ${‘str’?substring(0,2)}à结果为st ${‘str’?substring(0,3)}à结果为str 2. cap_first 将字符串中的第一个单词的首字母变为大写。 ${‘str’?cap_first}à结果为Str 3. uncap_first将字符串中的第一个单词的首字母变为小写。 ${‘Str’?cap_first}à结果为str 4. capitalize将字符串中的所有单词的首字母变为大写 ${‘str’? capitalize}à结果为STR 5. date,time,datetime将字符串转换为日期 例如: ${date1}à结果为2009-10-12 ${date2}à结果为9:28:20 ${date3}à结果为2009-10-12 9:28:20 注意:如果指定的字符串格式不正确将引发错误。 6. ends_with 判断某个字符串是否由某个子串结尾,返回布尔值。 ${“string”?ends_with(“ing”)?string} 返回结果为true 注意:布尔值必须转换为字符串才能输出 7. html 用于将字符串中的、&和“替换为对应得":& 8. index_of(substring,start)在字符串中查找某个子串,返回找到子串的第一个字符的索引,如果没有找到子串,则返回-1。 Start参数用于指定从字符串的那个索引处开始搜索,start为数字值。 如果start大于字符串长度,则start取值等于字符串长度,如果start小于0, 则start取值为0。 ${“string”?index_of(“in”) à结果为3 ${“string”?index_of(“ab”) à结果为-1 9.length返回字符串的长度 ${“string”?length}à结果为6 10. lower_case将字符串转为小写 ${“STRING”?lower_case}à结果为string 11.upper_case将字符串转为大写 ${“string”?upper_case}à结果为STRING 12. contains 判断字符中是否包含某个子串。返回布尔值 ${“string”?contains(“ing”)?string} à结果为true 注意:布尔值必须转换为字符串才能输出 13. number将字符串转换为数字 ${“111.11”?number}à结果为111.11 14.replace用于将字符串中的一部分从左到右替换为另外的字符串。 ${“strabg”?replace(“ab”,”in”)} à结果为string 15.split使用指定的分隔符将一个字符串拆分为一组字符串 ${s} 结果为: This is split 16. trim 删除字符串首尾空格 ${“ String ”?trim} à结果为String 四、 操作数字 1. c 用于将数字转换为字符串 ${123?c} à结果为123 2. string用于将数字转换为字符串 Freemarker中预订义了三种数字格式:number,currency(货币)和percent(百分比)其中number为默认的数字格式转换 例如: ${tempNum} ${tempNum?string.number}或${tempNum?string(“number”)} à结果为20 ${tempNum?string.currency}或${tempNum?string(“currency”)} à结果为¥20.00 ${tempNum?string. percent}或${tempNum?string(“percent”)} à结果为2,000% 五、 操作布尔值 string 用于将布尔值转换为字符串输出 true转为“true”,false转换为“false” foo?string(“yes”,”no”)如果布尔值是true,那么返回“yes”,否则返回no ${index} ${p.userName?if_exists} 司机乘客 单程往返 ${(p.ver)!""} 默认 匹配成功 ${p.createTime?string("yyyy-MM-dd HH:mm:ss")} if, else, elseif 语法: ... ... ... ... ... 备注:condition、condition2···必须为boolean 类型,、可有0或多个。 实例: x is 1 x is 2 x is 3 4> x is 4 x is not 1 nor 2 nor 3 nor 4 备注: 号 必须转义,否则出错。。转义请参考其他文档。 switch, case, default, break 语法 ... ... ... ... ... 备注:该指令官方不推荐使用了,可以用if, else, elseif 指令代替。 list, break 语法 ... 备注: sequence 为一个sequence 或者 collection 类型。item 为 循环的变量。该指令中包含有两个特殊的循环变量, item_index:该值为当前循环的值。 item_has_next:该值为一个boolean类型,表明该循环是否含有下一个(是否为循环到了最后一个) 实例: ${x_index + 1}. ${x}, 输出: 1. winter, 2. spring, 3. summer, 4. autumn 实例: ${i} 备注:当x 为一个数值序列时,可以使用该list 列出两个数值之间的值。(适合于表格的序号填写) 实例: ${x} 备注:可以用 来终止该循环。 freemarker常见语法大全 FreeMarker的插值有如下两种类型:1,通用插值${expr};2,数字格式化插值:#{expr}或#{expr;format} ${book.name?if_exists } //用于判断如果存在,就输出这个值 ${book.name?default(‘xxx’)}//默认值xxx ${book.name!"xxx"}//默认值xxx ${book.date?string('yyyy-MM-dd')} //日期格式 ${book?string.number} 20 //三种不同的数字格式 ${book?string.currency}-- ${book?string.percent}— //声明变量,插入布尔值进行显示 ${foo?string("yes","no")} <等大小比较符号使用需要注意:(xml的原因),可以用于比较数字和日期 使用lt、lte、gt和gte来替代<、和>= 也可以使用括号y)> 内置函数: 调用区别于属性的访问,使用?代替. 常见的一些内置函数 对于字符串 html-对字符串进行HTML编码 cap_first-使字符串第一个字母大写 lower_case-将字符串转换成小写 trim-去掉字符串前后的空白字符 对于Sequences(序列) size-获得序列中元素的数目 对于数字 int-取得数字的整数部分(如-1.9?int的结果是-1) 对于集合,可以使用数组的方式,使用下标索引进行访问 逻辑判断: if................ ... ... ...... ... Boolean类型的空值判断 空值判断可以写成 //注意${}为变量的渲染显示,而为定义等操作符的定义 switch............ ... ... ... ... ... 快速定义int区间的集合 //注意不需要[] 3:循环读取集合: 注意/的使用 ${stu} 与jstl循环类似,也可以访问循环的状态 item_index:当前变量的索引值 item_has_next:是否存在下一个对象 其中item名称为as后的变量名,如stu 集合长度判断 判断=的时候,注意只要一个=符号,而不是== 宏/模板 初步了解: 使用更像一个闭包closure,可以定义后,在脚本中任意地方引用,并原地起作用 Hello Joe! 使用的方式为: //同xml可以简写成 宏的参数定义,类似js,在宏名后 带参数进行传递定义 ${person} 调用带参数时,注意使用类似XML的属性格式进行传递,不需要关心顺序问题 参数默认值定义,如果没有,就必须要求传递完整的参数列表 Hello ${person}! 使用xml的嵌套内容进行传递宏调用,关键标签 调用时: The bordered text 标签可以在宏中多次调用,也可以将多个宏组合进行嵌套 for循环的精简版: 宏的循环变量,配合嵌套标签进行参数传递, //这里的三个参数,将会传递到嵌套内容中 ${c}. ${halfc} Last! //这里的内容由macro中的进行参数的传递,传递的数量任意,当注意需要宏接受这些 上述还需要注意;的使用 参数的数量是可变的,并不要求全部都有,但是效果不同 在模板中定义变量 在模板中定义的变量有三种类型: plain变量:可以在模板的任何地方访问,包括使用include指令插入的模板,使用assign指令创建和替换。 局部变量:在宏定义体中有效,使用local指令创建和替换。 循环变量:只能存在于指令的嵌套内容,由指令(如list)自动创建;宏的参数是局部变量,而不是循环变量 //全局的plain变量 内部循环变量将会隐藏同名的外部循环变量 外部导入的使用,可以用于模块化,并且提供公用性 如:lib/my_lib.ftl文件 Copyright (C) ${date} Julia Smith. All rights reserved. Email: ${mail} lib/my_inc.ftl文件 ${my.mail} ${mail} 输出结果将不会出现冲突 对于库中的变量修改,使用in关键字 函数定义:区别于宏对象,带返回值 函数,有返回参数 stringA[M .. N] 取子字符串,类似substring(stringA, M, N) 导入其他页面元素 options包含两个属性 encoding=”GBK” 编码格式 parse=true 是否作为ftl语法解析,默认是true,false就是以文本方式引入.注意在ftl文件里布尔值都是直接赋值的如parse=true,而不是 parse=”true” hash与list的定义 ${c.a} List片段可以采用: products[10..19] or products[5..] 的格式进行定义,当只局限于数字 ${v} 对变量的缺省处理 product.color!"red" 用compress directive或者transform来处理输出。 ...:消除空白行。 ...将输出压缩为一行。都需要包裹所需文档 freemarker可用"["代替"<".在模板的文件开头加上[#ftl]. 数字输出的另外一种方式 #{c.a;m0} 区别于${},这个例子是用于输出数字的格式化,保留小数的位数,详细如下 数字格式化插值可采用#{expr;format}形式来格式化数字,其中format可以是: mX:小数部分最小X位 MX:小数部分最大X位 在定义字符串的时候,可以使用''或者"",对特殊字符,需要使用\进行转义 如果存在大量特殊字符,可以使用${r"..."}进行过滤 ${r"${foo}"} ${r"C:\foo\bar"} Map对象的key和value都是表达式,但是key必须是字符串 可以混合使用.和[""]访问 book.author["name"] //混合使用点语法和方括号语法 为了处理缺失变量,FreeMarker提供了两个运算符: 用于防止对象不存在而导致的异常 !:指定缺失变量的默认值 ??:判断某个变量是否存在,返回boolean值 noparse指令指定FreeMarker不处理该指定里包含的内容,该指令的语法格式如下: ... ${firstName?html} 使用html对字符进行格式化处理,对于<等的过滤 escape , noescape指令,对body内的内容实用统一的表达式 看如下的代码: First name:${firstName} Last name:${lastName} Maiden name:${maidenName} 上面的代码等同于: First name:${firstName?html} Last name:${lastName?html} Maiden name:${maidenName?html} 定义全局变量的方式 // 可以同时定义多个变量,也可以使用循环来给变量赋值 ${n} ${x} setting指令,用于动态设置freeMarker的运行环境: 该指令用于设置FreeMarker的运行环境,该指令的语法格式如下:,在这个格式中,name的取值范围包含如下几个: locale:该选项指定该模板所用的国家/语言选项 number_format:指定格式化输出数字的格式 boolean_format:指定两个布尔值的语法格式,默认值是true,false date_format,time_format,datetime_format:指定格式化输出日期的格式 time_zone:设置格式化输出日期时

SW_孙维

开发技术专家
知名科技公司工程师,开发技术领域拥有丰富的工作经验和专业知识。曾负责设计和开发多个复杂的软件系统,涉及到大规模数据处理、分布式系统和高性能计算等方面。
专栏简介
该专栏是关于Freemarker模板引擎的深入学习和实践的系列文章。专栏从基础概念和语法解析开始,逐步介绍Freemarker中的条件判断、循环结构、变量和数据类型等核心知识,同时讲解了模板文件的组织和引入方式。专栏还探讨了Freemarker中的内建函数和自定义函数的使用,以及错误处理和异常捕获的方法。此外,还介绍了如何处理表单和数据绑定,在模板中实现布局组件和继承,并对国际化和多语言支持进行了讨论。专栏还分享了Freemarker与后端框架和前端框架的集成实践,并探讨了如何优化前端数据渲染的性能。此外,还介绍了安全防护和数据过滤方面的知识,以及自定义和扩展Freemarker模板引擎的方法。最后,还介绍了Freemarker与数据库查询结果的渲染与展现,以及文件下载和导出功能。通过学习该专栏,读者可以全面掌握Freemarker模板引擎的使用和优化技巧,提升Web开发的效率和质量。
最低0.47元/天 解锁专栏
买1年送1年
百万级 高质量VIP文章无限畅学
千万级 优质资源任意下载
C知道 免费提问 ( 生成式Al产品 )

最新推荐

数据科学中的艺术与科学:ggally包的综合应用

![数据科学中的艺术与科学:ggally包的综合应用](https://statisticsglobe.com/wp-content/uploads/2022/03/GGally-Package-R-Programming-Language-TN-1024x576.png) # 1. ggally包概述与安装 ## 1.1 ggally包的来源和特点 `ggally` 是一个为 `ggplot2` 图形系统设计的扩展包,旨在提供额外的图形和工具,以便于进行复杂的数据分析。它由 RStudio 的数据科学家与开发者贡献,允许用户在 `ggplot2` 的基础上构建更加丰富和高级的数据可视化图

R语言在遗传学研究中的应用:基因组数据分析的核心技术

![R语言在遗传学研究中的应用:基因组数据分析的核心技术](https://siepsi.com.co/wp-content/uploads/2022/10/t13-1024x576.jpg) # 1. R语言概述及其在遗传学研究中的重要性 ## 1.1 R语言的起源和特点 R语言是一种专门用于统计分析和图形表示的编程语言。它起源于1993年,由Ross Ihaka和Robert Gentleman在新西兰奥克兰大学创建。R语言是S语言的一个实现,具有强大的计算能力和灵活的图形表现力,是进行数据分析、统计计算和图形表示的理想工具。R语言的开源特性使得它在全球范围内拥有庞大的社区支持,各种先

【R语言与Hadoop】:集成指南,让大数据分析触手可及

![R语言数据包使用详细教程Recharts](https://opengraph.githubassets.com/b57b0d8c912eaf4db4dbb8294269d8381072cc8be5f454ac1506132a5737aa12/recharts/recharts) # 1. R语言与Hadoop集成概述 ## 1.1 R语言与Hadoop集成的背景 在信息技术领域,尤其是在大数据时代,R语言和Hadoop的集成应运而生,为数据分析领域提供了强大的工具。R语言作为一种强大的统计计算和图形处理工具,其在数据分析领域具有广泛的应用。而Hadoop作为一个开源框架,允许在普通的

ggflags包在时间序列分析中的应用:展示随时间变化的国家数据(模块化设计与扩展功能)

![ggflags包](https://opengraph.githubassets.com/d38e1ad72f0645a2ac8917517f0b626236bb15afb94119ebdbba745b3ac7e38b/ellisp/ggflags) # 1. ggflags包概述及时间序列分析基础 在IT行业与数据分析领域,掌握高效的数据处理与可视化工具至关重要。本章将对`ggflags`包进行介绍,并奠定时间序列分析的基础知识。`ggflags`包是R语言中一个扩展包,主要负责在`ggplot2`图形系统上添加各国旗帜标签,以增强地理数据的可视化表现力。 时间序列分析是理解和预测数

【数据动画制作】:ggimage包让信息流动的艺术

![【数据动画制作】:ggimage包让信息流动的艺术](https://www.datasciencecentral.com/wp-content/uploads/2022/02/visu-1024x599.png) # 1. 数据动画制作概述与ggimage包简介 在当今数据爆炸的时代,数据动画作为一种强大的视觉工具,能够有效地揭示数据背后的模式、趋势和关系。本章旨在为读者提供一个对数据动画制作的总览,同时介绍一个强大的R语言包——ggimage。ggimage包是一个专门用于在ggplot2框架内创建具有图像元素的静态和动态图形的工具。利用ggimage包,用户能够轻松地将静态图像或动

高级统计分析应用:ggseas包在R语言中的实战案例

![高级统计分析应用:ggseas包在R语言中的实战案例](https://www.encora.com/hubfs/Picture1-May-23-2022-06-36-13-91-PM.png) # 1. ggseas包概述与基础应用 在当今数据分析领域,ggplot2是一个非常流行且功能强大的绘图系统。然而,在处理时间序列数据时,标准的ggplot2包可能还不够全面。这正是ggseas包出现的初衷,它是一个为ggplot2增加时间序列处理功能的扩展包。本章将带领读者走进ggseas的世界,从基础应用开始,逐步展开ggseas包的核心功能。 ## 1.1 ggseas包的安装与加载

ggmosaic包技巧汇总:提升数据可视化效率与效果的黄金法则

![ggmosaic包技巧汇总:提升数据可视化效率与效果的黄金法则](https://opengraph.githubassets.com/504eef28dbcf298988eefe93a92bfa449a9ec86793c1a1665a6c12a7da80bce0/ProjectMOSAIC/mosaic) # 1. ggmosaic包概述及其在数据可视化中的重要性 在现代数据分析和统计学中,有效地展示和传达信息至关重要。`ggmosaic`包是R语言中一个相对较新的图形工具,它扩展了`ggplot2`的功能,使得数据的可视化更加直观。该包特别适合创建莫氏图(mosaic plot),用

【R语言数据包与大数据】:R包处理大规模数据集,专家技术分享

![【R语言数据包与大数据】:R包处理大规模数据集,专家技术分享](https://techwave.net/wp-content/uploads/2019/02/Distributed-computing-1-1024x515.png) # 1. R语言基础与数据包概述 ## 1.1 R语言简介 R语言是一种用于统计分析、图形表示和报告的编程语言和软件环境。自1997年由Ross Ihaka和Robert Gentleman创建以来,它已经发展成为数据分析领域不可或缺的工具,尤其在统计计算和图形表示方面表现出色。 ## 1.2 R语言的特点 R语言具备高度的可扩展性,社区贡献了大量的数据

R语言ggradar多层雷达图:展示多级别数据的高级技术

![R语言数据包使用详细教程ggradar](https://i2.wp.com/img-blog.csdnimg.cn/20200625155400808.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h5MTk0OXhp,size_16,color_FFFFFF,t_70) # 1. R语言ggradar多层雷达图简介 在数据分析与可视化领域,ggradar包为R语言用户提供了强大的工具,用于创建直观的多层雷达图。这些图表是展示