还在为HTML转PDF发愁?再介绍两款工具,为你保驾护航!

B站影视 韩国电影 2025-11-13 21:55 4

摘要:在之前专门写了一篇文章《 SpringBoot 集成:5分钟实现 Html 转 PDF 功能》,介绍三款 Html 转 PDF 的工具。这不,又发现了两款类似的工具,整理一下分享给大家。

【编程朝花夕拾】,可获取首发内容。

在之前专门写了一篇文章《 SpringBoot 集成:5分钟实现 Html 转 PDF 功能》,介绍三款 Html 转 PDF 的工具。这不,又发现了两款类似的工具,整理一下分享给大家。

iText pdfHTML 是 iText7 套件的一个附加组件,专门用于将 HTML 和 CSS 内容转换为 PDF 文档。它基于 iText 核心 PDF 生成引擎,提供了高质量的 HTML 到 PDF 转换功能。性能表现非常优异。 #后端 #Java #程序员 #每天一个知识点

主要特性:

完整的 HTML5 和 CSS3 支持 :能够处理现代网页布局和样式字体嵌入 :自动处理Web字体和系统字体响应式设计 :支持媒体查询和响应式布局高保真转换 :保持HTML内容的视觉保真度Java原生 :专为Java生态系统设计

GitHub 地址:github.com/itext/itext…

官方地址:itextpdf.com/products/co…

使用起来也非常简单,下面官方的案例:

Maven 依赖

com.itextpdfhtml2pdf6.2.1

实践代码

