Java项目中如何生成PDF报表_iText库应用实例

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

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

引入iText依赖

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


    com.itextpdf
    itext7-core
    7.1.15
    pom

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 pdf

Doc = 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.ttfNotoSansCJK
  • 样式美化:设置边距、背景色、对齐方式、单元格边框等提升可读性。
  • 从数据库读取数据:结合JDBC或ORM框架动态填充报表内容。
  • 模板化处理:复杂报表可用HTML转PDF方案(如iText+XML Worker),或使用Thymeleaf + Flying Saucer组合。

注意事项

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

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