基于JAVA实现基于“obj--html--pdf” 的PDF格式文本生成

背景：

因一个特定的项目需要，将java对象内容以特定样式的PDF格式输出，查看了很多文档，有收费的、免费的、基础集成的。收费的工具就表现突出，免费的工具基本很难满足需求，故着手采用基础集成方案。过程中尝试了很多中技术组合，最后根据个人调试效果选择了"thymeleaf+htmltopdf"组合方案。

HTML转PDF效果：

材料：

1、基础JAVA环境

2、测试数据：

{"newspaper_name":"每日新闻","issue_number":"1024","issue_date":"2025年07月17日","editor_in_chief":"王主编","current_year":2025,"contact_info":{"address":"北京市朝阳区新闻大厦18层","phone":"010-12345678","email":"info@dailynews.com"},"headline_news":{"title":"国家发布新一代人工智能发展规划","reporter":"张科技","time":"今天 08:15","image":"E:\\HtmlToPdf\\templates\\assets\\images\\headline.jpg","content":"\n                <p>国务院近日印\r\n发《新一代人工智能发展规划》，提出到2030年使中国人工智能理论、技术与应用总体达到世界领先水平，成为世界主要人工智能创新中心。</p>\n                <p>规划明 \r\n确了我国新一代人工智能发展的战略目标：到2020年人工智能总体技术和应用与世界先进水平同步；到2025年人工智能基础理论实现重大突破；到2030年人工智能理论、技术与应\r\n用总体达到世界领先水平。</p>\n                <p>规划还提出建立开放协同的人工智能科技创新体系，培育高端高效的智能经济，建设安全便捷的智能社会等六大重点任务 \r\n。</p>\n            "},"regular_news":[{"title":"本市地铁新线路今日开通试运营","reporter":"李交通","time":"今天 07:30","image":"E:\\HtmlToPdf\\templates\\assets\\images\\subway.jpg","content":"\n                    <p>经过四年建设，本市地铁14号线西段今日正式开通试运营。该线路全长16.5公里，设站8座，连\r\n接了多个商业区和居民区，将极大缓解西部城区的交通压力。</p>\n                    <p>地铁运营公司表示，试运营初期发车间隔为6分钟，未来将根据客流情况逐步缩短间\r\n隔时间。首班车时间为5:30，末班车时间为23:00。</p>\n                "},{"title":"夏季旅游旺季来临 景区推出多项优惠","reporter":"赵旅游","time":"昨天 18:45","content":"\n                    <p>随着暑期来临，我市各大旅游景区迎来旅游旺季。为吸引游客，多家景区推出门票优惠活动。</p>\n                    <p>其\r\n中，著名5A级景区长城从即日起至8月31日，对全日制学生实行半价优惠；本市居民凭身份证可享受8折优惠。此外，多家景区还推出了夜游项目，丰富游客体验。</p>\n        \r\n        "}],"special_report":{"title":"乡村振兴战略实施五周年成果展","content":"\n                <p>今年是乡村振兴战略实施五周年。五年来，我市农村面貌\r\n发生显著变化，农民收入持续增长，农业现代化水平明显提高。</p>\n                <p>据统计，五年来我市农村居民人均可支配收入年均增长8.5%，高于城镇居民收入增速 \r\n；农村基础设施显著改善，所有行政村实现通硬化路、通宽带；特色农业发展迅速，形成了一批知名农产品品牌。</p>\n                <p>下一步，我市将重点推进乡村产业 \r\n振兴、人才振兴、文化振兴、生态振兴和组织振兴，让农村成为安居乐业的美丽家园。</p>\n            ","images":[{"url":"E:\\HtmlToPdf\\templates\\assets\\images\\country1.jpg","caption":"美丽乡村建设成果"},{"url":"E:\\HtmlToPdf\\templates\\assets\\images\\country2.jpg","caption":"现代化农业大棚"},{"url":"E:\\HtmlToPdf\\templates\\assets\\images\\country3.jpg","caption":"乡村旅游新业态"}]}}

制作：

1、在java项目的pom.xml中添加如下配置

        <dependency><groupId>org.thymeleaf</groupId><artifactId>thymeleaf</artifactId><version>3.1.1.RELEASE</version></dependency><dependency><groupId>io.woo</groupId><artifactId>htmltopdf</artifactId><version>1.0.8</version><scope>compile</scope></dependency>

