Oracle Application Server Containers for J2EE 10g (10.0.3) 开发人员预览版 －
企业 Web 服务

目录

• 简介
• 安装
• 环境设置
• 运行一个 OC4J 实例
• OC4J 10g (10.0.3) 开发人员预览版中的新特性
• OC4J 10g (10.0.3) 开发人员预览版的方法示例

简介

OC4J 10g (10.0.3.0) 开发人员预览版包含 Oracle 的 JAX-RPC Web 服务实施的第一个版本。它遵循 J2EE 1.4 规范，该规范包含了一个 JAX-RPC 1.1 运行时（参见：http://java.sun.com/xml/jaxrpc/）以及 JSR 109 部署（参见 http://www.jcp.org/en/jsr/detail?id=109）。

本文档描述了运行所提供的 Web 服务示例代码所需的安装步骤，列出了开发人员预览版中可用的特性，并提供了指向说明这些特性的方法示例的链接。

请在 /global/cn/tech/webservices 访问 Oracle 技术网 OTN Web 服务中心，获取当前信息并了解最新的更新。您可以在 OTN Web 服务论坛 http://forums.oracle.com/forums/forum.jsp?forum=97 提供您的反馈并获得问题的解答。

请注意为了向后兼容，我们还提供了 9i Web 服务系列（"Oracle J2EE Web 服务"）。此版本不包含该实施的文档或示例代码。请参考原始的 Oracle 9iAS（version 9.0.3 或更新）文档和示例以获取详细信息。

安装

软件需求

运行所提供的 JAX-RPC Web 服务示例要求下列软件。

• Sun 的 JDK，必须使用 version 1.4_01 或更高版本。它可从 http://java.sun.com/j2se/ 下载。
  
  注意：运行这些演示需要 JDK 1.4.x 或更高版本。
  
  
• 构建应用程序示例需要 Jakarta Ant。可从 http://jakarta.apache.org/ant/index.html 下载。
  
  
• 必须安装 OC4J 10.0.3.0.0 开发人员预览版。可从 Oracle 技术网 (OTN) /global/cn/tech/java/oc4j/1003/content_preview.html 下载。
  
  为了安装 OC4J，您需要把下载的 zip 文件解压到一个目录中，该目录将成为 oc4j 的根目录。
  
  下一步您将运行 OC4J 安装： java -jar OC4J_HOME/j2ee/home/oc4j.jar -install
  
  系统将提示您输入密码。在用于方法示例的 common.xml 文件中所假设的密码是 'welcome'。如果您为 OC4J 使用了不同的管理员密码，请在 common.xml 文件中更改相应的 oc4j.admin.pwd 属性。
  

环境设置

在运行任何示例之前必须先执行下列环境设置。

• 把 ORACLE_HOME 环境变量设置为 oc4j 根目录。
  
  例如：set ORACLE_HOME=c:\oc4j
  
  
• 把 J2EE_HOME 设置为 oc4j\j2ee\home 目录。
  
  例如：set J2EE_HOME=c:\oc4j\j2ee\home
  
  
• 把 JAVA_HOME 环境变量设置为 java 安装目录。
  
  例如：set JAVA_HOME=c:\j2sdk1.4

一些示例，如 JMS Web 服务、CORBA Web 服务和数据库 Web 服务要求安装额外的软件，以及一些额外的设置步骤。请确保遵循它们各自的方法文件所提供的指导。

运行一个 OC4J 实例

必须运行 OC4J 实例。建议按如下方式启动 OC4J：

> java -Xmx256M -jar oc4j.jar.

如果 OC4J 不是在 localhost，端口 8888 上运行，您必须修改相应的示例目录中的 ANT 脚本 (build.xml) 中的 service.url 属性，从而使用正确的主机和端口。此外，如果您是通过 HTTP 代理进行 Web 服务连接，则需要修改此脚本。在 "run-demo" 目标中向 Java 调用增加下面两个元素：

> java -Xmx256M -jar oc4j.jar.

如果 OC4J 不是在 localhost，端口 8888 上运行，您必须修改相应的示例目录中的 ANT 脚本 (build.xml) 中的service.url 属性。 从而使用正确的主机和端口。此外，如果您是通过 HTTP 代理进行 Web 服务连接，则需要修改此脚本。在 "run-demo" 目标中向 Java 调用增加下面两个元素：

<java ...>
<jvmarg value="-Dhttp.proxyHost=your_proxy_host"/>
<jvmarg value="-Dhttp.proxyPort=your_proxy_port"/>
<arg .../> ... </java>

一旦您配置了服务器并开始运行，就只需从最顶级的示例目录键入 ant。服务产品和实施类将被编译并放置到一个 WAR 中，然后该 WAR 被放置到一个 EAR 中。EAR 将被部署到 OC4J。下一步将编译 stub 和客户端。最后，客户端调用服务，而您将在服务器的消息输出和客户端的标准输出中看到输出。

OC4J 10g (10.0.3) 开发人员预览版中的新特性

在此开发人员预览版中提供了下列新的 Web 服务特性。您可以获得一系列说明这些特性的用法的方法文档。

OC4J 10g (10.0.3) 开发人员预览版的方法示例

为了举例说明此开发人员预览中所提供的新特性，我们创建了下面这套方法文档提供给您。每篇方法文档都提供了一个小示例演示如何使用新特性，通常包括源代码示例，以及创建和部署 Web 服务组件所需的步骤。