Java實現(xiàn)HTML轉PDF的兩款工具(itext-pdfhtml和x-easypdf)介紹與使用
01 引言
之前在前文中介紹了三款Html轉PDF的工具。這不，又發(fā)現(xiàn)了兩款類似的工具，整理一下分享給大家。
02 itext-pdfhtml-java
2.1 簡介
iText pdfHTML是iText7套件的一個附加組件，專門用于將HTML和CSS內(nèi)容轉換為PDF文檔。它基于iText核心PDF生成引擎，提供了高質(zhì)量的HTML到PDF轉換功能。性能表現(xiàn)非常優(yōu)異。
主要特性：
- 完整的
HTML5和CSS3支持：能夠處理現(xiàn)代網(wǎng)頁布局和樣式 - 字體嵌入：自動處理Web字體和系統(tǒng)字體
- 響應式設計：支持媒體查詢和響應式布局
- 高保真轉換：保持HTML內(nèi)容的視覺保真度
- Java原生：專為Java生態(tài)系統(tǒng)設計
GitHub地址：github.com/itext/itext-pdfhtml-java
官方地址：itextpdf.com/products/convert-html-css-to-pdf-pdfhtml
2.2 案例
使用起來也非常簡單，下面官方的案例：
Maven依賴：
<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>html2pdf</artifactId>
<version>6.2.1</version>
</dependency>
實踐代碼：
@RequestMapping("index6")
public void index6(Model model, HttpServletResponse response) throws IOException {
List<Map<String, Object>> list = new ArrayList<>();
for (int i = 0; i < 3; i++) {
Map<String, Object> item = new HashMap<>();
item.put("image1", "http://example.com/2eb97.jpg");
item.put("image2", "http://example.com/2f9c3.jpg");
item.put("vehicleName", "路虎Defender［衛(wèi)士］（進口）2023款Defender130 48V［衛(wèi)士 130 48V] 3.0T手自－體P400 HSE");
item.put("brandName", "路虎");
item.put("seriesName", "Defender［衛(wèi)士］");
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<String, Object> 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");
// 添加系統(tǒng)字體
properties.setFontProvider(fontProvider);
HtmlConverter.convertToPdf(htmlContent, response.getOutputStream(), properties);
}
同樣默認是不支持中文的，需要通過FontProvider添加指定的字體。fontProvider.addSystemFonts();直接添加系統(tǒng)字體，也可以通過addFont()添加自定義字體。頁面必須聲明字體，否則會出現(xiàn)亂碼。
03 x-easypdf
3.1 簡介
x-easypdf是一個java語言簡化處理pdf的框架，包含fop模塊與pdfbox模塊，fop模塊以創(chuàng)建功能為主，基于xsl-fo模板生成pdf文檔，以數(shù)據(jù)源的方式進行模板渲染；pdfbox模塊以編輯功能為主，對標準的pdfbox進行擴展，添加了成噸的功能。
Html轉Pdf是pdfbox模塊下的一個轉化器的功能，是基于 playwright 實現(xiàn)的。而playwright的依賴需要手動引入。Playwright是一個跨語言的瀏覽器自動化庫，由Microsoft開發(fā)。雖然主要用于端到端測試，但其強大的PDF生成功能也使其成為HTML轉PDF的優(yōu)秀工具。
Gitee地址：gitee.com/dromara/x-easypdf
官網(wǎng)地址：x-easypdf.cn/
3.2 案例
x-easypdf是對playwrigh的功能做了一層包裝，使用起來更方便。
Maven依賴
<dependency>
<groupId>org.dromara</groupId>
<artifactId>x-easypdf</artifactId>
<version>3.4.7</version>
</dependency>
<dependency>
<groupId>com.microsoft.playwright</groupId>
<artifactId>playwright</artifactId>
<version>1.53.0</version>
</dependency>
實踐代碼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是基于瀏覽器引擎的，首次調(diào)用會下載默認的瀏覽器，下載完成之后，后續(xù)的使用就流暢了。而且默認支持中文，因為使用瀏覽器引擎，所以對于Html和Css支持較好。但是消耗資源較高。
但是這里convertor.toPdf()目前支持傳入地址和文件。不支持直接html內(nèi)容直接轉化的。但是playwrigh本身是支持的。
小編已經(jīng)給x-easypdf作者提了issues：gitee.com/dromara/x-e…
**注意：**截止發(fā)稿，官方已經(jīng)在3.5.0版本支持了html內(nèi)容轉Pdf。
實戰(zhàn)代碼02
使用模板引擎的方式：
官網(wǎng)地址：x-easypdf.cn/guide/pdfbox/advance/templater
依然是建立在playwrigh基礎之上。
@RequestMapping("index12")
public void index12(HttpServletResponse response) throws IOException {
List<Map<String, Object>> list = new ArrayList<>();
for (int i = 0; i < 3; i++) {
Map<String, Object> item = new HashMap<>();
item.put("image1", "http://example.com/2eb97.jpg");
item.put("image2", "http://example.com/2f9c3.jpg");
item.put("vehicleName", "路虎Defender［衛(wèi)士］（進口）2023款Defender130 48V［衛(wèi)士 130 48V] 3.0T手自－體P400 HSE");
item.put("brandName", "路虎");
item.put("seriesName", "Defender［衛(wèi)士］");
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<String, Object> map = new HashMap<>();
map.put("list", list);
ThymeleafTemplater templater = PdfHandler.getDocumentTemplater().getThymeleafTemplater();
templater.setTemplatePath("templates");
templater.setTemplateName("index.html");
templater.setTemplateData(map);
// 獲取 html 內(nèi)容
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下的路徑。
模板引擎可能會出現(xiàn)nested exception is java.lang.NoClassDefFoundError: ognl/PropertyAccessor的錯誤，需要引入ognl，且版本不能超過3.2。從 3.2 開始，會報java.lang.NoClassDefFoundError: ognl/DefaultMemberAccess。有效版本：
<dependency> <groupId>ognl</groupId> <artifactId>ognl</artifactId> <version>3.1.28</version> </dependency>
邊距可以通過打印樣式控制：
@page {
size: A4;
margin: 20px;
}
3.3playwrigh原生寫法
@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內(nèi)容生成PDF
page.setContent("<h1>Hello, Playwright!</h1>");
byte[] pdf = page.pdf();
ByteArrayInputStream bais = new ByteArrayInputStream(pdf);
IOUtils.copy(bais, response.getOutputStream());
}
}
04 小結
iText pdfHTML內(nèi)存占用低，轉換速度快，適合服務器端批量處理。而Playwright需要更多資源，但渲染質(zhì)量極高，適合對視覺保真度要求高的場景，所以x-easypdf也是一樣的。如果只是針對Html轉Pdf的服務端轉化的場景iText pdfHTML的優(yōu)勢更明顯一下，關鍵它快！
也有粉絲朋友留言說jasperreports也很好用，小編也試了一下。jasperreports需要加載特定的模板，也許是因為不是很熟悉，用起來感覺有點別扭。這里就不推薦了，有興趣的可以去試試！
以上就是Java實現(xiàn)HTML轉PDF的兩款工具(itext-pdfhtml和x-easypdf)介紹與使用的詳細內(nèi)容，更多關于Java HTML轉PDF的資料請關注腳本之家其它相關文章！
相關文章
這篇文章主要介紹了關于SpringBoot中的XA事務詳解,事務管理可以確保數(shù)據(jù)的一致性和完整性，同時也可以避免數(shù)據(jù)丟失和沖突等問題。在分布式環(huán)境中，XA?事務是一種常用的事務管理方式,需要的朋友可以參考下2023-07-07
Java中隊列Queue和Deque的區(qū)別與代碼實例
學過數(shù)據(jù)結構的,一定對隊列不陌生,java也實現(xiàn)了隊列,下面這篇文章主要給大家介紹了關于Java中隊列Queue和Deque區(qū)別的相關資料,需要的朋友可以參考下2021-08-08
Springboot3整合Elasticsearch8(elasticsearch-java)最佳實踐
文章推薦使用Elasticsearch官方新客戶端（ElasticsearchJavaAPIClient）替代已廢棄的RestHighLevelClient,對比SpringDataElasticsearch和easy-es的優(yōu)缺點,詳解SpringBoot3整合步驟及高階用法,強調(diào)新客戶端功能全且適配最新版本,感興趣的朋友一起看看吧2025-07-07
這篇文章主要介紹了史上最全的IDEA快捷鍵總結，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2020-01-01
Java中File.exists()方法用于檢查文件或目錄是否存在,是文件操作的前置檢查工具,這篇文章主要介紹了Java之exists()方法的相關資料,文中通過代碼介紹的非常詳細,需要的朋友可以參考下2025-07-07
Java?file.delete刪除文件失敗,Windows磁盤出現(xiàn)無法訪問的文件問題
