学习Qoppa jPDFAssemble的科学实践（十一）

Qoppa

admin 发布于：2025-06-12 14:35:39

阅读：loading

Qoppa Software是一家专注于PDF处理和数字文档解决方案的公司，提供丰富的Java、.NET和Web平台的组件。其产品广泛应用于企业、ZF*、金融、医疗等行业，旨在简化PDF和数字文档的处理、管理和集成。特别说明：只为单纯的学习摸索与自我突破，商业软件请勿直接使用于生产环境（购买商业授权）

1.基本介绍

jPDFAssemble – 用于合并和拆分 PDF 文档的 Java PDF 库。

jPDFAssemble 是一个用于组装 PDF 文件的 Java 库。jPDFAssemble 可以合并、合并或拆分 PDF 文档。jPDFAssemble 还允许在 PDF 文档中添加或操作书签。

该库可以将结果文档保存到本地文件系统或输出流，以便在 J2EE 服务器中工作时能够将文档直接提供给客户端浏览器，而无需任何临时文件。

jPDFAssemble 基于 Qoppa 专有的 PDF 技术构建，因此您无需安装任何第三方软件或驱动程序。由于它采用 Java 编写，因此您的应用程序能够独立于平台，在 Windows、Linux、Unix（Solaris、HP UX、IBM AIX）、Mac OS X 以及任何其他支持 Java 运行时环境的平台上运行。

2.组件介绍

拆分 PDF 文档
合并 PDF 文档
创建和编辑书签/大纲
更新文档元数据信息
保存到本地文件系统或 Java 输出流
适用于 Windows、Linux、Unix、Mac OS X（100% Java）

3.代码示例

public class SampleAssemble {

    public static void main(String[] args) throws Exception {
        QoppaRegister.registerJPDFAssemble();

        PDFAssemble document = null;
        try {
            document = new PDFAssemble("resources/input/hello.pdf" , null);
            PDFAssemble doc1 = document.extractPages(0, 1, "resources/output/jPDFAssemble_HelloWorld1.pdf");
            doc1.saveDocument("resources/output/jPDFAssemble_HelloWorld1.pdf");
            PDFAssemble doc2 = document.extractPages(1, 3, "resources/output/jPDFAssemble_HelloWorld2.pdf");
            doc2.saveDocument("resources/output/jPDFAssemble_HelloWorld2.pdf");
            //doc1与doc2 调用close会抛空指针
        } finally {
            if (document != null) {
                document.close();
            }
        }

    }

}

（从源文件中抽取第1-2页内容）

（从源文件中抽取第2-4页内容）

4.示例说明

（1）示例使用了jPDFAssemble操作PDF文档拆分和合并文档的示例，本次代码给出示例为文件拆分案例，也有编写多个PDF文档合并的示例未给出；

（2）示例中演示了未科学使用时输出PDF转换为图片就有文档水印；

（3）示例中演示了科学使用后设输出PDF转换为图片没有文档水印；

（4）示例中演示了从PDF文档中分别拆分出两个小文档的案例；

5.其它说明

（1）Qoppa Software推出了15款Java集成开发组件库，，除此之外的其它组件在生成/转换为PDF文档时，应该需要处理文档属性中的“制作工具”；

（2）更多的组件需要使用License注册，使用试用版本将会有对应的试用提示信息，比如插入文字水印、图片中被插入水印、内容中被插入DEMO字样的文本，所以科学使用的目的在于单纯使用对应的工具库，不需额外关注License，又不改动Jar文件中的class，同时又恰好没有水印和文本混乱的限制。特别说明：只为单纯的学习摸索与自我突破，商业软件请勿直接使用于生产环境（购买商业授权）；

（3）官网提供了对应各个组件的示例代码和组件库的Jar文件下载，未找到有试用Maven库管理组件的形式，需要自行下载相关的组件；

（4）官网的某些页面资料中也有说明还包含上述产品组件范围之外的其它组件，如：OCR等，没有找到详细的示例使用介绍，不作为本次学习摸索的重点；

（5）官网提供的试用组件的Jar文件中的class有经过加密混淆，从class部分入门则难道比较高，本次对于系列组件的摸索在于科学使用方面，对于组件提供的功能广度与深度应用不作过多的摸索；

（6）对各个组件学习摸索的时间并不算太多，发现这么多组件应该不能同时作用于同一个项目中，因为它们不同的组件Jar中提供的class类文件路径存在同名或同类的，存在互相冲突的场景，不知道是否有说明白，以jPDFWriter与jPDFWeb两个组件Jar的截图如下：