Java用iText生成PDF报表教程

想知道如何用Java生成专业的PDF报表吗？本文将手把手教你使用强大的iText库，通过实战案例讲解如何创建包含标题、表格和页脚的销售报表。首先，你需要引入iText依赖，然后利用PdfWriter、PdfDocument和Document对象构建PDF文档结构。文中提供了详细的代码示例，展示了如何添加商品信息等数据。同时，我们还为你准备了进阶技巧，包括解决中文字体显示问题、进行样式美化、从数据库动态读取数据以及使用模板化方案等，助你轻松应对复杂的报表需求。最后，别忘了关注iText 7的AGPL许可证，确保商业项目的合规性。掌握iText，让你的Java应用也能生成美观实用的PDF报表！

使用iText生成PDF报表需先引入依赖，再通过PdfWriter、PdfDocument和Document创建PDF，添加标题、表格和页脚内容，最后关闭文档。示例中生成包含商品信息的销售报表，并建议处理中文字体、样式美化、数据库数据读取及模板化以满足复杂需求，同时注意iText 7的AGPL许可证对商业项目的影响。

在Java项目中生成PDF报表是常见的需求，比如导出订单信息、账单或统计报告。iText是一个功能强大且广泛使用的开源库，能够灵活地创建和操作PDF文档。下面通过一个实际例子，展示如何使用iText生成一份简单的PDF报表。

引入iText依赖

如果你的项目使用Maven进行依赖管理，在pom.xml中添加以下依赖：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext7-core</artifactId>
    <version>7.1.15</version>
    <type>pom</type>
</dependency>

iText 7是当前主流版本，模块化设计更清晰。上述依赖包含了核心功能。

创建简单PDF报表

下面代码演示如何生成一个包含标题、表格和页脚的PDF文件。

import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Cell;
import com.itextpdf.layout.element.Paragraph;
import com.itextpdf.layout.element.Table;
import com.itextpdf.layout.property.TextAlignment;

import java.io.FileNotFoundException;

public class PdfReportGenerator {
    
    public static void main(String[] args) throws FileNotFoundException {
        // 指定PDF输出路径
        String dest = "report.pdf";
        
        // 创建PdfWriter实例
        PdfWriter writer = new PdfWriter(dest);
        
        // 初始化PdfDocument
        PdfDocument pdfDoc = new PdfDocument(writer);
        
        // 创建Document对象（用于添加内容）
        Document document = new Document(pdfDoc);
        
        // 添加标题
        document.add(new Paragraph("销售报表")
                .setFontSize(18)
                .setTextAlignment(TextAlignment.CENTER));

        // 添加空行
        document.add(new Paragraph(" "));
        
        // 创建表格，3列表格：商品名称、数量、单价
        Table table = new Table(3);
        table.addHeaderCell(new Cell().add(new Paragraph("商品名称")));
        table.addHeaderCell(new Cell().add(new Paragraph("数量")));
        table.addHeaderCell(new Cell().add(new Paragraph("单价（元）")));

        // 模拟数据
        String[][] data = {
            {"笔记本电脑", "2", "5999"},
            {"鼠标", "5", "80"},
            {"键盘", "3", "299"}
        };

        // 填充表格数据
        for (String[] row : data) {
            table.addCell(new Cell().add(new Paragraph(row[0])));
            table.addCell(new Cell().add(new Paragraph(row[1])));
            table.addCell(new Cell().add(new Paragraph(row[2])));
        }

        // 将表格添加到文档
        document.add(table);

        // 添加页脚
        document.add(new Paragraph("\n生成时间：2025年4月5日")
                .setTextAlignment(TextAlignment.RIGHT));

        // 关闭文档
        document.close();

        System.out.println("PDF报表已生成：" + dest);
    }
}

进阶功能建议

在实际项目中，你可能需要更多定制化功能：

• 字体支持中文：默认PDF不支持中文显示，需加载中文字体。例如使用SimSun.ttf或NotoSansCJK。
• 样式美化：设置边距、背景色、对齐方式、单元格边框等提升可读性。
• 从数据库读取数据：结合JDBC或ORM框架动态填充报表内容。
• 模板化处理：复杂报表可用HTML转PDF方案（如iText+XML Worker），或使用Thymeleaf + Flying Saucer组合。

注意事项

iText 7在AGPL协议下开源，商业用途需注意许可证限制。若用于闭源商业系统，建议购买商业授权，避免法律风险。

基本上就这些，掌握基础API后，可以根据业务需求扩展更复杂的布局和交互元素。

到这里，我们也就讲完了《Java用iText生成PDF报表教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！