该方法文档演示了如何使用 OC4J 10g (10.1.3) 中引入的共享库机制来定义由已部署应用程序加载和使用的 XML 分析器实施。

注意： 参阅“OC4J 配置和管理指南”获取关于 OC4J 中可用的共享库功能的详细讨论。

默认情况下，Oracle XDK 附带的 XML v2 分析器在应程序部署到 OC4J 时可供其使用。

要演示共享库功能，需要安装 Xerces XML 分析器和 Xalan XSL 译码器类库，并将它们发布为 共享库 ，然后重新部署并配置该应用程序以使用该新共享库。当重新执行该应用程序时，它将显示已经加载了 Xerces 和 Xalan 库。

和许多其他应用服务器一样，配置 OC4J 以加载一个预定义的库集。例如，在 OC4J 启动时加载某个特定版本支持和实施的所有 J2EE 库。此外，默认情况下，将加载提供 XML 分析器和 OC4j 自身使用的其他产品的 Oracle XDK（XML 开发人员工具包），并用于应用程序。通常，这是针对 OC4J 用户的简易解决方案，从而无需跟踪一组 XML 库并包括它们以与应用程序结合使用。

然而，在某些情况中，运行在 OC4J 上的应用程序有一个依赖项，或者已经进行显式认证以用于另一个 XML 分析器实施并需要使该实施优先于 Oracle XML 分析器加载。直到 10.1.3 版本为止，已经证明这对于 OC4J 用户来说不是小问题。

主要问题是 Oracle XDK 库已经使用引用 JAR 文件 Class-Path 机制硬编码到该容器的类路径中。更改这一问题需要使用 JRE 扩展库机制，或者在启动它来加载可替换的 XML 分析器实施时更改 JVM 的根类路径。当该库运行时，已经是一个无支持的操作，因为该更改的影响不限于特定应用程序 — 整个容器都将受到影响，而且可能在运行时导致产生意外结果。

但是，随着 OC4J 10g (10.1.3) 中共享库机制的引入，有一个解决方案可供利用。使用共享库机制，类现在可以存在于并行类加载空间，从而使得 OC4J 自身使用的库和部署到 OC4J 的应用程序使用的库之间能够完全分离。

通过该共享库实施，可以专门重写并替换默认情况下加载并可用的任何默认类库。这以逐个应用程序进行或者累计到每个应用程序继承的一组默认值。

共享库包含一组代码源，可以由类加载器从该代码源加载 Java 类。共享库都具有名称和版本。

默认情况下，部署到 OC4J 的应用程序继承大量预定义的共享库。这些共享库的定义如下所示。

 <imported-shared-libraries>
                            


 <import-shared-library name="oracle.dms"/>
                            


 <import-shared-library name="oracle.jdbc"/>
                            


  
                            
<import-shared-library name="oracle.xml"/>
                            


<import-shared-library name="soap"/>
                            


<import-shared-library name="global.libraries"/>
                            


<import-shared-library name="global.tag.libraries" />
                            


</imported-shared-libraries>
                          

默认共享库集的定义在一个无法更改的内部 OC4J 文件中指定。然而，可以先安装和发布附加共享库，然后配置应用程序来加载它们，甚至按需替换任何继承的库。

该方法文档准确演示了如何执行该任务。

• 一般需要熟悉 J2EE 应用程序和相关的 XML 分析概念
• 了解类库的概念以及它们如何与 J2EE 容器结合使用。

• %ORACLE_HOME%：OC4J 的安装目录。
• %J2EE_HOME%：OC4J 中的 oc4j.jar 文件目录。
  这是 %ORACLE_HOME% 中的两个常见目录。例如，如果您将 OC4J 安装到 c:\，则 %J2EE_HOME% 将是 c:\j2ee\home
• %JAVA_HOME%：您计算机上 JDK 的安装目录。

需要先构建并部署该方法文档之后，方可对其进行访问。

首先，查看方法文档分发的内容。

• how-to-swapxmlparser/src — 包含该示例的所有 Java 源代码。
  • web/
    • index.jsp — 该容器用来显示 XML 分析器相关类的页面
    • css/
      • blaf.css — 样式表。
• how-to-swapxmlparser/ etc/
  • web.xml — 标准 J2EE Web 模块部署描述符
  • application.xml — 标准 J2EE 应用程序模块描述符
• how-to-swapxmlparser/doc/
  • how-to-swapxmlparser.html — 本文档。
  • images/ — 包含该文档的图像
• how-to-swapxmlparser/
  • build.xml — 用于构建、打包和部署该应用程序的 Ant 编译文件
  • oracle-ant.xml — 为 Ant 设置正确的环境以便构建和部署应用程序
  • oracle-ant.properties — 定义应用程序部署到的 OC4J 实例的属性

确保在位于该方法文档分发的根目录下的 oracle-ant.properties 文件中正确配置了以下属性。

