Java利用ITextPdf库生成PDF预览文件的具体实现

 更新时间:2024年04月09日 08:38:11   作者:PunkSerris  
这篇文章主要给大家介绍了Java利用ITextPdf库生成PDF预览文件的具体实现,文中通过代码示例和图文给大家介绍的非常详细,具有一定的参考价值,需要的朋友可以参考下

背景

其实公司之前的项目里是用到了帆软报表的,然而最近接了一个新项目,这个项目独立部署在甲方的独立环境中,组长的意思是不用再单独部署一套帆软报表,成本太大,用其他方式实现一下。虽然我不太理解成本大在哪儿,不过身为助理工程师,别管那么多,照着干就完事了。

之前有其他哥们写过类似功能,通过解析数据动态生成pdf文件。但他用的那个技术jasper有点老了,资料不太好找,问过神奇的chatgpt后,了解到iTextPdf这个库,应该是比较好的选择。

解决方案

我们先观察下真实的开票预览的模板。

发票信息由两部分组成:

  • 固定信息,例如购买方信息、销售方信息。
  • 商品信息,可能有多行,需动态填充

很明显的一个主子结构。 了解了一下iTextPdf的相关api。要实现这个功能,其实我们需要分别生成两部分的发票信息,也就是两个pdf,然后将两个pdf拼接成同一个。 对于第一部分的固定信息,我们可以用Acrobat之类的pdf设计工具设计出一个模板,然后在java程序中读取并填充对应的模板值。 对于第二部分的商品信息,就需要获取商品数据,动态生成表格,当然iTextPdf是支持这一功能的。 分别得到两部分的pdf之后,再将其合并为同一个pdf就可以了。

具体实现

1.引入iTextPdf库

在pom文件中添加iTextPdf的对应依赖。 其中 itext-asian 这个也是需要的,不然生成的pdf中无法显示中文

        <dependency>
            <groupId>com.itextpdf</groupId>
            <artifactId>itextpdf</artifactId>
            <version>5.5.13.2</version>
        </dependency>

        <dependency>
            <groupId>com.itextpdf</groupId>
            <artifactId>itext-asian</artifactId>
            <version>5.2.0</version>
        </dependency>

2.编辑对应模板

下载Adobe Acrobat工具,这部分就不细说了 点击文件-创建-表单。如果你有现成的pdf文件,也可以在这步选择单一文件开始,没有的话就从头新建

通过放置文字和文字域来设计好表单模板。 注意,文字域“属性”里的名称就是最后使用iTextPdf填充时需要填充的对应字段。

3.编写java PDF生成程序

使用框架还是老一套的SpringBoot,但为了方便测试,不展示最终的成品接口,而是写在一个可执行的主方法里main里。

3.1 读取PDF模板文件

iTextPdf负责读取文件的Class是PdfReader,支持多种解析方式 可以读取文件路径,也支持直接传入文件的字节流 线上环境使用了字节流的读取方式。演示的主方法中使用了直接读取本地文件路径的方式。

  // 读取本地文件,当然线上环境肯定不这么写
  PdfReader reader = new PdfReader("C:\\Users\\User\\Desktop\\开票预览模板.pdf");
  // 线上环境使用了s3服务器,会提前得到字节流 byte[] bytes
  PdfReader reader = new PdfReader(bytes);

3.2 填写模板文件并生成固定信息的PDF文件

iTextPdf负责填充表单字段的Class是PdfStamper Stamper,译文压模;母盘;模子;印章 用来形容把动态数据填充进已有的表单里,还挺形象的 注意 form.setField("purName","购买方对应公司"); 这里设值的key就是我们在设计表单时,文字域的名称。

        // 临时输出流-表单
        ByteArrayOutputStream bos1 = new ByteArrayOutputStream();
        PdfStamper stamper = new PdfStamper(reader, bos1);


        // 获取表单
        AcroFields form = stamper.getAcroFields();
        form.setGenerateAppearances(true);

        // 表单填充
        form.setField("purName","购买方对应公司");
        stamper.close();

