Address Book - 技术说明


要获取关于 Web Service 的讨论内容,请参阅信息中心中的 IBM WebSphere Web Service 文档。

AddressBook 样本以多种方式说明 Web Service 访问。该样本包括两个客户机和同一 AddressBook bean 的四种变体。两个客户机是 Java 2 Standard Edition(J2SE)客户机和 Java 2 Enterprise Edition(J2EE)客户机。每个客户机都访遍服务器上部署的 AddressBook bean 的四种变体。

查找源代码

您可以在 profile_rootsamples/src/WebServicesSamples 的子目录中找到 AddressBook 样本的源代码。四个 AddressBook 应用程序 bean 中的每一个的源代码都在下表中所示的指定子目录中。 简单 J2SE 客户机源代码在 Clients/simpleClients/samples/address 目录中。J2EE Application Client 源代码在 Clients/applicationClients/AddressBookClient 下。

z/OS 客户:z/OS 平台上未提供样本的源代码树,这是因为 z/OS 平台上没有构建样本应用程序。

应用程序 bean 的四种变体说明开发为 Web Service 所启用的应用程序的不同方法。有两个 Enterprise JavaBeans(EJBs),而这两个 Enterprise JavaBeans 是用不同的方法构建的。一种方法演示通过从 Web Service 定义语言(WSDL)文件开始构建 Web Service bean,并且使用 WSDL2Java 工具生成 Java 代码或绑定。

该 EJB 的工件的名称中包括“W2JE”,以将它们与其他版本区分开。第二个企业 bean 是从已实现的 EJB 开始构建,并使用 Java2WSDL 工具生成该 bean 的 WSDL 文件。WSDL 文件用于生成部署描述符。该企业 bean 的工件用“J2WE”指明。

类似地,两个 JavaBeans 的工件的名称中包含表明特定方法的字符串“J2WB”或“W2JB”。

下表显示四个 AddressBook bean 是如何指定的。

 
端口 目录 实现类 演示
AddressBookW2JE addrEJBTopDown AddressBookSoapBindingImpl.java 一种 Web Service 企业 bean,它在开发时以 WSDL 文件作为起点、使用 WSDL2Java 工具生成企业 bean 的 Java 代码。
AddressBookJ2WE addrEJBBottomUp AddressBookBeanImpl.java 通过使用 bean 开发的 Web Service 企业 bean,并且使用 Java2WSDL 工具生成用以创建部署描述符的 WSDL 文件。
AddressBookJ2WB addrBeanBottomUp AddressBookBean.java 通过使用 bean 开发的 Web Service JavaBean,并且使用 Java2WSDL 工具生成用以创建部署描述符的 WSDL 文件。
AddressBookW2JB addrBeanTopDown AddressBookBean.java 通过使用 WSDL 开发的 Web Service JavaBean,并且使用 WSDL2Java 工具生成此 bean 的 Java 代码。

您可以在 profile_rootsamples/src/WebServicesSamples 目录下找到表中指定的目录。

AddressBook 服务的每个实施都支持 getAddressFromName 操作。操作将静态响应返回给客户机。没有地址的数据库存储器。该样本的目的是显示 bean 和 Web Service 之间的关系。

AddressBook 服务的所有版本都在 WebServicesSamples.ear 文件中。 唯一的根上下文和 jar 名称允许它们同步部署。 另外,EJB 实现类是唯一指定的,它们的名称与 JavaBean 实现类的名称不同。这种唯一性确保服务器中的类装入器能够找到正确的实现类。

查看 AddressBook bean 关系

该样本包括两个客户机,J2SE 客户机和 J2EE 客户机。每个客户机都访遍服务器上部署的 AddressBook bean 的四种变体。

可以在客户机 WSDL 文件中查看服务器上部署的四个 bean 之间的关系,有了该文件客户机就能访问四个 bean 中的任何一个 bean。WSDL 文件定义一个服务 AddressBookService,四个端口。 可以在样本目录 src/WebServicesSamples/Clients/applicationClients/META-INF 中找到客户机 AddressBook.wsdl