该源码对应个人博客【Spring Boot集成OpenPDF和Freemarker实现PDF导出功能并附源码】配套教程，地址：https://blog.csdn.net/lhmyy521125/article/details/140743558 小伙伴可以自行下载学习！不需要积分！不需要积分！不需要积分！ 如果相关资源对您有所帮助，希望一键三连给博主一点点鼓励，后续更新更多教程和对应免费源码，如果您有任何疑问或建议，请随时留言讨论！ 前言 在我们日常开发中，生成 PDF 文件是一项常见的需求。无论是生成单据、报表、发票还是其他文档，PDF 格式因其便捷的打印和跨平台支持而被广泛使用。本文将介绍如何在 Spring Boot 项目中使用 flying-saucer-pdf 和 Freemarker 来实现 HTML 模板到 PDF 的导出功能 `Flying Saucer`是一个纯Java库，用于使用`CSS 2.1 / CSS 3`呈现任意格式良好的XML（或XHTML），用于布局和格式化，输出到Swing面板，PDF和图像

在Java开发中，有时我们需要对Word文档进行操作，例如生成报告、编辑模板或者自动化文档处理。在这种场景下，Xdoc和Freemarker是两种常用的库，它们提供了方便的API来帮助开发者实现这些功能。这两个库通常以jar包的形式提供，以便在Java项目中引入和使用。以下是关于Xdoc和Freemarker的详细知识： 1. **Xdoc**： - Xdoc是一个用于生成Word文档的Java库，它允许开发者通过简单的API创建、修改和读取Word文件。Xdoc的核心优势在于其简洁的接口，使得开发者能够快速地将数据转化为结构化的Word文档。 - 使用Xdoc.jar，你可以创建表格、段落、列表、图片等复杂格式的内容，而无需深入了解Word的内部格式。 - 在实际应用中，Xdoc常用于生成报表、合同等需要定制化格式的文档，尤其是在需要动态填充数据的情况下。 2. **Freemarker**： - Freemarker是一个强大的、开源的模板引擎，它支持多种语言，包括Java。它的主要用途是将数据模型与HTML或者其他格式的模板结合，生成动态内容。 - 在Java中，Freemarker-2.3.8.jar提供了对Word文档的支持，使得开发者可以通过定义模板文件来生成Word文档。这种方式更加灵活，可以在不接触底层Word格式的情况下设计文档布局。 - Freemarker模板语言（FTL）是一种声明式的编程方式，允许你在模板中嵌入逻辑和控制结构，同时保持模板内容的清晰易读。 3. **集成使用**： - 如果你需要结合Xdoc和Freemarker，可能是在Freemarker模板中生成的内容需要进一步用Xdoc处理，或者反之。这种情况下，你需要理解两个库的协同工作原理，确保数据的正确传递和格式化。 - 通常，你可以先使用Freemarker根据模板生成HTML，然后通过Xdoc将生成的HTML转换为Word文档。这种方法可以充分利用Freemarker的模板设计能力，并利用Xdoc处理Word特定的格式问题。 4. **引入和使用**： - 将`xdoc.jar`和`freemarker-2.3.8.jar`添加到你的Java项目的类路径中，通常是通过Maven或Gradle的依赖管理来完成。 - 引入依赖后，就可以在代码中导入相应的类和方法，如`com.xdoc.Document`和`freemarker.template.Configuration`，并按照官方文档或示例代码进行操作。 5. **注意事项**： - 对于大型项目，务必注意版本兼容性，因为不同版本的库可能存在API变化或者功能差异。 - 考虑到性能和内存使用，合理管理生成和操作的文档对象，避免内存泄漏。 - 编写模板时，遵循良好的模板设计原则，使模板易于维护和扩展。 总结来说，Xdoc和Freemarker是Java中处理Word文档的有力工具，它们分别以不同的方式提供便利。通过理解这两个库的工作原理和使用方法，开发者可以更高效地生成和操作Word文档，满足各种业务需求。在实际开发中，根据项目需求选择合适的方法，或结合两者的优势，可以提升开发效率和文档质量。

