Oracle XML Publisher与JDeveloper 10g集成

2006 年 11 月发布

    Oracle XML Publisher 是基于 XSL-FO 的 Oracle 报表工具，它包含一个 GUI 和一组核心 API 组件。以下核心 API 可以与 Oracle JDeveloper 10.1.3 集成，以生成 PDF、Excel、HTML 或 RTF 报表：

• PDF Form Processing Engine API。将 PDF 模板与 XML 数据合并以生成 PDF 文档。RTF Processor。将 RTF 模板转换为可扩展样式语言格式化对象 (XSL-FO) 文件，该文件随后将用作 FO Processor Engine 的输入。
• FO Processor Engine。合并 XML 文件（数据源文件）与 XSLT 文件（模板），以生成 PDF、Excel、HTML 和 RTF 报表。
• XSL-FO Utility。通过一个 XML 文件和 XSLT 文件或者一组 XML 和 XSLT 文件生成 XSL-FO 文件。PDF Document Merger。组合 PDF 文档并添加页码。
  
• PDF Book Binder Processor。将一组 PDF 文档合并到单个文档中，并采用章、节、子节和目录的格式。
• Document Processor Engine。通过单个 XML 文档（指定了模板、数据源和输出）对上述 API 进行批处理。

    在本文中，您将了解如何使用 FO Processor Engine、XSL-FO Utility 和 PDF Document Merger。您还可以大概了解能够从数据库生成 XML 文档的 Data Engine API。该 API 使用 XML 模板指定对数据库的 SQL 查询以及所生成的 XML 文档的结构。

    某些 Oracle XML Publisher API 需要 RTF 和 PDF 模板作为输入。要创建 RTF 模板，您需要 Oracle XML Publisher Desktop，这是一个 Microsoft Word 插件。要创建 PDF 模板，只需在 Word 文档中定义一个布局，然后使用 Adobe Acrobat Distiller 将该文档转换为 PDF。尽管本文没有讨论需要 RTF 和 PDF 模板的 API，但使用它们生成报表的过程类似于使用 Oracle XML Publisher API 生成报表的过程。

安装 Oracle XML Publisher

• 下载 Oracle XML Publisher Enterprise 5.6.2 for Microsoft Windows，然后将 zip 文件 XMLP562_WIN.zip 解压缩到一个目录中。
• 在 Oracle JDeveloper 10.1.3 中，选择 File>New 以打开 New Gallery 向导。
• 选择 General>Application 创建一个新应用程序，然后单击 OK 按钮。
• 在 Create Application 框架中，指定一个应用程序名（如 XMLPublisher），然后单击 OK。
• 在 Create Project 框架中，指定一个项目名（如 XMLPublisher），然后单击 OK。这将在 Applications Navigator 中添加一个应用程序和一个项目。
• 接下来，通过在 New Gallery 框架中选择 General>Java Class，将 Java 类添加到项目。
• 在 Create Java Class 框架中，指定一个类名（如 XMLPublisher）和一个程序包名（如‘xmlpublisher’），然后单击 OK 按钮。这将在 Oracle XML Publisher 项目中添加一个 Java 类。
• 在本文中，您将根据 XML 文档创建 PDF 报表。因此，需要在 New Gallery 框架中选择 General>XML>XML Document，将 XML 文档添加到项目。

    您将在以下部分中为项目添加其他 XML 和 XSLT 文档。图 1 展示了 Oracle XML Publisher 项目的目录结构：

图 1：Oracle XML Publisher 项目的目录结构。

• 接下来，通过选择 Tools>Project Properties 将 Oracle XML Publisher API 的 Jar 文件添加到 Oracle XML Publisher 项目。
• 在 Project Properties 框架中，选择 Libraries。
• 使用 Add Jar/Directory 按钮添加 Jar 文件。Oracle XML Publisher Jar 文件位于 <XMLP562_WIN>\manual\lib 目录中；其中，<XMLP562_WIN> 是安装有 Oracle XML Publisher zip 文件的目录。
• 使用 Add Library 按钮添加 Oracle JDBC 库，这需要建立 Oracle 数据库的 JDBC 连接。单击 OK。

图 2 展示了 Oracle XML Publisher 项目中的 Jar 文件/库：

图 2：Oracle XML Publisher 项目库。