在实际的实现中,这里使用了一个Map<String,String> map 遍历所有entrySet,将值通过setField(entrySet.key(),entrySet.value())方法填充至表单

3.3 动态创建表格并生成商品信息的PDF文件

搞定了第一部分的PDF文件,我们再来处理第二部分的PDF文件:生成商品列表。 这里我们需要新建一个Document,在这个Document中动态创建一个表格对象PdfPTable 最后将Document关闭。调用Document.close()时会触发输出流ByteArrayOutputStream的更新。 另外还有一个要点是,如果表格要显示中文,那么输出的内容格必须设置中文字体,否则无法显示。

我们来看一下填充一个最简单的Pdf表格是怎么做的

// 最简单的示例
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.PageSize;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.PdfPTable;
import com.itextpdf.text.pdf.PdfWriter;

import java.io.FileOutputStream;

public class AdjustTablePositionInPdf {
    public static void main(String[] args) {
        try {
            // 创建一个新的 PDF 文档
            Document document = new Document(PageSize.A4);
            PdfWriter.getInstance(document, new FileOutputStream("C:\\Users\\User\\Desktop\\adjusted_table_position.pdf"));
            document.open();

            // 添加文本内容
            document.add(new Paragraph("Test PDF with Table"));

            // 创建表格
            PdfPTable table = new PdfPTable(2);
            table.addCell("Name");
            table.addCell("Age");
            table.addCell("Alice");
            table.addCell("25");
            table.addCell("Bob");
            table.addCell("30");

            // 设置表格之前的间距
            table.setSpacingBefore(20f);

            // 设置表格之后的间距
            table.setSpacingAfter(20f);

            // 设置表格的总宽度
            table.setTotalWidth(300f);

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

            document.close();

            System.out.println("PDF 文件生成成功!");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

声明PdfPTable对象后(需指定列的数目),通过调用Table.addCell()方法添加行数据。 Table.addCell()会自动切换行的。假如表有两列,连续调用三个Table.addCell()方法,第三个方法就会自动切换到第二行。 知道了这一点后,我们分析一下:对于表格的某一列,我们至少需要以下两个参数:表头中文名称,列的数据映射key

/**
*  表头信息
**/

@Data
@AllArgsConstructor
public class HeadRowMetaInfo {
    // 列中文名
    private String colName;
    // 列key
    private String colKey;
    // 列宽度
    private float width;
}
    /**
     * 自定义头部信息
     * @return
     */
    public static List<HeadRowMetaInfo> headInfos(){
        List<HeadRowMetaInfo> infos = new ArrayList<>();
        infos.add(new HeadRowMetaInfo("货物或应税劳务、服务名称","commodityName",80));
        infos.add(new HeadRowMetaInfo("规格型号","model",80));
        infos.add(new HeadRowMetaInfo("单位","pushUnitName",80));
        infos.add(new HeadRowMetaInfo("数量","orderNum",80));
        infos.add(new HeadRowMetaInfo("单价","orderPriceNoTax",80));
        infos.add(new HeadRowMetaInfo("不含税金额","orderAmount",80));
        infos.add(new HeadRowMetaInfo("税额","taxAmt",80));
        infos.add(new HeadRowMetaInfo("含税金额","orderAmountTax",80));
        infos.add(new HeadRowMetaInfo("税率","taxRate",80));
        return infos;
    }

好了,我们继续来看我们的主方法

        // 临时文件流-商品
        ByteArrayOutputStream bos2 = new ByteArrayOutputStream();

        // 获取原页面的尺寸和样式
        Document document = new Document(reader.getPageSize(1));
        PdfWriter writer = PdfWriter.getInstance(document, bos2);

        document.open();
        //新创建一页来存放后面生成的表格
        document.newPage();

        // 获取商品导出数据
        List<Map<String, Object>> mapData = otherService.getData();
        // 全局统一字体,不设置无法显示中文
        // 创建支持中文的字体
        BaseFont bfChinese = BaseFont.createFont("STSongStd-Light", "UniGB-UCS2-H", false);
        Font font = new Font(bfChinese, 12, Font.NORMAL, BaseColor.BLACK);

        PdfPTable table = generatePdfPTable(720f,font,mapData,headInfos());

        document.add(table);
        // 文档流关闭
        // 关闭后才会触发ByteArrayOutputStream的流更新
        document.close();
        writer.close();

主方法中声明的,生成PDF表格的子方法为:

    public static PdfPTable generatePdfPTable(float totalWidth, Font font, List<Map<String, Object>> data, List<HeadRowMetaInfo> headRowMetaInfos) throws DocumentException {
        // 多少列
        PdfPTable table = new PdfPTable(headRowMetaInfos.size());
        // 表宽度
        table.setTotalWidth(totalWidth);

        // 设置每列的宽度
        List<Float> flist = headRowMetaInfos.stream().map(HeadRowMetaInfo::getWidth).collect(Collectors.toList());
        float[] farr = new float[flist.size()];
        for(int i = 0;i<flist.size();i++){
            farr[i] = flist.get(i);
        }
        table.setWidths(farr);

        Map<Integer,String> indexToKeyMap = new HashMap<>();
        // 根据表头信息插入表头
        for(int i = 0 ;i < headRowMetaInfos.size();i++){
            table.addCell(new Phrase(headRowMetaInfos.get(i).getColName(),font));
            indexToKeyMap.put(i,headRowMetaInfos.get(i).getColKey());
        }

        // 添加行数据
        for(Map<String,Object> dataItem:data){
            for(int i=0;i<headRowMetaInfos.size();i++){
                if(dataItem.get(indexToKeyMap.get(i)) != null){
                    table.addCell(new Phrase(dataItem.get(indexToKeyMap.get(i)).toString(),font));
                }else{
                    table.addCell("-");
                }
            }
        }

        // 计算表格在页面上的位置并添加到页面
        // 注意:这里的坐标可能需要根据实际情况调整
        table.setLockedWidth(true);
        return table;
    }

3.4 拼接两个PDF文件

    public static byte[] copy(List<byte[]> files) throws DocumentException, IOException {
        // 创建文档对象
        Document document = new Document();
        // 创建PdfCopy对象
        ByteArrayOutputStream bos = new ByteArrayOutputStream();
        PdfCopy copy = new PdfCopy(document, bos);
        // 设置只读
        copy.setEncryption(null, null, PdfWriter.ALLOW_PRINTING, PdfWriter.STANDARD_ENCRYPTION_128);


        // 打开文档
        document.open();
        PdfReader reader;
        int n;
        // 循环遍历所有PDF文件
        for (byte[] file : files) {
            reader = new PdfReader(file);
            // 获取每个PDF文件的页数
            n = reader.getNumberOfPages();
            for (int page = 0; page < n; ) {
                // 向PdfCopy添加每一页
                copy.addPage(copy.getImportedPage(reader, ++page));
            }
            // 关闭PdfReader
            reader.close();
        }

        // 关闭文档,否则输出流不会刷新
        document.close();

        byte[] bytes = bos.toByteArray();

        // 关闭流
        bos.close();
        return bytes;
    }

3.5 输出

用于线上环境的接口,在此处得到了字节流之后就上传s3了 在演示用的主函数里,将字节流保存为了本地文件

        log.info(returnPath +" pdf模板填充成功,进行合并");
        List<byte[]> files = new ArrayList<>();
        files.add(bos1.toByteArray());
        files.add(bos2.toByteArray());
        // 合并两个pdf流
        byte[] s3bytes = copy(files);

        // 关闭流
        bos1.close();
        bos2.close();
        reader.close();

        // 有流之后 可以把流存储至本地文件,也可以上传s3了
        String outputPath = "C:\\Users\\User\\Desktop\\test3.pdf";
        FileOutputStream fileOutputStream = new FileOutputStream(outputPath);
        fileOutputStream.write(s3bytes);
        fileOutputStream.close();

赛后总结

通过这次的需求学习到了JAVA里生成操作pdf文件的方法。 先制作PDF表格模板,设置文字域,可以处理掉导出数据中的固定部分数据 针对表格类的数据,长度不固定,需要通过生成PDF表格来进行处理。

以上就是Java利用ITextPdf库生成PDF预览文件的具体实现的详细内容,更多关于Java ITextPdf PDF预览文件的资料请关注脚本之家其它相关文章!

相关文章

  • 详解eclipse创建maven项目实现动态web工程完整示例

    详解eclipse创建maven项目实现动态web工程完整示例

    这篇文章主要介绍了详解eclipse创建maven项目实现动态web工程完整示例,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-12-12
  • Spring Boot与MyBatis配置与操作实战指南

    Spring Boot与MyBatis配置与操作实战指南

    本文介绍了如何在SpringBoot项目中配置和使用MyBatis,包括环境准备、数据源配置、MyBatis配置、数据操作、事务管理以及高级配置如缓存和插件的使用,通过这些步骤,可以实现高效的数据驱动应用程序开发,感兴趣的朋友跟随小编一起看看吧
    2026-01-01
  • java连接MySQl数据库实例代码

    java连接MySQl数据库实例代码

    这篇文章介绍了java连接MySQl数据库实例代码,有需要的朋友可以参考一下
    2013-10-10
  • SpringBoot利用自定义json序列化器实现敏感字段数据脱敏详解

    SpringBoot利用自定义json序列化器实现敏感字段数据脱敏详解

    这篇文章主要介绍了SpringBoot利用自定义json序列化器实现敏感字段数据脱敏详解,因为案例代码用到了hutool提供的DesensitizedUtil数据脱敏工具类,这里要引入hutool的依赖,如果你需要自定义 数据脱敏的逻辑,可以不引入这个依赖,需要的朋友可以参考下
    2024-01-01
  • springboot增加注解缓存@Cacheable的实现

    springboot增加注解缓存@Cacheable的实现

    这篇文章主要介绍了springboot增加注解缓存@Cacheable的实现,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-12-12
  • 关于SpringBoot的三级缓存的思考问题小结

    关于SpringBoot的三级缓存的思考问题小结

    文章解析SpringBoot三级缓存机制,指出其核心在于通过提前暴露早期引用解决单例Bean属性注入的循环依赖,支持AOP代理,但构造函数注入无法解决,本质是为特殊场景提供生命周期弹性通道,本文给大家介绍对于SpringBoot的三层缓存的思考,感兴趣的朋友一起看看吧
    2025-10-10
  • SpringCloud gateway如何修改返回数据

    SpringCloud gateway如何修改返回数据

    这篇文章主要介绍了SpringCloud gateway如何修改返回数据的操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-06-06
  • Java之遍历枚举值问题

    Java之遍历枚举值问题

    这篇文章主要介绍了Java之遍历枚举值问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-07-07
  • Spring Boot 对接深度求索接口实现知识问答功能

    Spring Boot 对接深度求索接口实现知识问答功能

    本文详细介绍了如何使用 Spring Boot 对接深度求索接口,实现知识问答功能,通过整合深度求索 API,我们可以轻松地在 Spring Boot 项目中实现智能问答功能,
    2025-02-02
  • RabbitMQ中Confirm消息确认机制保障生产端消息的可靠性详解

    RabbitMQ中Confirm消息确认机制保障生产端消息的可靠性详解

    这篇文章主要介绍了RabbitMQ中Confirm消息确认机制保障生产端消息的可靠性详解,生产者将数据发送到 RabbitMQ 的时候,可能数据就在半路给搞丢了,因为网络问题啥的,都有可能,需要的朋友可以参考下
    2023-12-12

最新评论