**正文** 本篇将深入探讨如何使用`JFinal`、`Maven`和`FreeMarker`构建一个入门级的Web应用程序。我们要理解这三个关键组件的作用和它们之间的协同工作方式。 **JFinal** 是一个基于Java的轻量级Web开发框架，其核心设计目标是简化开发，提高效率。它提供了模型-视图-控制器（MVC）架构，并且对Servlet API进行了封装，使得开发者可以快速地进行Web应用开发。JFinal的特点包括零配置、高性能、插件化等，使得开发过程更加灵活和高效。 **Maven** 是一个项目管理和综合工具，它帮助开发者管理项目的构建、报告和文档。Maven通过依赖管理和项目信息管理，使得项目的构建过程标准化，降低了大型项目中的复杂性。在本实例中，Maven将用于管理JFinal以及其他的依赖库，确保开发环境的一致性和可重复性。 **FreeMarker** 是一个模板引擎，主要用于生成动态网页内容。它与Java代码分离，允许开发者使用简单的模板语言来描述HTML布局，而业务逻辑则由Java代码处理。FreeMarker与JFinal结合使用，可以方便地实现视图层的动态渲染。 在"JFinal+Maven+FreeMarker入门实例"中，我们将看到如何配置和使用这些工具。我们需要在项目根目录下创建一个`pom.xml`文件，这是Maven项目的配置文件。在这里，我们需要列出所有依赖项，包括JFinal和FreeMarker，以及其他可能需要的库。 ```xml com.jfinal jfinal 最新版本号 org.freemarker freemarker 最新版本号 ``` 接下来，我们需要配置JFinal的启动类，通常命名为`App`，并声明使用Maven的web插件进行部署。在`web.xml`中，我们指定JFinal的过滤器，使其能够接管请求。 然后，创建`FreeMarker`模板文件，例如`index.ftl`，放在`/ftl`目录下。这个文件包含HTML结构，其中可以使用FreeMarker语法来插入动态数据。例如： ```html

Welcome to ${appName}!

当前时间：${now?string("yyyy-MM-dd HH:mm:ss")}

``` 在Java控制器中，我们可以设置模型数据并转发到对应的FreeMarker模板： ```java public class MainController extends Controller { public void index() { set("title", "JFinal + Maven + FreeMarker 示例"); set("appName", "我的应用"); render("index.ftl"); } } ``` 通过运行`mvn clean install`命令，Maven会自动下载依赖并构建项目。然后，你可以使用内置的Tomcat服务器或任何其他Web服务器来运行应用。 总结，`JFinal+Maven+FreeMarker`的组合为Java Web开发提供了一个高效、简洁的解决方案。JFinal的轻量级特性使得项目启动快速，Maven的依赖管理让项目构建变得简单，而FreeMarker则提供了灵活的视图渲染机制。通过这个入门实例，开发者可以快速上手并理解这三者如何协同工作，为后续的项目开发打下坚实基础。

多个springboot的小demo源码的打包集合，其中包括helloworld、交互json数据、集成JDBC、使用thymeleaf和freemarker、集成JSP、集成mybatis、添加全局异常处理、集成热部署功能等全方位的实例，方便构建大型项目。

基于Freemarker模板的代码生成器后台(控制层,业务层,持久层)ftl模板文件

本小demo是集成于springboot和spring新提出的webflux模式，前端采用了freemarker模板，数据存储在mongodb中

freemarker使用笔记，从创建文件到写法指导

freemarker的开发学习，从入门到能够用freemarker写出一些程序，是入门和提高的好文档

简介 Spring Boot Demo 是一个基于Spring Boot & MyBatis的种子项目，用于快速构建中小型项目。 特性&提供 集成SpringFox-Swagger2，自动生成swagger注释 统一响应结果封装及生成工具 统一异常处理 常用基础方法抽象(service层、dao层)封装 使用Druid Spring Boot Starter 集成Druid数据库连接池与监控 使用FastJsonHttpMessageConverter，提高JSON序列化速度 集成MyBatis、PageHelper分页插件 提供代码生成器根据表名生成对应的Domain(领域对象)、Mapper、MapperXML、Service、Controller等基础代码 没有集成mybatis generator，全部使用freemarker模板生成，模板随便改 代码生成提供Mysql、Sqlse