解释：我们是利用thymeleaf 包进行java对象与HTML模板的赋值匹配

2、编写thymeleaf 风格的HTML模板（如下，注意参数格式不是{{}}，而是${}）

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
<head><meta charset="UTF-8"/><title th:text="${newspaper_name} + ' - ' + ${issue_date}">报纸名称 - 日期</title></head>
<body><header class="newspaper-header"><div class="header-content"><h1 th:text="${newspaper_name}">报纸名称</h1><div class="issue-info"><span>第 <span th:text="${issue_number}">期号</span> 期</span><span th:text="${issue_date}">日期</span><span>总编辑: <span th:text="${editor_in_chief}">总编辑姓名</span></span></div></div></header><main class="content-container"><!-- 头条新闻 --><section class="headline-news"><h2 class="section-title">今日头条</h2><article class="headline-article"><div class="headline-image"><img th:src="${headline_news.image}" th:alt="${headline_news.title}" src="placeholder.jpg"/></div><div class="headline-content"><h3 th:text="${headline_news.title}">头条标题</h3><p class="news-meta"><span class="reporter">记者: <span th:text="${headline_news.reporter}">记者姓名</span></span><span class="publish-time" th:text="${headline_news.time}">发布时间</span></p><div class="news-content" th:utext="${headline_news.content}">头条新闻内容</div></div></article></section><!-- 新闻列表 --><section class="news-list"><h2 class="section-title">新闻速递</h2><article class="news-item" th:each="news : ${regular_news}"><h3 th:text="${news.title}">新闻标题</h3><p class="news-meta"><span class="reporter">记者: <span th:text="${news.reporter}">记者姓名</span></span><span class="publish-time" th:text="${news.time}">发布时间</span></p><div class="news-image" th:if="${news.image}"><img th:src="${news.image}" th:alt="${news.title}" src="placeholder.jpg"/></div><div class="news-content" th:utext="${news.content}">新闻内容</div></article></section><!-- 专题报道 --><section class="special-report" th:if="${special_report}"><h2 class="section-title">专题报道</h2><article class="special-article"><h3 th:text="${special_report.title}">专题标题</h3><div class="report-content" th:utext="${special_report.content}">专题内容</div><div class="report-gallery" th:if="${special_report.images}"><div class="gallery-item" th:each="image : ${special_report.images}"><img th:src="${image.url}" th:alt="${image.caption}" src="placeholder.jpg"/><p class="image-caption" th:text="${image.caption}">图片说明</p></div></div></article></section></main><footer class="newspaper-footer"><p>地址: <span th:text="${contact_info.address}">地址</span> | 电话: <span th:text="${contact_info.phone}">电话</span> | 邮箱: <span th:text="${contact_info.email}">邮箱</span></p><p>版权所有 &copy; <span th:text="${newspaper_name}">报纸名称</span> <span th:text="${current_year}">年份</span></p></footer>
</body>
</html>

3、模板对应的css样式

/* 基础样式 */
body {font-family: "SimSun", "宋体", serif;line-height: 1.6;color: #333333;margin: 0;padding: 0;font-size: 14px;
}/* 报头样式 */
.newspaper-header {background-color: #8B0000;color: white;padding: 15px 0;text-align: center;border-bottom: 3px solid #DAA520;
}.header-content h1 {font-size: 36px;margin: 0;font-weight: bold;letter-spacing: 2px;
}.issue-info {margin-top: 10px;font-size: 14px;
}.issue-info span {margin: 0 10px;
}/* 内容容器 */
.content-container {padding: 20px;width: 1000px;margin: 0 auto;
}.section-title {font-size: 22px;border-bottom: 2px solid #8B0000;padding-bottom: 5px;color: #8B0000;margin: 25px 0 15px;
}/* 头条新闻 */
.headline-news {margin-bottom: 30px;
}.headline-article {display: block;margin-top: 15px;overflow: hidden;
}.headline-image {float: left;width: 30%;margin-right: 20px;
}.headline-image img {width: 100%;height: auto;border: 1px solid #dddddd;
}.headline-content {float: left;width: 65%;
}.headline-content h3 {font-size: 20px;margin-top: 0;color: #222222;
}/* 常规新闻 */
.news-item {margin-bottom: 25px;padding-bottom: 15px;border-bottom: 1px dashed #cccccc;
}.news-item h3 {font-size: 18px;color: #444444;margin-bottom: 5px;
}.news-meta {color: #666666;font-size: 12px;margin: 5px 0;
}.news-meta span {margin-right: 15px;
}.news-image {margin: 10px 0;
}.news-image img {max-width: 100%;height: auto;border: 1px solid #dddddd;
}.news-content {text-align: justify;text-indent: 2em;
}/* 专题报道 */
.special-report {background-color: #f9f9f9;padding: 15px;margin-top: 30px;border: 1px solid #dddddd;
}.special-article h3 {font-size: 20px;color: #8B0000;text-align: center;
}.report-content {text-align: justify;margin: 15px 0;
}.report-gallery {display: block;margin: 20px 0;overflow: hidden;
}.gallery-item {float: left;width: 30%;margin-right: 3%;margin-bottom: 15px;
}.gallery-item img {width: 100%;height: auto;border: 1px solid #dddddd;
}.image-caption {font-size: 12px;color: #666666;text-align: center;margin-top: 5px;font-style: italic;
}/* 清除浮动 */
.clearfix:after {content: ".";display: block;height: 0;clear: both;visibility: hidden;
}/* 页脚 */
.newspaper-footer {text-align: center;padding: 15px;background-color: #f5f5f5;font-size: 12px;color: #666666;border-top: 1px solid #dddddd;margin-top: 30px;
}

