Freemarke模板引擎文档

Freemarker是一个强大的模板引擎，常用于生成HTML页面、邮件、配置文件和其他文本输出。它遵循Apache许可证2.0，并且不直接面向最终用户，而是作为Java应用中的一个组件，帮助开发者将数据与模板结合，生成所需的输出。模板语言FTL（FreeMarker Template Language）非常简单，专注于数据展示，而不是复杂的编程逻辑。 在Spring Boot中集成Freemarker非常便捷，无需手动配置，只需要在项目中引入`spring-boot-starter-freemarker`和`spring-boot-starter-web`依赖。Spring Boot的自动配置机制会检测到这两个依赖，并自动配置Freemarker的相关设置。`FreeMarkerAutoConfiguration`类是这个自动配置的核心，它会在classpath下找到`freemarker.template.Configuration`和`FreeMarkerConfigurationFactory`类时激活配置。不过，除了模板目录的检查，其他配置如模板加载、缓存策略等则是在`FreeMarkerServletWebConfiguration`中完成。 模板的使用涉及到多个方面： 1. **插值与表达式**： - **直接输出值**：使用`${expression}`直接输出变量或表达式的值。 - **输出变量**：同样使用`${}`，但里面是变量名，例如`${name}`。 - **字符串操作**：支持连接字符串，如`${var1} ${var2}`。 - **集合操作**：可以遍历列表或映射，如`<#list list as item>`。 - **算术运算符**：支持加减乘除等基本运算，如`${num1 + num2}`。 - **比较运算**：包括等于、不等于、大于、小于等，如`${a == b}`。 - **逻辑运算**：AND(`&&`)、OR(`||`)、NOT(`!`)等，如`${a != null && b > 0}`。 - **空值处理**：`?`操作符用于处理可能的空值，如`${var?cdata}`。 2. **内建函数**：Freemarker提供了许多内置函数，例如`date`, `time`, `number_format`等，用于格式化日期、时间或数字。 3. **常用指令**： - **if/else**：条件判断，如`<#if condition>...<#else>...<#endif>`。 - **switch**：多分支选择，如`<#switch var>...<#case 'value'>...<#default>...<#endswitch>`。 - **include**：包含其他模板，如`<#include 'header.ftl'>`。 - **macro**：定义宏，可重用的模板片段。 - **noparse**：阻止Freemarker解析其内部内容，通常用于插入HTML代码。 4. **自动生成代码实践**：在开发过程中，Freemarker模板可以用来动态生成代码，提高效率。 5. **项目实践**：在实际项目中，Freemarker广泛应用于MVC框架，如Spring MVC，用于生成动态HTML页面。通过控制器提供数据模型，然后由Freemarker模板渲染生成最终视图。 6. **小结**：Freemarker的简洁性和灵活性使得它成为Java应用中的理想模板引擎。它的自动化配置与Spring Boot的整合简化了配置工作，让开发者能更专注于业务逻辑和数据呈现。熟练掌握Freemarker的各项特性和用法，对于提升Web应用的开发效率和代码质量大有裨益。