Freemarker页面语法 A 概念 最常用的 3 个概念 sequence 序列，对应java 里的list 、数组等非键值对的集合 hash 键值对的集合 namespace 对一个ftl 文件的引用, 利用这个名字可以访问到该ftl 文件的资源 B 指令 if, else, elseif 语法 Java代码 <#if condition> ... <#elseif condition2> ... <#elseif condition3> ... ... <#else> ... <#if condition> ... <#elseif condition2> ... <#elseif condition3> ... ... <#else> ... 用例 Freemarker代码 <#if x = 1> x is 1 <#if x = 1> x is 1 <#else> x is not 1 <#if x = 1> x is 1 <#if x = 1> x is 1 <#else> x is not 1 switch, case, default, break 语法 Freemarker代码 <#switch value> <#case refValue1> ... <#break> <#case refValue2> ... <#break> ... <#case refValueN> ... <#break> <#default> ... <#switch value> <#case refValue1> ... <#break> <#case refValue2> ... <#break> ... <#case refValueN> ... <#break> <#default> ... 用例 字符串 Freemarker代码 <#switch being.size> <#case "small"> This will be processed if it is small <#break> <#case "medium"> This will be processed if it is medium <#break> <#case "large"> This will be processed if it is large <#break> <#default> This will be processed if it is neither <#switch being.size> <#case "small"> This will be processed if it is small <#break> <#case "medium"> This will be processed if it is medium <#break> <#case "large"> This will be processed if it is large <#break> <#default> This will be processed if it is neither 数字 Freemarker代码 <#switch x> <#case x = 1> 1 <#case x = 2> 2 <#default> d <#switch x> <#case x = 1> 1 <#case x = 2> 2 <#default> d 如果x=1 输出 1 2, x=2 输出 2, x=3 输出d list, break 语法 Freemarker代码 <#list sequence as item> ... <#if item = "spring"><#break> ... <#list sequence as item> ... <#if item = "spring"><#break> ... 关键字 item_index:是list当前值的下标 item_has_next:判断list是否还有值 用例 Freemarker代码 <#assign seq = ["winter", "spring", "summer", "autumn"]> <#list seq as x> ${x_index + 1}. ${x}<#if x_has_next>, <#assign seq = ["winter", "spring", "summer", "autumn"]> <#list seq as x> ${x_index + 1}. ${x}<#if x_has_next>, 输出： 1.winter, 2.spring, 3.summer, 4.autumn include 语法 Freemarker代码 <#include filename> <#include filename> 或则 Java代码 <#include filename options> <#include filename options> options包含两个属性 encoding="GBK" 编码格式 parse=true 是否作为ftl语法解析,默认是true，false就是以文本方式引入.注意在ftl文件里布尔值都是直接赋值 的如parse=true,而不是parse="true" 用例 /common/copyright.ftl 包含内容 Ftl代码 Copyright 2001-2002 ${me} All rights reserved. Copyright 2001-2002 ${me} All rights reserved. 模板文件 Java代码 <#assign me = "Juila Smith"> Some test Yeah ___________________________________________________________________________ <#include "/common/copyright.ftl" encoding="GBK"> <#assign me = "Juila Smith"> Some test Yeah ___________________________________________________________________________ <#include "/common/copyright.ftl" encoding="GBK"> 输出结果: Some test Yeah. Copyright 2001-2002 Juila Smith All rights reserved. Import 语法 Freemarker代码 <#import path as hash> <#import path as hash> 类似于java里的import,它导入文件，然后就可以在当前文件里使用被导入文件里的宏组件 用例 假设mylib.ftl 里定义了宏copyright 那么我们在其他模板页面里可以这样使用 Freemarker代码 <#import "/libs/mylib.ftl" as my> <@my.copyright date="1999-2002"/> <#-- "my"在freemarker里被称作namespace --> <#import "/libs/mylib.ftl" as my> <@my.copyright date="1999-2002"/> <#-- "my"在freemarker里被称作namespace --> compress 语法 Freemarker代码 <#compress> ... <#compress> ... 用来压缩空白空间和空白的行 escape, noescape 语法 Freemarker代码 <#escape identifier as expression> ... <#noescape>... ... <#escape identifier as expression> ... <#noescape>... ... 用例 主要使用在相似的字符串变量输出，比如某一个模块的所有字符串输出都必须是html安全的，这个时候就可以使用 该表达式 Freemarker代码 <#escape x as x?html> First name: ${firstName} <#noescape>Last name: ${lastName} Maiden name: ${maidenName} <#escape x as x?html> First name: ${firstName} <#noescape>Last name: ${lastName} Maiden name: ${maidenName} 相同表达式 Ftl代码 First name: ${firstName?html} Last name: ${lastName } Maiden name: ${maidenName?html} First name: ${firstName?html} Last name: ${lastName } Maiden name: ${maidenName?html} assign 语法 Freemarker代码 <#assign name=value> <#-- 或则 --> <#assign name1=value1 name2=value2 ... nameN=valueN> <#-- 或则 --> <#assign same as above... in namespacehash> <#-- 或则 --> <#assign name> capture this <#-- 或则 --> <#assign name in namespacehash> capture this <#assign name=value> <#-- 或则 --> <#assign name1=value1 name2=value2 ... nameN=valueN> <#-- 或则 --> <#assign same as above... in namespacehash> <#-- 或则 --> <#assign name> capture this <#-- 或则 --> <#assign name in namespacehash> capture this 用例 生成变量,并且给变量赋值 给seasons赋予序列值 Ftl代码 <#assign seasons = ["winter", "spring", "summer", "autumn"]> <#assign seasons = ["winter", "spring", "summer", "autumn"]> 给变量test加1 Ftl代码 <#assign test = test + 1> <#assign test = test + 1> 给my namespage 赋予一个变量bgColor,下面可以通过my.bgColor来访问这个变量 Ftl代码 <#import "/mylib.ftl" as my> <#assign bgColor="red" in my> <#import "/mylib.ftl" as my> <#assign bgColor="red" in my> 将一段输出的文本作为变量保存在x里 Ftl代码 <#assign x> <#list 1..3 as n> ${n} <@myMacro /> Number of words: ${x?word_list?size} ${x} <#assign x>Hello ${user}! error <#assign x=" Hello ${user}!"> true <#assign x> <#list 1..3 as n> ${n} <@myMacro /> Number of words: ${x?word_list?size} ${x} <#assign x>Hello ${user}! error <#assign x=" Hello ${user}!"> true 同时也支持中文赋值，如： Ftl代码 <#assign 语法> java ${语法} <#assign 语法> java ${语法} 打印输出: java global 语法 Freemarker代码 <#global name=value> <#--或则--> <#global name1=value1 name2=value2 ... nameN=valueN> <#--或则--> <#global name> capture this <#global name=value> <#--或则--> <#global name1=value1 name2=value2 ... nameN=valueN> <#--或则--> <#global name> capture this 全局赋值语法，利用这个语法给变量赋值，那么这个变量在所有的namespace [A1] 中是可见的, 如果这个变量被当前的assign 语法覆盖 如<#global x=2> <#assign x=1> 在当前页面里x=2 将被隐藏，或者通过${.global.x} 来访问 setting 语法 Freemarker代码 <#setting name=value> <#setting name=value> 用来设置整个系统的一个环境 locale number_format boolean_format date_format , time_format , datetime_format time_zone classic_compatible 用例 假如当前是匈牙利的设置，然后修改成美国 Ftl代码 ${1.2} <#setting locale="en_US"> ${1.2} ${1.2} <#setting locale="en_US"> ${1.2} 输出 1,2 1.2 因为匈牙利是采用", "作为十进制的分隔符，美国是用". " macro, nested, return 语法 Freemarker代码 <#macro name param1 param2 ... paramN> ... <#nested loopvar1, loopvar2, ..., loopvarN> ... <#return> ... <#macro name param1 param2 ... paramN> ... <#nested loopvar1, loopvar2, ..., loopvarN> ... <#return> ... 用例 Ftl代码 <#macro test foo bar="Bar"[A2] baaz=-1> Test text, and the params: ${foo}, ${bar}, ${baaz} <@test foo="a" bar="b" baaz=5*5-2/> <@test foo="a" bar="b"/> <@test foo="a" baaz=5*5-2/> <@test foo="a"/> <#macro test foo bar="Bar"[A2] baaz=-1> Test text, and the params: ${foo}, ${bar}, ${baaz} <@test foo="a" bar="b" baaz=5*5-2/> <@test foo="a" bar="b"/> <@test foo="a" baaz=5*5-2/> <@test foo="a"/> 输出 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 定义循环输出的宏 Ftl代码 <#macro list title items> ${title?cap_first}: <#list items as x> *${x?cap_first} <@list items=["mouse", "elephant", "python"] title="Animals"/> <#macro list title items> ${title?cap_first}: <#list items as x> *${x?cap_first} <@list items=["mouse", "elephant", "python"] title="Animals"/> 输出结果: Animals: *Mouse *Elephant *Python 包含body 的宏 Ftl代码 <#macro repeat count> <#list 1..count as x> <#nested x, x/2, x==count> <@repeat count=4 ; c halfc last> ${c}. ${halfc}<#if last> Last! <#macro repeat count> <#list 1..count as x> <#nested x, x/2, x==count> <@repeat count=4 ; c halfc last> ${c}. ${halfc}<#if last> Last! 输出 1. 0.5 2. 1 3. 1.5 4. 2 Last! t, lt, rt 语法 Freemarkder代码 <#t> 去掉左右空白和回车换行 <#lt>去掉左边空白和回车换行 <#rt>去掉右边空白和回车换行 <#nt>取消上面的效果 <#t> 去掉左右空白和回车换行 <#lt>去掉左边空白和回车换行 <#rt>去掉右边空白和回车换行 <#nt>取消上面的效果 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 Ftl代码 <#if mouse?exists> Mouse found <#else> <#if mouse?exists> Mouse found <#else> 也可以直接${mouse?if_exists})输出布尔形 －－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－ （1）解决输出中文乱码问题： freemarker乱码的原因： 没有使用正确的编码格式读取模版文件,表现为模版中的中文为乱码 解决方法：在classpath上放置一个文件freemarker.properties，在里面写上模版文件的编码方式，比如 default_encoding=UTF-8 locale=zh_CN 注意：eclipse中除了xml文件、java文件外，默认的文件格式iso8859-1 数据插入模版时，没有使用正确的编码，表现出模版中的新插入数据为乱码 解决方法：在result的配置中，指定charset，s2的FreemarkerResult.java会将charset传递freemarker /pages/Person/view.ftl text/html;charset=UTF-8 （2）提高freemarker的性能 在freemarker.properties中设置： template_update_delay=60000 避免每次请求都重新载入模版，即充分利用cached的模版 （3）尽量使用freemarker本身的提供的tag，使用S2 tags 的标签会在性能上有所损失 （4）freemarker的标签种类： ${..}:FreeMarker will replace it in the output with the actual value of the thing in the curly brackets. They are called interpolation s. # ,代表是FTL tags（FreeMarker Template Language tags） ，hey are instructions to FreeMarker and will not be printed to the output <#if ...> <#list totalList as elementObject>... @ ,代表用户自定义的标签 <#-- --> 注释标签，注意不是<!-- --> （5）一些特殊的指令： r代表原样输出：${r"C:\foo\bar"} <#list ["winter", "spring", "summer", "autumn"] as x>${x} ？引出内置指令 String处理指令： html:特殊的html字符将会被转义，比如"<"，处理后的结果是< cap_first 、lower_case 、upper_case trim :除去字符串前后的空格 sequences处理指令 size ：返回sequences的大小 numbers处理指令 int:number的整数部分，(e.g. -1.9?int is -1) （6）对于null，或者miss value，freemarker会报错 ?exists:旧版本的用法 !：default value operator，语法结构为： unsafe_expr !default_expr，比如 ${mouse!"No mouse."} 当mouse不存在时，返回default value； (product.color)!"red" 这种方式，能够处理product或者color为miss value的情况； 而product.color!"red"将只处理color为miss value的情况 ??: Missing value test operator ,测试是否为missing value unsafe_expr ?? ：product.color??将只测试color是否为null (unsafe_expr )??：(product.color)??将测试product和color是否存在null Ftl代码 <#if mouse??> Mouse found <#else> No mouse found Creating mouse... <#assign mouse = "Jerry"> <#if mouse??> Mouse found <#else> No mouse found <#if mouse??> Mouse found <#else> No mouse found Creating mouse... <#assign mouse = "Jerry"> <#if mouse??> Mouse found <#else> No mouse found （7）模版值插入方式 （interpolation） 通用方式 （ Universal interpolations）： ${expression } 对于字符串：只是简单输出 对于数值，会自动根据local确定格式，称为human audience，否则称为computer audience，可以"?c", 比如， Details...,因此这里的id是给浏览器使用的，不需要进行格式化，注意?c只对数值有效 对于日期，会使用默认的日期格式转换，因此需要事先设置好默认的转换格式，包括date_format , time_format ，atetime_format 对于布尔值，不能输出，会报错并停止模版的执行，比如${a = 2} 会出错，但是可以 string built-in来进行转换 数值处理，具体参考：Built-ins for numbers http://freemarker.org/docs/ref_builtins_number.html#ref_builtin_string_for_number 数值处理的例子： <#setting number_format="currency"/> <#assign answer=42/> ${answer} ${answer?string} <#-- the same as ${answer} --> ${answer?string.number} ${answer?string.currency} ${answer?string.percent} 除了使用内置的formate，可以使用任何用Java decimal number format syntax 书写的formate，比如 <#setting number_format="0.###E0"/> <#setting number_format="0"/> <#setting number_format="#"/> ${1234} ${12345?string("0.####E0")} 更加方便的格式： <#setting locale="en_US"> US people writes: ${12345678?string(",##0.00")} <#setting locale="hu"> Hungarian people writes: ${12345678?string(",##0.00")} 日期处理，参考Built-ins for dates http://freemarker.org/docs/ref_builtins_date.html#ref_builtin_string_for_date 日期处理的例子： ${openingTime?string.short} ${openingTime?string.medium} ${openingTime?string.long} ${openingTime?string.full} ${nextDiscountDay?string.short} ${nextDiscountDay?string.medium} ${nextDiscountDay?string.long} ${nextDiscountDay?string.full} ${lastUpdated?string.short} ${lastUpdated?string.medium} ${lastUpdated?string.long} ${lastUpdated?string.full} 注意： 由于java语言中的Date类型的不足，freemarker不能根据Date变量判断出变量包含的部分（日期、时间还是全部），在这种情况下，freemarker 不能正确显示出${lastUpdated?string.short} 或者 simply ${lastUpdated}，因此，可以通过?date, ?time and ?datetime built-ins 来帮助freemarker来进行判断，比如${lastUpdated?datetime?string.short} 除了使用内置的日期转换格式外，可以自己指定日期的格式，使用的是Java date format syntax，比如： ${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')'")} 数值专用方式 （ Numerical interpolations）：#{expression } or #{expression ; format }，这是数值专用的输出方式，但是 最好使用通用方式的string built-in或者number_format 来完成转换，Numerical interpolations方式将会被停用 （8）创建自定义模版 Ftl代码 <#macro greet> Hello Joe! 评论这张 转发至微博