注意：其中一些属性将默认为相应环境变量的值，如下所示。如果您已经在环境中设置了这些变量，则不必在文件中更改这些值。如果有必要，将这些变量修改为环境的相应值：

• oracle.home — oracle 安装的根目录。默认为 ORACLE_HOME 环境变量。
• java.home — JDK 安装的根目录。默认为 JAVA_HOME 环境变量。
• oracleas..host — 运行目标 OC4J 实例的平台的主机名。默认为 localhost。
• oracleas.http.port — OC4J HTTP 监听程序监听的端口。默认为 8888。
• oracleas..admin.port — OC4J 管理处理器监听的端口。默认为 23791。
• oracleas.admin.user — OC4J 管理员名称。默认为“oc4jadmin”。
• oracleas.admin.password — OC4J 管理员的密码。默认为“welcome1”。
• oracleas.binding.module — 部署的应用程序绑定到的 HTTP Web 站点。默认为“http-web-site”。
• oracleas.deployer.uri — 标识部署操作的目标，使得 OC4J 独立版、OracleAS 单个实例或 OracleAS 组能够得到部署以便使用相同的 Ant 任务集

此外，请确保与 OC4J ant 版本关联的 ant 命令位于执行路径 ( %ORACLE_HOME%/ant/bin) 中。

本文的说明假设使用了 OC4J zip 分发版本。如果正在使用 OracleAS，应该使用启动/停止服务器所需的适当命令。

注意 oc4j.cmd 脚本预期 JAVA_HOME 环境变量指向整个 JDK 安装。

>ant

要执行所提供的 build.xml 文件中默认的“所有”目标，请执行以下步骤：

• 编译所有源文件
• 将 Web 模块打包为 WAR 文件并生成一个 J2EE 应用程序模块（ear 文件），该模块包含部署该应用程序所需的各种文件。
• 部署应用程序模块。现在使用 ant 部署 ant 任务将前一步骤中生成的 .ear 文件部署到该服务器：      

<oracle:deploy
  deployerUri="${oracleas.deployer.uri}"
  userId="${oracleas.admin.user}"
  password="${oracleas.admin.password}"
  file="${lib.dir}/${app.name}.ear"
  deploymentName="${app.name}"
  logFile="${log.dir}/deploy-ear.log"
  bindAllWebApps="${oracleas.binding.module}"/>
     

在该方法文档中，您将执行大量任务来观察如何在 OC4J 中使用共享库。

您现在将执行的任务是：

• 执行已部署的 how-to-swapxmlparser 应用程序来查看加载的 XML 分析器类
• 安装并发布一个具有不同 XML 分析器实施的新共享库。
• 重新配置已部署的应用程序来重写默认的 oracle.xml 共享库并加载新的共享库。
• 重新执行该应用程序并查看现在使用的 XML 库。

该方法文档使用一个简单的 JSP 应用程序查看应用程序加载的各种 XML 工厂和类实例。

该应用程序使用 JAXP（用于 XML 分析的 Java API）API 创建 SAX 分析器产物（ SAXParserFactory 和 SAXParser）、 DOM 分析器产物（ DocumentBuilderFactory 和 DocumentBuilder）和 XSL 产物（ TransformerFactory 和 Transformer）的实例。然后它将显示这些对象的完全限定类名，以便显示已经加载了哪些类。

 public static String getDOMDetails ()
                            


 {
                            


 DocumentBuilder builder=null;
                            


  
                            
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
                          

 try
                            


 {
                            


  
                            
builder = factory.newDocumentBuilder();
                            


return "<BR><B>DocumentBuilderFactory Instance:</B> " + factory.getClass().getName() +
                            


"<BR><B>DocumentBuilder Instance:</B> " + builder.getClass().getName() +"<BR>"; }
                            


catch (Exception e)
                            


{
                            


return "Error processing DOM -- " + e.getMessage();
                            


}
                            


}
                          

一个类似的方法可用于获取 SAX 和 XSL 加载类的细节。

然后，该 JSP 页将显示调用这些方法结果，进而识别使用的 XML 库。

当部署了应用程序以后，可以通过执行该应用程序来确定加载了什么 XML 库。

打开一个浏览器窗口并输入以下 URL：

这将显示该应用程序加载的 XML 相关类的完全限定类名。

在默认的 OC4J 配置中，显示的内容应如下所示：

DOM Parser

DocumentBuilderFactory Instance:oracle.xml.jaxp.JXDocumentBuilderFactory
DocumentBuilder Instance:oracle.xml.jaxp.JXDocumentBuilder

SAX Parser

SAXParserFactory Instance:oracle.xml.jaxp.JXSAXParserFactory
SAXParser Instance:oracle.xml.jaxp.JXSAXParser

XSL Transformer

TransformerFactory Instance:oracle.xml.jaxp.JXSAXTransformerFactory
Transformer Instance:oracle.xml.jaxp.JXTransformer

浏览器中的该 HTML 页应该如下所示：