Spring Boot集成OpenPDF实现PDF导出功能

最新推荐文章于 2025-04-04 04:28:06 发布

missterzy

最新推荐文章于 2025-04-04 04:28:06 发布

阅读量1.9k

点赞数 11

分类专栏： JAVA框架文章标签： spring boot pdf OpenPDF

本文链接：https://blog.youkuaiyun.com/weixin_53391173/article/details/141824306

版权

JAVA框架专栏收录该内容

87 篇文章

订阅专栏

如果你想要在Spring Boot项目中使用OpenPDF来生成PDF文件，而不是iText，你可以通过将HTML转换成PDF的方式来实现。OpenPDF是一个开源的Java PDF库，它基于iText 5.x版本，但是它主要提供了HTML到PDF的转换能力。

下面是如何在Spring Boot项目中设置并使用OpenPDF来生成PDF文件的一个简单教程。

1. 引言

PDF文件因其跨平台兼容性和格式的稳定性而在商业文档中广泛使用。使用Spring Boot集成OpenPDF库可以方便地将HTML、JSON或其他数据源转换为PDF格式，以供下载或打印。

2. 准备工作

2.1 添加依赖

首先，在你的pom.xml文件中添加OpenPDF的依赖：

<dependency>
    <groupId>com.github.openpdf</groupId>
    <artifactId>openpdf</artifactId>
    <version>1.3.14</version>
</dependency>

2.2 创建实体类

假设我们有一个简单的Invoice实体类，用于存储发票信息：

import java.time.LocalDate;

public class Invoice {

    private String invoiceNumber;
    private LocalDate issueDate;
    private String customerName;
    private double totalAmount;

    // 构造器、getter和setter...

    public Invoice(String invoiceNumber, LocalDate issueDate, String customerName, double totalAmount) {
        this.invoiceNumber = invoiceNumber;
        this.issueDate = issueDate;
        this.customerName = customerName;
        this.totalAmount = totalAmount;
    }

    // Getter and setter methods...
}

3. 创建HTML模板

为了将数据转换为PDF文件，我们需要创建一个HTML模板，该模板定义了PDF文件的样式和布局。

<!DOCTYPE html>
<html>
<head>
    <style>
        body { font-family: Arial; }
        table { width: 100%; border-collapse: collapse; }
       td, th { border: 1px solid #dddddd; text-align: left; padding: 8px; }
    </style>
</head>
<body>
    <h2>Invoice</h2>
    <table>
        <tr>
            <th>Invoice Number:</th>
            <td>${invoiceNumber}</td>
        </tr>
        <tr>
            <th>Issue Date:</th>
            <td>${issueDate}</td>
        </tr>
        <tr>
            <th>Customer Name:</th>
            <td>${customerName}</td>
        </tr>
        <tr>
            <th>Total Amount:</th>
            <td>${totalAmount}</td>
        </tr>
    </table>
</body>
</html>

4. 使用OpenPDF生成PDF

接下来，我们需要编写一个控制器方法，该方法读取HTML模板，填充数据，并将其转换为PDF文件。

import com.lowagie.text.Document;
import com.lowagie.text.pdf.PdfWriter;
import com.lowagie.text.pdf.parser.PdfTextExtractor;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;

import javax.servlet.http.HttpServletResponse;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.io.StringWriter;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

@Controller
public class PdfController {

    @GetMapping("/generate-pdf")
    @ResponseBody
    public void generatePdf(HttpServletResponse response) throws IOException, TemplateException {
        // 设置HTTP响应头
        response.setContentType("application/pdf");
        response.setHeader("Content-Disposition", "attachment; filename=invoice.pdf");

        // 创建Invoice实例
        Invoice invoice = new Invoice("INV-123456", LocalDate.now(), "John Doe", 250.99);

        // 使用FreeMarker处理HTML模板
        Configuration cfg = new Configuration(Configuration.VERSION_2_3_30);
        cfg.setClassForTemplateLoading(PdfController.class, "/templates/"); // 假设HTML模板位于/templates/目录下

        Map<String, Object> data = new HashMap<>();
        data.put("invoice", invoice);

        Template template = cfg.getTemplate("invoice.html");
        StringWriter stringWriter = new StringWriter();
        template.process(data, stringWriter);

        // 将HTML字符串转换为PDF
        ByteArrayOutputStream pdfBytes = new ByteArrayOutputStream();
        try (Document document = new Document()) {
            PdfWriter.getInstance(document, pdfBytes);
            document.open();
            com.lowagie.text.html.HtmlWriter.getInstance(document, pdfBytes);
            com.lowagie.text.html.simpleparser.HTMLWorker htmlParser = new com.lowagie.text.html.simpleparser.HTMLWorker(document);
            htmlParser.parse(new StringReader(stringWriter.toString()));
            document.close();
        }

        // 输出PDF到浏览器
        OutputStream out = response.getOutputStream();
        out.write(pdfBytes.toByteArray());
        out.flush();
        out.close();
    }
}

在这个示例中，我们使用了Freemarker作为模板引擎来渲染HTML页面。如果你不使用Freemarker，你可以选择其他的模板引擎或者直接使用静态HTML文件。