@RequestMapping("index6")public void index6(Model model, HttpServletResponse response) throws IOexception {List> list = new ArrayList;for (int i = 0; i item = new HashMap;item.put("image1", "http://example.com/2eb97.jpg");item.put("image2", "http://example.com/2f9c3.jpg");item.put("vehicleName", "路虎Defender[卫士](进口)2023款Defender130 48V[卫士 130 48V] 3.0T手自-体P400 HSE");item.put("brandName", "路虎");item.put("seriesName", "Defender[卫士]");item.put("modelYear", "2023款");item.put("licenseYear", SDF.format(new Date));item.put("displayMileage", DF.format(new BigDecimal("9657")));item.put("dealDate", SDF.format(new Date));item.put("dealPrice", DF.format(new BigDecimal("702400")));item.put("licenseCode", "沪 A952714");list.add(item); } model.addAttribute("list", list); Map map = new HashMap; map.put("list", list);Context context = new Context(Locale.getDefault, map); String htmlContent = templateEngine.process("index", context); System.out.println(htmlContent);// /*itext-html2pdf*/ ConverterProperties properties = new ConverterProperties;FontProvider fontProvider = new FontProvider; fontProvider.addSystemFonts; // fontProvider.addFont("C:\\Windows\\Fonts\\simhei.ttf"); // 添加系统字体 properties.setFontProvider(fontProvider);HtmlConverter.convertToPdf(htmlContent, response.getOutputStream, properties); }

同样默认是不支持中文的,需要通过 FontProvider 添加指定的字体。fontProvider.addSystemFonts; 直接添加系统字体,也可以通过 addFont 添加自定义字体。页面必须声明字体,否则会出现乱码。

x-easypdf 是一个 java 语言简化处理 pdf 的框架,包含 fop 模块与 pdfbox 模块,fop 模块以创建功能为主,基于 xsl-fo 模板生成 pdf 文档,以数据源的方式进行模板渲染;pdfbox 模块以编辑功能为主,对标准的 pdfbox 进行扩展,添加了成吨的功能。

Html 转 Pdf 是 pdfbox 模块下的一个转化器的功能,是基于 playwright 实现的。而 playwright 的依赖需要手动引入。Playwright 是一个跨语言的浏览器自动化库,由 Microsoft 开发。虽然主要用于端到端测试,但其强大的 PDF 生成功能也使其成为 HTML 转 PDF 的优秀工具。

Gitee 地址:gitee.com/dromara/x-e…

官网地址:x-easypdf.cn/

x-easypdf 是对 playwrigh 的功能做了一层包装,使用起来更方便。

Maven 依赖

org.dromarax-easypdf3.4.7com.microsoft.playwrightplaywright1.53.0

实践代码01

@RequestMapping("index10")public void index10(HttpServletResponse response) throws IOException {// 获取html转换器HtmlConvertor convertor = PdfHandler.getDocumentConvertor.getHtmlConvertor;Document pdf = convertor.toPdf("http://127.0.0.1:8080/page/index");pdf.save(response.getOutputStream);}

注意事项

playwrigh 是基于浏览器引擎的,首次调用会下载默认的浏览器,下载完成之后,后续的使用就流畅了。而且默认支持中文,因为使用浏览器引擎,所以对于 Html 和 Css 支持较好。但是消耗资源较高。

但是这里 convertor.toPdf 目前支持传入地址和文件。不支持直接 html 内容直接转化的。但是 playwrigh 本身是支持的。

小编已经给 x-easypdf 作者提了 issues :gitee.com/dromara/x-e…

注意:截止发稿,官方已经在 3.5.0 版本支持了 html 内容转 Pdf 。

实战代码02

使用模板引擎的方式:

官网地址:x-easypdf.cn/guide/pdfbo…

依然是建立在 playwrigh 基础之上。

@RequestMapping("index12")public void index12(HttpServletResponse response) throws IOException {List> list = new ArrayList;for (int i = 0; i item = new HashMap;item.put("image1", "http://example.com/2eb97.jpg");item.put("image2", "http://example.com/2f9c3.jpg");item.put("vehicleName", "路虎Defender[卫士](进口)2023款Defender130 48V[卫士 130 48V] 3.0T手自-体P400 HSE");item.put("brandName", "路虎");item.put("seriesName", "Defender[卫士]");item.put("modelYear", "2023款");item.put("licenseYear", SDF.format(new Date));item.put("displayMileage", DF.format(new BigDecimal("9657")));item.put("dealDate", SDF.format(new Date));item.put("dealPrice", DF.format(new BigDecimal("702400")));item.put("licenseCode", "沪 A952714");list.add(item); } Map map = new HashMap; map.put("list", list);ThymeleafTemplater templater = PdfHandler.getDocumentTemplater.getThymeleafTemplater; templater.setTemplatePath("templates"); templater.setTemplateName("index.html"); templater.setTemplateData(map);// 获取 html 内容 String content = templater.getHtmlContent; System.out.println(content);// 转换文档 Document document = templater.transform; document.save(response.getOutputStream); }

这里需要说明的是:由于 x-easypdf 自行解析了 Thymeleaf 模版,所以无法使用 spring-boot-starter-thymeleaf 的配置。templatePath 和 templateName 都需要写完整。templatePath 指 classpath 下的路径。

模板引擎可能会出现 nested exception is java.lang.NoClassDefFoundError: ognl/PropertyAccessor 的错误,需要引入 ognl ,且版本不能超过 3.2 。从 3.2 开始,会报 java.lang.NoClassDefFoundError: ognl/DefaultMemberAccess 。有效版本:

ognlognl3.1.28

边距可以通过打印样式控制:

@RequestMapping("index11")public void index11(HttpServletResponse response) throws IOException {try (Playwright playwright = Playwright.create;Browser browser = playwright.chromium.launch) {BrowserContext context = browser.newContext;Page page = context.newPage;// 从 HTML 内容生成 PDF page.setContent("

Hello, Playwright!

"); byte pdf = page.pdf;ByteArrayInputStream bais = new ByteArrayInputStream(pdf); IOUtils.copy(bais, response.getOutputStream); } }04 小结

iText pdfHTML 内存占用低,转换速度快,适合服务器端批量处理。而 Playwright 需要更多资源,但渲染质量极高,适合对视觉保真度要求高的场景,所以 x-easypdf 也是一样的。如果只是针对 Html 转 Pdf 的服务端转化的场景 iText pdfHTML 的优势更明显一下,关键它快!

也有粉丝朋友留言说 jasperreports 也很好用,小编也试了一下。jasperreports 需要加载特定的模板,也许是因为不是很熟悉,用起来感觉有点别扭。这里就不推荐了,有兴趣的可以去试试!

来源:墨码行者一点号

相关推荐