4、编写PdfGenerator类

package com.powerbridge.pbplatformcarouteserver.utils;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Map;import org.thymeleaf.TemplateEngine;
import org.thymeleaf.context.Context;
import org.thymeleaf.templateresolver.FileTemplateResolver;import cn.hutool.json.JSONUtil;
import io.woo.htmltopdf.HtmlToPdf;
import io.woo.htmltopdf.HtmlToPdfObject;public class PdfGenerator {private final String templateDir;private final TemplateEngine templateEngine;public PdfGenerator(String templateDir) {this.templateDir = templateDir.endsWith(File.separator) ? templateDir : templateDir + File.separator;this.templateEngine = initializeTemplateEngine();}private TemplateEngine initializeTemplateEngine() {FileTemplateResolver templateResolver = new FileTemplateResolver();templateResolver.setPrefix(this.templateDir);templateResolver.setSuffix(".html");templateResolver.setTemplateMode("HTML");templateResolver.setCharacterEncoding("UTF-8");templateResolver.setCacheable(false);TemplateEngine engine = new TemplateEngine();engine.setTemplateResolver(templateResolver);return engine;}public void generatePdfFromTemplate(String templateName,Map<String, Object> context,String outputPath,String[] cssFiles) throws IOException {// Process the template with ThymeleafContext thymeleafContext = new Context();thymeleafContext.setVariables(context);String processedTemplateName = templateName.endsWith(".html") ? templateName.substring(0, templateName.length() - 5) : templateName;String renderedHtml = templateEngine.process(processedTemplateName, thymeleafContext);// Generate PDFtry (OutputStream outputStream = new FileOutputStream(outputPath)) {
//            ITextRenderer renderer = new ITextRenderer();Path basePath = Paths.get(templateDir).toAbsolutePath();// Add CSS if provided - CORRECTED APPROACHif (cssFiles != null) {for (String cssFile : cssFiles) {File css = new File(cssFile);if (css.exists()) {// Correct way to add CSS - embed it directly in the HTMLrenderedHtml = renderedHtml.replace("</head>", "<style type=\"text/css\">" +new String(Files.readAllBytes(css.toPath())) +"</style></head>");}}// Re-set the document with CSS includedSystem.out.println(renderedHtml);boolean success = HtmlToPdf.create().object(HtmlToPdfObject.forHtml(renderedHtml)).convert(outputPath);}} catch (Exception e) {throw new IOException("Failed to generate PDF: " + e.getMessage(), e);}}}

6、测试main函数

    public static void main(String[] args) {try {String worksPath="E:/HtmlToPdf/";PdfGenerator generator = new PdfGenerator(worksPath);String context = "{\"newspaper_name\":\"每日新闻\",\"issue_number\":\"1024\",\"issue_date\":\"2025年07月17日\",\"editor_in_chief\":\"王主编\",\"current_year\":2025,\"contact_info\":{\"address\":\"北京市朝阳区新闻大厦18层\",\"phone\":\"010-12345678\",\"email\":\"info@dailynews.com\"},\"headline_news\":{\"title\":\"国家发布新一代人工智能发展规划\",\"reporter\":\"张科技\",\"time\":\"今天 08:15\",\"image\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\headline.jpg\",\"content\":\"\\n                <p>国务院近日印\\r\\n发《新一代人工智能发展规划》，提出到2030年使中国人工智能理论、技术与应用总体达到世界领先水平，成为世界主要人工智能创新中心。</p>\\n                <p>规划明 \\r\\n确了我国新一代人工智能发展的战略目标：到2020年人工智能总体技术和应用与世界先进水平同步；到2025年人工智能基础理论实现重大突破；到2030年人工智能理论、技术与应\\r\\n用总体达到世界领先水平。</p>\\n                <p>规划还提出建立开放协同的人工智能科技创新体系，培育高端高效的智能经济，建设安全便捷的智能社会等六大重点任务 \\r\\n。</p>\\n            \"},\"regular_news\":[{\"title\":\"本市地铁新线路今日开通试运营\",\"reporter\":\"李交通\",\"time\":\"今天 07:30\",\"image\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\subway.jpg\",\"content\":\"\\n                    <p>经过四年建设，本市地铁14号线西段今日正式开通试运营。该线路全长16.5公里，设站8座，连\\r\\n接了多个商业区和居民区，将极大缓解西部城区的交通压力。</p>\\n                    <p>地铁运营公司表示，试运营初期发车间隔为6分钟，未来将根据客流情况逐步缩短间\\r\\n隔时间。首班车时间为5:30，末班车时间为23:00。</p>\\n                \"},{\"title\":\"夏季旅游旺季来临 景区推出多项优惠\",\"reporter\":\"赵旅游\",\"time\":\"昨天 18:45\",\"content\":\"\\n                    <p>随着暑期来临，我市各大旅游景区迎来旅游旺季。为吸引游客，多家景区推出门票优惠活动。</p>\\n                    <p>其\\r\\n中，著名5A级景区长城从即日起至8月31日，对全日制学生实行半价优惠；本市居民凭身份证可享受8折优惠。此外，多家景区还推出了夜游项目，丰富游客体验。</p>\\n        \\r\\n        \"}],\"special_report\":{\"title\":\"乡村振兴战略实施五周年成果展\",\"content\":\"\\n                <p>今年是乡村振兴战略实施五周年。五年来，我市农村面貌\\r\\n发生显著变化，农民收入持续增长，农业现代化水平明显提高。</p>\\n                <p>据统计，五年来我市农村居民人均可支配收入年均增长8.5%，高于城镇居民收入增速 \\r\\n；农村基础设施显著改善，所有行政村实现通硬化路、通宽带；特色农业发展迅速，形成了一批知名农产品品牌。</p>\\n                <p>下一步，我市将重点推进乡村产业 \\r\\n振兴、人才振兴、文化振兴、生态振兴和组织振兴，让农村成为安居乐业的美丽家园。</p>\\n            \",\"images\":[{\"url\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\country1.jpg\",\"caption\":\"美丽乡村建设成果\"},{\"url\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\country2.jpg\",\"caption\":\"现代化农业大棚\"},{\"url\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\country3.jpg\",\"caption\":\"乡村旅游新业态\"}]}}";Map<String, Object> contextObj = JSONUtil.parseObj(context,true).toBean(Map.class,true);generator.generatePdfFromTemplate("templates/newsjava.html",contextObj,worksPath+"/daily_news_java.pdf",new String[]{worksPath+"templates/assets/css/news.css"});} catch (Exception e) {System.err.println("Error generating PDF:");e.printStackTrace();}}

注意：1、如果直接cp上面的代码，需要在windows 系统的E盘下逐层创建 “E:\HtmlToPdf\templates\assets\css\”目录，并将上面的css 样式代码贴到当前目录新建的news.css文件。

2、逐层创建“E:\HtmlToPdf\templates\assets\images\”目录并在其目录下存入对应图片文件

3、逐层创建“E:\HtmlToPdf\templates\”目录并在其目录下创建名为“newsjava.html”的模板文件并将上面的HTML 内容贴到里面

6、修改PdfGenerator 类头的package com.powerbridge.pbplatformcarouteserver.utils;引用即可。

7、将上面的main函数直接贴到PdfGenerator中即可运行