学习Qoppa jPDFViewer的科学实践（十四）

Qoppa

admin 发布于：2025-06-13 10:37:01

阅读：loading

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

1.基本介绍

jPDFViewer – 用于显示 PDF 的 Java PDF 可视化组件，将PDF 阅读器直接集成到您的 Java 应用程序或网站中。

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

jPDFViewer 可以从本地或网络驱动器上的文件、URL 以及运行时生成或来自其他来源（例如数据库）的文档的 Java 输入流中加载文档。使用 jPDFViewer，您的应用程序仍然可以控制您的文档，因此您可以根据系统实施的任何标准强制执行访问和安全协议。

2.组件介绍

在任何支持 Java 的平台上阅读和显示 PDF 文件
打印 PDF 文件
填写交互式 PDF 表单（Acroforms、XFA 表单）
查看所有标记注释
文本搜索和选择
高级工具：缩放、放大镜、快照、平移和缩放
通过不同的视图轻松导航：缩略图、书签、注释、图层……
可定制的工具栏和用户界面
支持所有图像类型，包括 JBIG2 和 JPEG 2000
支持所有 PDF 字体类型（Types 0-3、OpenType、TrueType）
支持最新的 Adobe PDF 格式
支持所有 PDF 颜色空间，包括图案和分色
支持文件附件
提供英语、法语、德语、意大利语、日语、西班牙语版本
适用于 Windows、Mac OS X、Linux 和 Unix（100% Java）
基于 Swing 的 PDF 查看器，还包括JavaFX PDF 查看器。
部署时无需安装或配置额外的驱动程序或软件

3.代码示例

public class SampleViewer {

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

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

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

}

jPDFViewer-含水印.gif

（预览PDF文件）

（打印PDF）

（未科学使用）

4.示例说明

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

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

（3）示例中演示了科学使用后设输出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的截图如下：