引言
IBM WebSphere Service Registry and Repository(以下称为 Service Registry)包括一个支持使用 SOAP/HTTP 或 RMI/IIOP 来访问 Service Registry 的 Java 客户端,同时带有一个基于服务数据对象 (SDO) 2.0 的编程模型。也可以直接使用该客户端使用的 SOAP API,本文将说明如何使用 JAX-RPC 客户端来调用此 API。
本文首先说明如何查找描述 Service Registry 的接口的 Web 服务描述语言 (WSDL) 和 XML 模式文件(可以根据这些文件用特定编程语言生成客户端接口)。文中还包括用于说明如何生成 JAX-RPC 客户端的示例。
接下来将说明使用 Service Registry SOAP API 时涉及到的一些常规主题,并且还将介绍一些实用函数的来源,这些实用函数在使用 Service Registry 的 JAX-RPC 客户端时非常有用。
在介绍了实用函数之后,我们将提供一些示例来说明如何调用根据 WSDL 生成的每个 Service Registry 操作。
在开始学习本文之前,您应该对以下内容有很好的了解:
使用 WebSphere 进行 Java 和 JAX-RPC 编程
Service Registry Information Center 中关于已提供的客户端和 SOAP API 的信息
检索 Service Registry SOAP API 的 WSDL 描述
第一步是获取 Service Registry SOAP API 的 WSDL 描述,以便您可以根据它生成 Java 客户端。要这样做,最简单的方法是使用运行 Service Registry 的 WebSphere Application Server(Service Registry 支持 WebSphere Application Server 6.0.2.x)实例的管理控制台。
请执行以下步骤:
启动承载 Service Registry 的 WebSphere Application Server 概要的管理控制台。
如果安全性处于启用状态,则输入用户 ID 和密码,并单击 Log in。
单击 Applications。
单击 Enterprise Applications。
单击 ServiceRegistry。
单击位于“Additonal Properties”下方的 Publish WSDL Files。
单击 ServiceRegistry_WSDLFiles.zip。
保存文件。
展开该文件,您将看到一个名为 ServiceRegistry.ear 的目录/文件夹
该目录/文件夹内有另一个名为 WSRRCoreSDO.jar 的目录/文件夹。
该目录/文件夹内有另一个名为 META-INF 的目录/文件夹。
该目录/文件夹内有另一个名为 wsdl 的目录/文件夹。
该目录/文件夹内有一组用于定义 Service Registry SOAP API 的 WSDL 和 XML 模式文件。您必须对如何使用 WebSphere 进行 Java 和 JAX-RPC 编程有很好的了解,并且您还应该阅读 Service Registry Information Center 中关于已提供的客户端和 SOAP API 的信息。
提示:请注意,在 wsrrSdoWS.wsdl 文件中,端点是 WebSphere Application Server 实例中的 Service Registry 的端点。