SpringBoot+Thymeleaf實現(xiàn)生成PDF文檔

更新時間：2022年09月16日 14:40:22 作者：小甘說碼

Thymeleaf是一個現(xiàn)代的服務器端?Java?模板引擎，適用于?Web?和獨立環(huán)境。Thymeleaf?的主要目標是為您的開發(fā)工作流程帶來優(yōu)雅的自然模板，本文就來用它實現(xiàn)生成PDF，感興趣的可以了解一下

前言

溫馨提示：本博客使用Thymeleaf模板引擎實現(xiàn)PDF打印僅供參考：

在閱讀該博客之前，先要了解一下Thymeleaf模板引擎，因為是使用Thymeleaf模板引擎實現(xiàn)的PDF打印的，

Thymeleaf是一個現(xiàn)代的服務器端 Java 模板引擎，適用于 Web 和獨立環(huán)境。

Thymeleaf 的主要目標是為您的開發(fā)工作流程帶來優(yōu)雅的自然模板——HTML可以在瀏覽器中正確顯示，也可以用作靜態(tài)原型，從而在開發(fā)團隊中實現(xiàn)更強大的協(xié)作。

借助 Spring Framework 的模塊、與您最喜歡的工具的大量集成以及插入您自己的功能的能力，Thymeleaf 是現(xiàn)代 HTML5 JVM Web 開發(fā)的理想選擇——盡管它可以做的更多。

不了解小伙伴可以去Thymeleaf官網(wǎng)查看，有更詳細的講解。

接下來就不一一介紹了，直接上代碼。

一、引入依賴

1.Thymeleaf，生成PDF相關(guān)依賴

1.1 以下依賴為必要依賴，一個都不能少，依賴version可以根基實際情況使用相關(guān)的依賴版本。

二、application.yml配置

1.yml配置文件

yml配置文件使用配置thymeleaf模板路徑（示例）：

以上相關(guān)為基礎且必須配置的內(nèi)容，接下來繼續(xù)講解thymeleaf引擎需要生成PDF的相關(guān)配置。

三、PDF相關(guān)配置

1.PDF配置代碼（如下）：

package com.cy.xgsm.configuration;

import java.io.IOException;
import java.io.InputStream;
import java.net.URISyntaxException;

import org.apache.commons.io.IOUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import com.itextpdf.html2pdf.ConverterProperties;
import com.itextpdf.html2pdf.resolver.font.DefaultFontProvider;
import com.itextpdf.io.font.PdfEncodings;
import com.itextpdf.kernel.font.PdfFont;
import com.itextpdf.kernel.font.PdfFontFactory;
import com.itextpdf.layout.font.FontProvider;
import com.cy.xgsm.controller.PrintPdfController;

/**
 * 
 * @author Dylan
 * PDF相關(guān)配置
 */
@Configuration
public class PdfConfiguration {
	
	private static final Logger log = LoggerFactory.getLogger(PdfConfiguration.class);
	
	@Bean
	public FontProvider getFontProvider() throws URISyntaxException, IOException {
		FontProvider provider = new DefaultFontProvider(true, true, false);
		byte[] bs = null;
		//SIMSUN.TTC為字體
		try (InputStream in = PrintPdfController.class.getClassLoader().getResourceAsStream("font/SIMSUN.TTC")) {
			bs = IOUtils.toByteArray(in);
		}		
		PdfFont pdfFont = PdfFontFactory.createTtcFont(bs, 1, PdfEncodings.IDENTITY_H, false, true);
		provider.addFont(pdfFont.getFontProgram());
		return provider;
	}
	
	@Bean
	public ConverterProperties converterProperties(FontProvider fontProvider, Configuration config) {
		ConverterProperties cp = new ConverterProperties();
		cp.setBaseUri(config.getPdfUrl());
		try {
			cp.setFontProvider(fontProvider);
		} catch (Exception e) {
			log.error("打印PDF時未能添加字體", e);
		}
		return cp;
	}
	
}

注意PDF配置需要添加打印PDF字體，SIMSUN.TTC為打印需要的字體，但是也可以是其他的

四、Controller

1.以上所有的相關(guān)配置信息都配置完了，接下來就可以寫Api接口了

package com.cy.xgsm.controller;

import java.io.IOException;
import java.io.OutputStream;
import java.net.URLEncoder;

import javax.servlet.http.HttpServletResponse;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.thymeleaf.TemplateEngine;
import org.thymeleaf.context.Context;

import com.itextpdf.html2pdf.ConverterProperties;
import com.itextpdf.html2pdf.HtmlConverter;
import com.itextpdf.kernel.geom.PageSize;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.cy.xgsm.common.Result;
import com.cy.xgsm.model.OrderInfo;
import com.cy.xgsm.service.OrderInfoService;

/**
 * 打印PDF 控制接入層
 * 
 * @author Dylan
 *
 */
@Controller
@RequestMapping("print")
public class PrintPdfController {
	
    private static final Logger log = LoggerFactory.getLogger(PrintPdfController.class);
    
	@Autowired
	private OrderInfoService service;
	//thymeleaf模板引擎
    @Autowired
    TemplateEngine templateEngine;
	//html轉(zhuǎn)換成pdf需要使用ConverterProperties
    @Autowired
    ConverterProperties converterProperties;    
	
    @GetMapping("order/{orderId}.pdf")
	public void orderPdf(@PathVariable Long orderId, HttpServletResponse resp) throws IOException {
		Result<OrderInfo> result = service.selectByPrimaryKey(orderId);
		if (!result.isComplete()) {
            resp.sendError(404, "訂單ID不存在");
        }
        Context context = new Context();
        context.setVariable("order", result.getData());
		///html/pdf/order-template為打印模板紙張路徑
        processPdf(context, "/html/pdf/order-template", result.getData().getKddh(), resp);
		
	}

	/**
	 * 調(diào)用生成PDF
	 * @param context 上下文
	 * @param template 模板文件
	 * @param filename 文件名
	 * @param resp
	 */
	private void processPdf(Context context, String template, String filename, HttpServletResponse resp) throws IOException {
        log.info("生成PDF：" + filename);
        String html = templateEngine.process(template, context);
        String filenameEncoded = URLEncoder.encode(filename, "utf-8");
        resp.setContentType("application/pdf");
        resp.setHeader("Content-Disposition", "filename=" + filenameEncoded + ".pdf");
        try (OutputStream out = resp.getOutputStream()) {
            PdfDocument doc = new PdfDocument(new PdfWriter(out));
			//打印使用什么什么紙張可根據(jù)實際情況，我這里默認使用A4
            doc.setDefaultPageSize(PageSize.A4.rotate());
            HtmlConverter.convertToPdf(html, doc, converterProperties);
        }
		
	}

}

1.請求接口報錯解決方式：

如果在請求接口的時候發(fā)生以下錯誤信息是打印模板的路徑錯誤了。