学习Qoppa jPDFNotes的科学实践（十五）

Qoppa

admin 发布于：2025-06-13 10:59:08

阅读：loading

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

1.基本介绍

jPDFNotes – Java PDF 注释器/表单填充组件。显示 PDF 文档和交互式 PDF 表单，并允许您的用户使用 jPDFNotes 注释文档和填写表单。

jPDFNotes 基于 Qoppa 的专有 PDF 技术构建，无需安装任何客户端或第三方程序。它是一个独立的 Java 组件，可以作为 Java Webstart 应用程序部署到 Java 应用程序或 Web 应用程序中。由于它使用 Java 编写，因此您的应用程序可以保持平台独立性，并可在 Windows、Mac、Linux 和 Unix 上运行。

jPDFNotes 可以从本地或网络驱动器上的文件、URL 以及 Java 输入流加载文档，这些文档可以是运行时生成的文档，也可以来自其他来源（例如数据库）。编辑文档后，该库可以将其保存到本地文件，或者主机应用程序可以重写保存函数，将文件保存到本地任何位置或 Web 服务器。

2.组件介绍

读取和显示 PDF 文件（和图像文件）
打印 PDF 文件
填写并保存交互式 PDF 表单（Acroforms、XFA 非动态）
审阅和标记 PDF 文档：
（1）各种图形注释
（2）文本注释：便签、打字机、文本框
（3）文本标记：突出显示、删除线、下划线
（4）插入符号注释：删除、替换、插入
（5）其他注释：声音、橡皮图章、图像注释
对 PDF 文件进行数字签名（并验证现有签名）
文本搜索、选择、复制
通过缩略图、书签、注释、签名视图轻松导航
高级工具：缩放、放大镜、快照、平移和缩放
支持 PDF 2.0 文件格式（最新 PDF 格式），包括图层
支持所有图像类型：PNG、TIFF、JPEG、JBIG2 和 JPEG 2000
可定制的工具栏和用户界面
支持所有字体类型
支持所有色彩空间
扫描为 PDF 格式，从扫描创建文档（可选模块）
适用于 Windows、Mac OS X、Linux 和 Unix（100% Java）
提供英语、法语、德语、意大利语、日语和西班牙语版本

3.代码示例

public class SampleNotes {

    public static void main(String[] args) {
        QoppaRegister.registerJPDFNotes();

        JFrame frame = new JFrame("PDF Notes");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setLocationRelativeTo(null);
        frame.setSize(1050 , 600);

        PDFNotesBean notes = new PDFNotesBean();
        notes.setPage(1);
        notes.setVisible(true);
        frame.getContentPane().add(notes , BorderLayout.CENTER);
        frame.setVisible(true);
    }

}

（jPDFViewer与jPDFNotes对比）

（编辑PDF文档）

（持久化PDF）

4.示例说明

（1）示例使用了jPDFNotes预览PDF文档格式的示例，预览PDF的功能有许多，比如：局部放大、窗口导航、选中区域截图等等；

（2）示例使用了jPDFNotes编辑PDF文档格式的示例，编辑PDF的功能有许多，比如：文字更改、圆框涂鸦、批注等等；

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

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

（4）示例中的PDFNotes继承了PDFViewer，比预览多出了许多功能按钮，主要是注释文档和填写表单等等；

（5）示例中的保存不是另存为，保存将会改动原始文档；

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的截图如下：