iText7高级教程之html2pdf——0.引言

作者：CuteXiaoKe
微信公众号：CuteXiaoKe

  Hello，everyone！好久不见，我又准备开新坑啦！旧坑基础块的介绍也同时更新，请大家放心，废话不多说，让我们赶紧开始吧。

整体介绍

  在本次教程中，我们将会学习如何使用pdfHTML来把HTML转换成PDF，这是iText 7的一个插件，如果你刚开始接触iText，那么可以直接跳跃到第一章。如果你之前使用过iText，那你可能记得旧的HTML转PDF的函数，那么你可以使用过废弃的HTMLWorker(iText 2)或者老旧的XML Worker插件(iText 5)。

  HTMLWorker类在很多年之前就被弃用了，HTMLWorker的目标就是把少量简单的HTML代码段转换成iText对象。它设计的初衷就不是用来把完整的HTML页面转换成PDF，虽然很多的开发者尝试用来这么干，但是这将导致大量的错误，因为HTMLWorker并不支持每个HTML标签，不能解析CSS文件，还有其他一些不足。为了避免这些错误，iText的近期的发布版本中把HTMLWorker移除了。

  在2011年，iText Group在iText5的基础上发布了XML Worker当做一种通用的XML转成PDF的工具。它提供了一种默认实现，它能把XHTML(数据)和CSS(样式)转换成PDF，把HTML标签例如<p>，<img>和<li>转换成iText5里面的对象例如Paragraph，Image和ListItem。我们并不知道其他用XML Worker来解析其他XML格式的文件，但是很多开发者使用XML Worker和jsoup一起来当做HTML2PDF的转换器。

  但是XML Worker并不是一个URL2PDF的工具。XML Worke希望的文件的是那种专门为转换成PDF的单一HTML文件。一种常见的用法是发票的创建。为了方便，开发者们不会使用Java或者C#编译语言来设计发票，他们更喜欢创建一个HTML模板定义文档的结构，和一些CSS文件来定义样式，然后使用数据来填充HTML文件，并且使用XML Worker来创建发票的PDF文档，最后抛弃原始的HTML文件。我们会在第4章进一步关注这个用户用例，使用XSLT在内存中转换XML成HTML，然后使用pdfTHML插件来转换HTML成PDF。

  当iText 5一开始被创建的时候，它设计的目标是当做一款能尽快产生PDF的工具，当页面完成的时候刷新页面元素到OutputStream。在iText第一次发布的时候，有几种的设计选择表现得很不错，这些设计理念在16年之后还存在iText 5中。但是，不幸的是，这些设计选择中的一部分会让XML Worker扩展它的功能来让开发者满意变得很困难。如果我们想要把一个功能强大的HTML转换PDF的转换器，那我们必须从头到尾重写iText，这也是我们所做的。

  在2016年，我们发布了iText 7，这是一个全新的iText版本，它不再与之前的版本兼容，但是它考虑到了pdfHTML。许多的工作被花费到新的Renderer框架。当一个文档使用iText7创建，它的渲染器和子渲染器的树形结构会被构建。通过遍历这课树来创建页面布局，这种方式在处理HTML转换成PDF的时候更加合适。同时iText对象重新设计来更好匹配HTML标签并且可以使用CSS的方式来定义样式。

  几个例子，在iText 5，你有一个PdfTable和一个PdfCell对象来创建一个表格和它的单元格。如果你想要每个单元格的字体不同于默认字体，你需要为每个单元格设置字体。在Text 7中，你有一个Table和Cell对象，当你设置区别于默认字体的字体到整个表格的时候，每个单元格将会继承整个字体。这是在架构设计方面重要的一步，尤其是目标是转换HTML到PDF。

  总之，让我们不要停留在过去，让我们看看pdfHTML能为我们做些什么。在第一章节，我们会关注converToPdf()方法一些变更题，然后我们会发现转换器如果被配置。总体章节架构如下：

• 章节1：Hello HTML To PF
• 章节2：使用CSS定义样式
• 章节3：使用媒体查询创建PDF
• 章节4：使用pdfHTML创建报表
• 章节5：自定义标签工作体和CSS填充器
• 章节6：在pdfHTML中使用字体
• 章节7：关于pdfHTML常见的问题

本章代码资源下载地址：

1. 关注我的微信公众号CuteXiaoKe，点击代码资源-iText官网代码即可
2. 或者直接点击微信文章